@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,38 +1,23 @@
|
|
|
1
1
|
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
2
|
/**
|
|
3
|
-
* Options the `.guren/*.gen.ts` generators are called with. `cwd` is the
|
|
4
|
-
*
|
|
5
|
-
*
|
|
3
|
+
* Options the `.guren/*.gen.ts` generators are called with. `cwd` is the project
|
|
4
|
+
* they resolve output paths against; nothing changes `process.cwd()`, which is
|
|
5
|
+
* process-wide and shared by concurrent requests.
|
|
6
6
|
*/
|
|
7
7
|
export interface CodegenOptions {
|
|
8
8
|
cwd: string;
|
|
9
9
|
force?: boolean;
|
|
10
10
|
}
|
|
11
|
-
/**
|
|
12
|
-
* What every scaffolder takes. `cwd` names the project the scaffold belongs
|
|
13
|
-
* to, for the same reason: this server handles requests for a workspace
|
|
14
|
-
* without a per-request `process.cwd()` to fall back on.
|
|
15
|
-
*/
|
|
11
|
+
/** What every scaffolder takes; `cwd` names the project, for the same reason. */
|
|
16
12
|
export interface ScaffoldOptions {
|
|
17
13
|
force?: boolean;
|
|
18
14
|
cwd?: string;
|
|
19
15
|
}
|
|
20
16
|
/**
|
|
21
|
-
* What a generator reports back. An empty `outputPath` means
|
|
22
|
-
*
|
|
23
|
-
*
|
|
24
|
-
*
|
|
25
|
-
* `skipped` is an optional sentence explaining that empty `outputPath` when
|
|
26
|
-
* "nothing to describe" would be wrong — the pages generator declines to write
|
|
27
|
-
* a manifest into an app that cannot compile one, and an agent reading this
|
|
28
|
-
* result is exactly who needs to hear that a page it just wrote was ignored.
|
|
29
|
-
*
|
|
30
|
-
* `definitions` is what a generator extracted: the route manifest from
|
|
31
|
-
* `generateRouteTypes`, the Resource definitions from `generateDataTypes`.
|
|
32
|
-
* It stays opaque here — this package only carries it from one CLI call to
|
|
33
|
-
* the next (`generateApiClientTypes` consumes both) and never reads inside
|
|
34
|
-
* it, so mirroring the CLI's shapes would only create something to keep in
|
|
35
|
-
* sync.
|
|
17
|
+
* What a generator reports back. An empty `outputPath` means it found nothing to
|
|
18
|
+
* describe and wrote no file; `skipped` explains that when "nothing to describe"
|
|
19
|
+
* would be wrong. `definitions` stays opaque — this package only carries it from
|
|
20
|
+
* one CLI call to the next, so mirroring the CLI's shapes would need syncing.
|
|
36
21
|
*/
|
|
37
22
|
export interface CodegenResult {
|
|
38
23
|
outputPath?: string;
|
|
@@ -40,17 +25,12 @@ export interface CodegenResult {
|
|
|
40
25
|
skipped?: {
|
|
41
26
|
message: string;
|
|
42
27
|
} | null;
|
|
43
|
-
/**
|
|
44
|
-
* Diagnostics the generator wants surfaced to whoever asked for the run —
|
|
45
|
-
* a `resource` response hint naming an unknown Resource class, for
|
|
46
|
-
* instance. Non-fatal: the artifact was still written.
|
|
47
|
-
*/
|
|
28
|
+
/** Non-fatal diagnostics for whoever asked for the run; the artifact was still written. */
|
|
48
29
|
warnings?: string[];
|
|
49
30
|
}
|
|
50
31
|
/**
|
|
51
|
-
* CLI functions
|
|
52
|
-
*
|
|
53
|
-
* (@guren/server cannot depend on @guren/cli directly).
|
|
32
|
+
* CLI functions the MCP server wraps, injected at runtime because
|
|
33
|
+
* `@guren/server` cannot depend on `@guren/cli`.
|
|
54
34
|
*/
|
|
55
35
|
export interface GurenCliApi {
|
|
56
36
|
generateContext(opts: {
|
|
@@ -133,51 +113,39 @@ export interface GurenCliApi {
|
|
|
133
113
|
generateDataTypes(opts: CodegenOptions): Promise<CodegenResult | void>;
|
|
134
114
|
generateChannelTypes(opts: CodegenOptions): Promise<CodegenResult | void>;
|
|
135
115
|
/**
|
|
136
|
-
* Takes the route manifest `generateRouteTypes` returns
|
|
137
|
-
*
|
|
138
|
-
*
|
|
139
|
-
* Resource" and the client's `json()` stays untyped.
|
|
116
|
+
* Takes the route manifest `generateRouteTypes` returns. `resources` is what
|
|
117
|
+
* `generateDataTypes` extracted — without it every `resource` response hint
|
|
118
|
+
* is "unknown Resource" and the client's `json()` stays untyped.
|
|
140
119
|
*/
|
|
141
120
|
generateApiClientTypes(definitions: unknown[], opts: CodegenOptions & {
|
|
142
121
|
resources?: unknown[];
|
|
143
122
|
}): Promise<CodegenResult | void>;
|
|
144
123
|
/**
|
|
145
124
|
* Agent tools derived from the route manifest (RFC 0016), so it runs after
|
|
146
|
-
* `generateRouteTypes` and
|
|
147
|
-
*
|
|
148
|
-
* because `@guren/cli` is resolved from the app at runtime and may predate
|
|
149
|
-
* it; an older CLI simply generates no agent manifest.
|
|
125
|
+
* `generateRouteTypes` and `generateDataTypes`. Optional: `@guren/cli` is
|
|
126
|
+
* resolved from the app and an older one simply generates no agent manifest.
|
|
150
127
|
*/
|
|
151
128
|
generateAgentTypes?(definitions: unknown[], opts: CodegenOptions & {
|
|
152
129
|
resources?: unknown[];
|
|
153
130
|
}): Promise<CodegenResult | void>;
|
|
154
131
|
/**
|
|
155
|
-
* Route-dependent context generation
|
|
156
|
-
*
|
|
157
|
-
* runtime and may predate it — see `McpServiceProvider`.
|
|
132
|
+
* Route-dependent context generation in a fresh process. Optional because
|
|
133
|
+
* `@guren/cli` is resolved from the app at runtime and may predate it.
|
|
158
134
|
*/
|
|
159
135
|
createFreshContextApi?: () => Pick<GurenCliApi, 'generateContext' | 'generateEntityContext'>;
|
|
160
136
|
/**
|
|
161
|
-
*
|
|
162
|
-
*
|
|
163
|
-
*
|
|
164
|
-
* CLI
|
|
165
|
-
*
|
|
166
|
-
* Optional for the same runtime-resolution reason as the members above, and
|
|
167
|
-
* read for exactly that reason: an older CLI emits routes with no `agent`
|
|
168
|
-
* field at all, which reads identically to an app exposing no agent tools.
|
|
137
|
+
* Spelled exactly as `@guren/cli` exports it — this interface describes that
|
|
138
|
+
* module namespace, so a camelCase name here would read `undefined` off every
|
|
139
|
+
* real CLI. Optional for the runtime-resolution reason above, and read for it:
|
|
140
|
+
* an older CLI emits routes with no `agent` field, which looks like no tools.
|
|
169
141
|
*/
|
|
170
142
|
CONTEXT_ROUTE_FEATURES?: readonly string[];
|
|
171
143
|
/**
|
|
172
|
-
* Every route as a context route, without
|
|
173
|
-
*
|
|
174
|
-
* `generateContext` when an older CLI does not provide it.
|
|
144
|
+
* Every route as a context route, without the rest of the project context.
|
|
145
|
+
* Optional; `guren_agent_surface` falls back to `generateContext`.
|
|
175
146
|
*/
|
|
176
147
|
loadContextRoutes?(cwd: string, routesFile?: string, loadErrors?: string[]): Promise<unknown[]>;
|
|
177
|
-
/**
|
|
178
|
-
* The OKF docs relation graph (RFC 0005). Optional for the same
|
|
179
|
-
* runtime-resolution reason as above.
|
|
180
|
-
*/
|
|
148
|
+
/** The OKF docs relation graph (RFC 0005). Optional, like the above. */
|
|
181
149
|
buildDocsGraphReport?(options: {
|
|
182
150
|
cwd?: string;
|
|
183
151
|
entity?: string;
|
package/dist/mcp/endpoint.d.ts
CHANGED
|
@@ -1,47 +1,23 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Identity and activation rules for the dev-only MCP endpoint.
|
|
3
|
-
*
|
|
4
|
-
*
|
|
5
|
-
* application bootstrap can reason about the endpoint without pulling in
|
|
6
|
-
* `@modelcontextprotocol/sdk`, which apps are not required to install.
|
|
7
|
-
* The loopback access guard itself is shared with the docs viewer — see
|
|
8
|
-
* `http/middleware/loopback-guard.ts`.
|
|
2
|
+
* Identity and activation rules for the dev-only MCP endpoint. Free of MCP SDK
|
|
3
|
+
* imports so middleware (CSRF) and the app bootstrap can reason about the
|
|
4
|
+
* endpoint without `@modelcontextprotocol/sdk`, which apps need not install.
|
|
9
5
|
*/
|
|
10
6
|
import type { MiddlewareHandler } from 'hono';
|
|
11
7
|
export { isLoopbackAddress, isLoopbackOrigin } from '../http/middleware/loopback-guard.js';
|
|
12
8
|
export declare const MCP_ENDPOINT_PATH = "/_guren/mcp";
|
|
13
9
|
/**
|
|
14
|
-
* Whether the MCP endpoint is mounted
|
|
15
|
-
*
|
|
16
|
-
*
|
|
17
|
-
*
|
|
18
|
-
*
|
|
19
|
-
*
|
|
20
|
-
* The environment reads below are deliberately written as plain member
|
|
21
|
-
* access. Do not "harden" them with optional chaining: the deploy plugins
|
|
22
|
-
* bundle server code with `--define 'process.env.NODE_ENV="production"'`,
|
|
23
|
-
* and a define matches one exact expression. Inserting `?.` produces a
|
|
24
|
-
* different expression that no define touches, leaving this gate a runtime
|
|
25
|
-
* read — and on hosts where the platform's environment is not in
|
|
26
|
-
* `process.env` by the time the module graph evaluates (workerd is the
|
|
27
|
-
* documented case; see the comment on the Cloudflare plugin's `define`),
|
|
28
|
-
* that runtime read answers "not production" and the gate silently reopens.
|
|
29
|
-
* A test in `tests/mcp/endpoint.test.ts` reads this file and fails on any
|
|
30
|
-
* optional chain after `process.env`, because nothing observable at runtime
|
|
31
|
-
* distinguishes the two forms.
|
|
32
|
-
*
|
|
33
|
-
* The `typeof process` check covers the only runtimes without `process`;
|
|
34
|
-
* every runtime the framework supports that has `process` has `process.env`.
|
|
10
|
+
* Whether the MCP endpoint is mounted: opt-in via `GUREN_MCP=1`, never in
|
|
11
|
+
* production (it exposes project introspection and code generation). The env
|
|
12
|
+
* reads are plain member access on purpose: the deploy plugins settle NODE_ENV
|
|
13
|
+
* with `--define`, which matches one exact expression, so an optional chain
|
|
14
|
+
* leaves a runtime read that reopens the gate on workerd; `tests/mcp/endpoint.test.ts` pins the form.
|
|
35
15
|
*/
|
|
36
16
|
export declare function isMcpEndpointEnabled(): boolean;
|
|
37
17
|
/**
|
|
38
|
-
* Restricts the MCP endpoint to the developer's own machine.
|
|
39
|
-
*
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
* their `Origin` is loopback (the check the MCP specification asks local
|
|
43
|
-
* servers for), and every caller is rejected unless its socket peer is
|
|
44
|
-
* loopback. The guard fails closed when the runtime reports no peer at
|
|
45
|
-
* all; see `http/middleware/loopback-guard.ts` for the opt-out.
|
|
18
|
+
* Restricts the MCP endpoint to the developer's own machine. The endpoint is
|
|
19
|
+
* CSRF-exempt (agent clients carry no token), so this guard takes over: a web
|
|
20
|
+
* page is rejected unless its `Origin` is loopback, and every caller unless its
|
|
21
|
+
* socket peer is. It fails closed when the runtime reports no peer at all.
|
|
46
22
|
*/
|
|
47
23
|
export declare function createMcpAccessGuard(): MiddlewareHandler;
|
package/dist/mcp/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { r as createMcpServer, t as McpServiceProvider } from "../McpServiceProvider-
|
|
1
|
+
import { r as createMcpServer, t as McpServiceProvider } from "../McpServiceProvider-nNcbCIQX.js";
|
|
2
2
|
export { McpServiceProvider, createMcpServer };
|
package/dist/mvc/Controller.d.ts
CHANGED
|
@@ -7,10 +7,7 @@ import { type RegisteredTranslationKey, type ReplacementValues } from '../i18n/i
|
|
|
7
7
|
import type { AuthContext } from '../auth/types.js';
|
|
8
8
|
import type { ServiceBindings } from '../container/bindings.js';
|
|
9
9
|
import type { ContainerLike } from '../container/types.js';
|
|
10
|
-
/**
|
|
11
|
-
* Duck-type interface for Zod-like schemas.
|
|
12
|
-
* Allows validation without a direct Zod dependency.
|
|
13
|
-
*/
|
|
10
|
+
/** Duck-typed Zod-like schema, so validation needs no direct Zod dependency. */
|
|
14
11
|
interface ZodLikeSchema<T> {
|
|
15
12
|
safeParse(data: unknown): {
|
|
16
13
|
success: true;
|
|
@@ -25,9 +22,7 @@ interface ZodLikeSchema<T> {
|
|
|
25
22
|
};
|
|
26
23
|
};
|
|
27
24
|
}
|
|
28
|
-
/**
|
|
29
|
-
* Result type for safe validation methods (discriminated union).
|
|
30
|
-
*/
|
|
25
|
+
/** Result type for safe validation methods (discriminated union). */
|
|
31
26
|
export type SafeValidationResult<T> = {
|
|
32
27
|
success: true;
|
|
33
28
|
data: T;
|
|
@@ -36,15 +31,10 @@ export type SafeValidationResult<T> = {
|
|
|
36
31
|
errors: Record<string, string>;
|
|
37
32
|
};
|
|
38
33
|
/**
|
|
39
|
-
* The record `Controller.model()` returns
|
|
40
|
-
*
|
|
41
|
-
*
|
|
42
|
-
*
|
|
43
|
-
* Anything without a usable marker — a class extending `Model` directly
|
|
44
|
-
* without redeclaring it, or a plain `{ findOrFail }` adapter — falls back to
|
|
45
|
-
* whatever its `findOrFail` resolves to. The marker is only trusted when it
|
|
46
|
-
* names an object type: `Model`'s own is `unknown`, and an unrelated
|
|
47
|
-
* `recordType` on some adapter (a string tag, say) describes no record.
|
|
34
|
+
* The record `Controller.model()` returns. ORM models carry their row type as a
|
|
35
|
+
* `recordType` marker (set by `defineModel()`); `findOrFail`'s return type cannot
|
|
36
|
+
* stand in because it is generic in `this` and `ReturnType` widens it to the base
|
|
37
|
+
* row. The marker is trusted only when it names an object type.
|
|
48
38
|
*/
|
|
49
39
|
export type BoundModelRecord<T extends {
|
|
50
40
|
findOrFail(...args: any[]): Promise<any>;
|
|
@@ -84,32 +74,19 @@ type InertiaResponseOptions = Omit<InertiaOptions, 'url' | 'request'> & {
|
|
|
84
74
|
};
|
|
85
75
|
type InertiaPageComponent<TPage extends InertiaPageContractLike> = TPage['id'];
|
|
86
76
|
type InertiaPageProps<TPage extends InertiaPageContractLike> = NonNullable<TPage['__props']>;
|
|
87
|
-
/**
|
|
88
|
-
* Constructor type for controllers with optional DI.
|
|
89
|
-
*/
|
|
77
|
+
/** Constructor type for controllers with optional DI. */
|
|
90
78
|
export type ControllerConstructorWithInject = {
|
|
91
79
|
new (...args: any[]): Controller;
|
|
92
80
|
inject?: readonly string[];
|
|
93
81
|
};
|
|
94
82
|
/**
|
|
95
|
-
* Base controller inspired by Laravel's expressive API. Subclasses
|
|
96
|
-
*
|
|
97
|
-
*
|
|
98
|
-
*
|
|
99
|
-
* Supports dependency injection via the `static inject` convention:
|
|
100
|
-
* ```typescript
|
|
101
|
-
* class PostController extends Controller {
|
|
102
|
-
* static inject = ['cache', 'events'] as const
|
|
103
|
-
* constructor(private cache: CacheManager, private events: EventManager) { super() }
|
|
104
|
-
* }
|
|
105
|
-
* ```
|
|
83
|
+
* Base controller inspired by Laravel's expressive API. Subclasses reach the
|
|
84
|
+
* Hono context through the protected `ctx` getter. Dependencies are declared
|
|
85
|
+
* with `static inject = ['cache'] as const` and passed to the constructor.
|
|
106
86
|
*/
|
|
107
87
|
export declare class Controller {
|
|
108
88
|
#private;
|
|
109
|
-
/**
|
|
110
|
-
* Dependencies to inject from the container.
|
|
111
|
-
* Override in subclasses to declare required services.
|
|
112
|
-
*/
|
|
89
|
+
/** Services to resolve from the container and pass to the constructor. */
|
|
113
90
|
static inject?: readonly string[];
|
|
114
91
|
private context?;
|
|
115
92
|
private parsedBody?;
|
|
@@ -118,29 +95,12 @@ export declare class Controller {
|
|
|
118
95
|
setContext(context: Context): void;
|
|
119
96
|
/** @internal Called by the router to inject the DI container. */
|
|
120
97
|
setContainer(container: ContainerLike): void;
|
|
121
|
-
/**
|
|
122
|
-
* Store a resolved model instance from route model binding.
|
|
123
|
-
* @internal Called by the router, not intended for direct use.
|
|
124
|
-
*/
|
|
98
|
+
/** @internal Called by the router to store a route-bound model instance. */
|
|
125
99
|
setResolvedModel(modelClass: unknown, instance: unknown): void;
|
|
126
100
|
/**
|
|
127
101
|
* Retrieve a model instance resolved via route model binding — a per-route
|
|
128
|
-
* `bind` option or a router-level `router.bind(param, Model)`.
|
|
129
|
-
* primary key
|
|
130
|
-
* `[Model, column]` tuple.
|
|
131
|
-
*
|
|
132
|
-
* @example
|
|
133
|
-
* ```typescript
|
|
134
|
-
* // routes/web.ts
|
|
135
|
-
* posts.get('/:id', { bind: { id: Post }, name: 'posts.show' }, [PostController, 'show'])
|
|
136
|
-
* posts.get('/by-slug/:slug', { bind: { slug: [Post, 'slug'] } }, [PostController, 'show'])
|
|
137
|
-
*
|
|
138
|
-
* // PostController.ts
|
|
139
|
-
* async show() {
|
|
140
|
-
* const post = this.model(Post) // typed as PostRecord
|
|
141
|
-
* return this.inertia(pages.posts.Show, { post })
|
|
142
|
-
* }
|
|
143
|
-
* ```
|
|
102
|
+
* `bind` option or a router-level `router.bind(param, Model)`. The class
|
|
103
|
+
* alone looks up by primary key, a `[Model, column]` tuple by that column.
|
|
144
104
|
*/
|
|
145
105
|
protected model<T extends {
|
|
146
106
|
findOrFail(...args: any[]): Promise<any>;
|
|
@@ -148,20 +108,9 @@ export declare class Controller {
|
|
|
148
108
|
protected get ctx(): Context;
|
|
149
109
|
protected get request(): import("hono").HonoRequest<any, unknown>;
|
|
150
110
|
/**
|
|
151
|
-
* Get an uploaded file from a multipart request.
|
|
152
|
-
*
|
|
153
|
-
*
|
|
154
|
-
* empty. Hono caches the parsed body, so this composes with other body
|
|
155
|
-
* reads in the same request.
|
|
156
|
-
*
|
|
157
|
-
* @example
|
|
158
|
-
* ```typescript
|
|
159
|
-
* const avatar = await this.file('avatar')
|
|
160
|
-
* if (!avatar) {
|
|
161
|
-
* throw ValidationException.withMessages({ avatar: 'Choose a file.' })
|
|
162
|
-
* }
|
|
163
|
-
* await storage.disk().put(`avatars/${avatar.name}`, Buffer.from(await avatar.arrayBuffer()))
|
|
164
|
-
* ```
|
|
111
|
+
* Get an uploaded file from a multipart request. Returns null when the field
|
|
112
|
+
* is missing, is not a file, or the upload is empty. Hono caches the parsed
|
|
113
|
+
* body, so this composes with other body reads in the same request.
|
|
165
114
|
*/
|
|
166
115
|
protected file(name: string): Promise<File | null>;
|
|
167
116
|
/**
|
|
@@ -172,96 +121,41 @@ export declare class Controller {
|
|
|
172
121
|
protected get auth(): AuthContext;
|
|
173
122
|
protected make<K extends keyof ServiceBindings>(key: K): ServiceBindings[K];
|
|
174
123
|
protected make<T>(key: string): T;
|
|
175
|
-
/**
|
|
176
|
-
* Get the authenticated API token or throw AuthenticationException.
|
|
177
|
-
*
|
|
178
|
-
* @example
|
|
179
|
-
* ```typescript
|
|
180
|
-
* const { userId, abilities } = this.apiToken()
|
|
181
|
-
* ```
|
|
182
|
-
*/
|
|
124
|
+
/** Get the authenticated API token, or throw AuthenticationException. */
|
|
183
125
|
protected apiToken(): {
|
|
184
126
|
token: import("../index.js").ApiToken;
|
|
185
127
|
userId: string | number;
|
|
186
128
|
abilities: string[];
|
|
187
129
|
};
|
|
188
|
-
/**
|
|
189
|
-
* Get the authenticated user ID from the API token.
|
|
190
|
-
*
|
|
191
|
-
* @example
|
|
192
|
-
* ```typescript
|
|
193
|
-
* const userId = this.apiTokenUserId()
|
|
194
|
-
* ```
|
|
195
|
-
*/
|
|
130
|
+
/** Get the authenticated user ID from the API token. */
|
|
196
131
|
protected apiTokenUserId(): string | number;
|
|
197
132
|
/**
|
|
198
|
-
* Authorize the current user (or guest) for an ability
|
|
199
|
-
*
|
|
200
|
-
*
|
|
201
|
-
*
|
|
202
|
-
* the model class alongside the record to resolve the policy:
|
|
203
|
-
*
|
|
204
|
-
* @example
|
|
205
|
-
* ```typescript
|
|
206
|
-
* const post = await Post.findOrFail(id)
|
|
207
|
-
* await this.authorize('update', [Post, post])
|
|
208
|
-
* await this.authorize('create', Post)
|
|
209
|
-
* ```
|
|
133
|
+
* Authorize the current user (or guest) for an ability; throws
|
|
134
|
+
* AuthorizationException (403) when denied. ORM records are plain objects
|
|
135
|
+
* with no constructor information, so pass the model class alongside the
|
|
136
|
+
* record: `await this.authorize('update', [Post, post])`.
|
|
210
137
|
*/
|
|
211
138
|
protected authorize(ability: string, ...args: unknown[]): Promise<void>;
|
|
212
|
-
/**
|
|
213
|
-
* Check whether the current user (or guest) can perform an ability.
|
|
214
|
-
*
|
|
215
|
-
* @example
|
|
216
|
-
* ```typescript
|
|
217
|
-
* if (await this.can('update', [Post, post])) { ... }
|
|
218
|
-
* ```
|
|
219
|
-
*/
|
|
139
|
+
/** Check an ability without throwing: `await this.can('update', [Post, post])`. */
|
|
220
140
|
protected can(ability: string, ...args: unknown[]): Promise<boolean>;
|
|
221
141
|
private gateUser;
|
|
222
142
|
/**
|
|
223
143
|
* Render a `hono/jsx` component to a plain server-rendered HTML response —
|
|
224
|
-
* the non-hydrating counterpart to {@link inertia}
|
|
225
|
-
*
|
|
226
|
-
*
|
|
227
|
-
*
|
|
228
|
-
* Escaping covers markup: text children and attribute values are escaped,
|
|
229
|
-
* so tag and attribute breakout cannot occur. It does **not** validate URL
|
|
230
|
-
* schemes — a `javascript:` href built from user data is emitted verbatim.
|
|
231
|
-
* Sanitize user-supplied URLs upstream (e.g. `@guren/plugin-markdown`'s
|
|
232
|
-
* allowlist) before they reach a View.
|
|
233
|
-
*
|
|
234
|
-
* @example
|
|
235
|
-
* ```typescript
|
|
236
|
-
* async show() {
|
|
237
|
-
* const post = await Post.findOrFail(id)
|
|
238
|
-
* return this.view(PostPage, { post })
|
|
239
|
-
* }
|
|
240
|
-
* ```
|
|
144
|
+
* the non-hydrating counterpart to {@link inertia} (RFC 0014). Escaping
|
|
145
|
+
* covers markup only, not URL schemes: a `javascript:` href built from user
|
|
146
|
+
* data is emitted verbatim, so sanitize user-supplied URLs upstream.
|
|
241
147
|
*/
|
|
242
148
|
protected view<P>(component: FC<P>, props: P, options?: ViewOptions): Promise<Response>;
|
|
243
149
|
protected inertia<TPage extends InertiaPageContractLike>(page: TPage, props: InertiaPageProps<TPage>, options?: InertiaResponseOptions): Promise<InertiaResponse<InertiaPageComponent<TPage>, InertiaPageProps<TPage> & ResolvedSharedInertiaProps>>;
|
|
244
150
|
protected inertia<Component extends string, Props extends DefaultInertiaProps>(component: Component, props: Props, options?: InertiaResponseOptions): Promise<InertiaResponse<Component, Props & ResolvedSharedInertiaProps>>;
|
|
245
151
|
/**
|
|
246
|
-
* Locale
|
|
247
|
-
*
|
|
248
|
-
* locale (the router-injected container binding, then the `setI18n()`
|
|
249
|
-
* global). Falls back to `'en'` when no i18n is configured.
|
|
152
|
+
* Locale for the current request: the request-scoped `locale` context
|
|
153
|
+
* variable wins over the app-wide i18n locale. Falls back to `'en'`.
|
|
250
154
|
*/
|
|
251
155
|
protected get locale(): string;
|
|
252
156
|
/**
|
|
253
|
-
* Translate a key for the current request locale
|
|
254
|
-
*
|
|
255
|
-
* Uses the request-scoped translator bound by the locale detection
|
|
256
|
-
* middleware when present, falling back to a translator scoped to
|
|
257
|
-
* `this.locale` from the container's `i18n` binding (then the `setI18n()`
|
|
258
|
-
* global).
|
|
259
|
-
*
|
|
260
|
-
* @example
|
|
261
|
-
* ```typescript
|
|
262
|
-
* this.t('posts.created')
|
|
263
|
-
* this.t('posts.greeting', { name: user.name })
|
|
264
|
-
* ```
|
|
157
|
+
* Translate a key for the current request locale, using the request-scoped
|
|
158
|
+
* translator the locale middleware bound, else one scoped to `this.locale`.
|
|
265
159
|
*/
|
|
266
160
|
protected t(key: RegisteredTranslationKey, replacements?: ReplacementValues): string;
|
|
267
161
|
/**
|
|
@@ -272,118 +166,43 @@ export declare class Controller {
|
|
|
272
166
|
protected json<T>(data: T, init?: ResponseInit): Response;
|
|
273
167
|
protected text(body: string, init?: ResponseInit): Response;
|
|
274
168
|
protected redirect(url: string, options?: RedirectOptions): Response;
|
|
275
|
-
/**
|
|
276
|
-
* Return a 204 No Content response.
|
|
277
|
-
*/
|
|
278
169
|
protected noContent(): Response;
|
|
279
|
-
/**
|
|
280
|
-
* Return a 201 Created response with JSON data.
|
|
281
|
-
*/
|
|
282
170
|
protected created<T>(data?: T, init?: ResponseInit): Response;
|
|
283
|
-
/**
|
|
284
|
-
* Return a 202 Accepted response with optional JSON data.
|
|
285
|
-
*/
|
|
286
171
|
protected accepted<T>(data?: T, init?: ResponseInit): Response;
|
|
287
172
|
private jsonStatus;
|
|
288
|
-
/**
|
|
289
|
-
* Get a specific input value from the request body or query parameters.
|
|
290
|
-
* Body values take precedence over query parameters.
|
|
291
|
-
*/
|
|
173
|
+
/** Get an input value; body values take precedence over query parameters. */
|
|
292
174
|
protected input<T = unknown>(key: string, defaultValue?: T): Promise<T | undefined>;
|
|
293
|
-
/**
|
|
294
|
-
* Get a query parameter value.
|
|
295
|
-
*/
|
|
296
175
|
protected query(key: string, defaultValue?: string): string | undefined;
|
|
297
|
-
/**
|
|
298
|
-
* Get only the specified keys from the request body.
|
|
299
|
-
*/
|
|
176
|
+
/** Get only the specified keys from the request body. */
|
|
300
177
|
protected only(...keys: string[]): Promise<Record<string, unknown>>;
|
|
301
|
-
/**
|
|
302
|
-
* Get all request body values except the specified keys.
|
|
303
|
-
*/
|
|
178
|
+
/** Get all request body values except the specified keys. */
|
|
304
179
|
protected except(...keys: string[]): Promise<Record<string, unknown>>;
|
|
305
|
-
/**
|
|
306
|
-
* Check if a key exists in the request body.
|
|
307
|
-
*/
|
|
180
|
+
/** Check if a key exists in the request body. */
|
|
308
181
|
protected has(key: string): Promise<boolean>;
|
|
309
182
|
/** Flatten query string arrays to scalar values for cleaner schema usage. */
|
|
310
183
|
private flattenQueries;
|
|
311
|
-
/**
|
|
312
|
-
* Validate the request body against a Zod-like schema.
|
|
313
|
-
* Throws ValidationException on failure.
|
|
314
|
-
*
|
|
315
|
-
* @example
|
|
316
|
-
* ```typescript
|
|
317
|
-
* const data = await this.validateBody(CreatePostSchema)
|
|
318
|
-
* ```
|
|
319
|
-
*/
|
|
184
|
+
/** Validate the request body; throws ValidationException on failure. */
|
|
320
185
|
protected validateBody<T>(schema: ZodLikeSchema<T>): Promise<T>;
|
|
321
|
-
/**
|
|
322
|
-
* Validate query parameters against a Zod-like schema.
|
|
323
|
-
* Throws ValidationException on failure.
|
|
324
|
-
*
|
|
325
|
-
* @example
|
|
326
|
-
* ```typescript
|
|
327
|
-
* const { page } = this.validateQuery(PageQuerySchema)
|
|
328
|
-
* ```
|
|
329
|
-
*/
|
|
186
|
+
/** Validate query parameters; throws ValidationException on failure. */
|
|
330
187
|
protected validateQuery<T>(schema: ZodLikeSchema<T>): T;
|
|
331
|
-
/**
|
|
332
|
-
* Validate route parameters against a Zod-like schema.
|
|
333
|
-
* Throws ValidationException on failure.
|
|
334
|
-
*
|
|
335
|
-
* @example
|
|
336
|
-
* ```typescript
|
|
337
|
-
* const { id } = this.validateParams(PostIdParamSchema)
|
|
338
|
-
* ```
|
|
339
|
-
*/
|
|
188
|
+
/** Validate route parameters; throws ValidationException on failure. */
|
|
340
189
|
protected validateParams<T>(schema: ZodLikeSchema<T>): T;
|
|
341
|
-
/**
|
|
342
|
-
* Validate the request body against a Zod-like schema without throwing.
|
|
343
|
-
* Returns a discriminated union: `{ success: true, data }` or `{ success: false, errors }`.
|
|
344
|
-
*
|
|
345
|
-
* @example
|
|
346
|
-
* ```typescript
|
|
347
|
-
* const result = await this.validateBodySafe(CreatePostSchema)
|
|
348
|
-
* if (!result.success) {
|
|
349
|
-
* return this.inertia(pages.posts.New, { errors: result.errors }, { status: 422 })
|
|
350
|
-
* }
|
|
351
|
-
* const { title, body } = result.data
|
|
352
|
-
* ```
|
|
353
|
-
*/
|
|
190
|
+
/** Validate the request body without throwing; returns data or field errors. */
|
|
354
191
|
protected validateBodySafe<T>(schema: ZodLikeSchema<T>): Promise<SafeValidationResult<T>>;
|
|
355
|
-
/**
|
|
356
|
-
* Validate query parameters against a Zod-like schema without throwing.
|
|
357
|
-
* Returns a discriminated union: `{ success: true, data }` or `{ success: false, errors }`.
|
|
358
|
-
*/
|
|
192
|
+
/** Validate query parameters without throwing; returns data or field errors. */
|
|
359
193
|
protected validateQuerySafe<T>(schema: ZodLikeSchema<T>): SafeValidationResult<T>;
|
|
360
|
-
/**
|
|
361
|
-
* Validate route parameters against a Zod-like schema without throwing.
|
|
362
|
-
* Returns a discriminated union: `{ success: true, data }` or `{ success: false, errors }`.
|
|
363
|
-
*/
|
|
194
|
+
/** Validate route parameters without throwing; returns data or field errors. */
|
|
364
195
|
protected validateParamsSafe<T>(schema: ZodLikeSchema<T>): SafeValidationResult<T>;
|
|
365
196
|
private runValidation;
|
|
366
197
|
private runValidationSafe;
|
|
367
198
|
/**
|
|
368
|
-
* The parsed body as sent: an array stays an array, a
|
|
369
|
-
*
|
|
370
|
-
*
|
|
371
|
-
*
|
|
372
|
-
*
|
|
373
|
-
* Memoized in a box rather than by truthiness: a body of `null`, `''`, `0`
|
|
374
|
-
* or `false` is a parsed body, and re-reading the request would find the
|
|
375
|
-
* stream consumed.
|
|
376
|
-
*
|
|
377
|
-
* No fallback of its own: an unparseable body already arrives here as `{}`
|
|
378
|
-
* from {@link parseRequestBody}, which is what gives every dispatch path the
|
|
379
|
-
* same answer. A second fallback here could only diverge from that one.
|
|
199
|
+
* The parsed body as sent: an array stays an array, so a non-object contract
|
|
200
|
+
* stays reachable. Boxed rather than memoized by truthiness — `null`, `''`,
|
|
201
|
+
* `0` and `false` are parsed bodies, and re-reading would find the stream
|
|
202
|
+
* consumed. No fallback here: {@link parseRequestBody} already yields `{}`.
|
|
380
203
|
*/
|
|
381
204
|
private getRawBody;
|
|
382
|
-
/**
|
|
383
|
-
* The record view of {@link getRawBody}, for the field-by-field helpers
|
|
384
|
-
* (`input`, `only`, `except`, `has`). A non-object body has no field to
|
|
385
|
-
* read, so it reads as `{}`.
|
|
386
|
-
*/
|
|
205
|
+
/** The record view of {@link getRawBody}; a non-object body reads as `{}`. */
|
|
387
206
|
private getBody;
|
|
388
207
|
}
|
|
389
208
|
export {};
|