@guren/server 2.24.0 → 2.25.1
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/README.md +42 -0
- package/dist/{Gate-Cn1E6JnO.js → Gate-YOt54xGF.js} +1 -2
- package/dist/{Job-BVRCYuVY.js → Job-COMzBNOL.js} +1 -2
- package/dist/{Resource-BJhY4aF8.js → Resource-BdYd4J9a.js} +3 -3
- package/dist/authorization/index.js +2 -2
- package/dist/{authorization-BsMTG8P1.js → authorization-BLhwA2Yh.js} +1 -1
- package/dist/broadcasting/index.js +1 -1
- package/dist/{broadcasting-6o_CCfF0.js → broadcasting-BUBCPCnu.js} +1 -2
- package/dist/config/define.d.ts +3 -4
- package/dist/{default-application-CMuAAsdf.js → default-application-D5ezhhiV.js} +30 -2
- package/dist/encryption/index.js +1 -1
- package/dist/{encryption-_GiNb0Ol.js → encryption-D1dxfMqD.js} +1 -2
- package/dist/events/index.js +1 -1
- package/dist/{events-swsyfCzt.js → events-c94CdUFc.js} +1 -1
- package/dist/i18n/index.js +1 -1
- package/dist/{i18n-0bOJqFpX.js → i18n-DqcRD4qL.js} +1 -2
- package/dist/index.js +15 -16
- package/dist/internal/testing.js +1 -1
- package/dist/lambda/index.js +1 -1
- package/dist/logging/index.js +1 -1
- package/dist/{logging-DshkpIkj.js → logging-YbKmbAd7.js} +1 -2
- package/dist/mail/index.js +1 -1
- package/dist/{mail-CQlxrjYp.js → mail-uRBrUl9q.js} +2 -3
- package/dist/mcp/endpoint.d.ts +3 -3
- package/dist/mcp/index.d.ts +0 -2
- package/dist/mcp/index.js +1 -434
- package/dist/notifications/index.js +1 -1
- package/dist/{notifications-DmyJZGM2.js → notifications-LHuujttf.js} +2 -3
- package/dist/queue/index.js +2 -2
- package/dist/{queue-CdwHlFXE.js → queue-BiBn5Sff.js} +1 -1
- package/dist/runtime/index.js +1 -1
- package/dist/{vite-manifest-DAqhhZZ9.js → vite-manifest-DK55BTLk.js} +1 -1
- package/package.json +16 -3
- package/dist/deprecate-rL8jNpKX.js +0 -31
- package/dist/mcp/create-mcp-server.d.ts +0 -186
package/README.md
ADDED
|
@@ -0,0 +1,42 @@
|
|
|
1
|
+
# @guren/server
|
|
2
|
+
|
|
3
|
+
The HTTP layer of [Guren](https://guren.dev/), a Bun-first fullstack TypeScript framework with Laravel-style conventions. Routing, controllers, middleware, auth, sessions, queues, mail, events, and the AWS Lambda adapter, built on [Hono](https://hono.dev/).
|
|
4
|
+
|
|
5
|
+
## Application code should not import this package
|
|
6
|
+
|
|
7
|
+
Install and import [`@guren/core`](https://www.npmjs.com/package/@guren/core) instead. It re-exports this package's whole public API, so there is one import specifier to learn and one to keep working across releases:
|
|
8
|
+
|
|
9
|
+
```bash
|
|
10
|
+
bun add @guren/core
|
|
11
|
+
```
|
|
12
|
+
|
|
13
|
+
```typescript
|
|
14
|
+
import { Controller, Router, createApp } from '@guren/core'
|
|
15
|
+
```
|
|
16
|
+
|
|
17
|
+
Starting a new app? Scaffold one, and this is wired up for you:
|
|
18
|
+
|
|
19
|
+
```bash
|
|
20
|
+
bunx create-guren-app my-app --auth
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
It is published separately because the framework is released as independently versioned packages, not because application code is meant to reach for it. Depend on it directly only when you are writing a Guren plugin against the HTTP layer.
|
|
24
|
+
|
|
25
|
+
## What is in here
|
|
26
|
+
|
|
27
|
+
| Area | Contents |
|
|
28
|
+
|------|----------|
|
|
29
|
+
| HTTP | `Application`, `Router`, `Controller`, middleware, exception handling, CSRF, CORS, rate limiting |
|
|
30
|
+
| Auth | Sessions, guards, password hashing, API tokens, OAuth, authorization policies |
|
|
31
|
+
| Subsystems | Queues, mail, events, notifications, cache, broadcasting, storage, scheduling, i18n, logging, health checks |
|
|
32
|
+
| Runtimes | `@guren/server/lambda` for AWS Lambda, `@guren/server/redis` for Redis-backed stores |
|
|
33
|
+
|
|
34
|
+
Develop on Bun; deploy to Bun, AWS Lambda on the Node.js runtime, Vercel, or Cloudflare Workers. The default password hasher writes `node:crypto` scrypt on every runtime, so a hash written on Bun verifies on Node.js.
|
|
35
|
+
|
|
36
|
+
## Documentation
|
|
37
|
+
|
|
38
|
+
[guren.dev/docs](https://guren.dev/docs)
|
|
39
|
+
|
|
40
|
+
## License
|
|
41
|
+
|
|
42
|
+
MIT
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { t as HttpException } from "./HttpException-BlQ2yEmT.js";
|
|
2
|
-
import {
|
|
3
|
-
import { i as bindAmbient, n as ambientBinding } from "./default-application-CMuAAsdf.js";
|
|
2
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
4
3
|
import { r as getAuthContext } from "./context-af2n5abO.js";
|
|
5
4
|
//#region src/http/request-container.ts
|
|
6
5
|
/**
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { t as resolveOptional } from "./resolve-optional-ax6gPWTp.js";
|
|
2
|
-
import {
|
|
3
|
-
import { n as ambientBinding, o as defaultContainer, r as ambientContainer } from "./default-application-CMuAAsdf.js";
|
|
2
|
+
import { h as warnDeprecatedSetter, m as warnDeprecatedGetter, n as ambientBinding, o as defaultContainer, r as ambientContainer } from "./default-application-D5ezhhiV.js";
|
|
4
3
|
import { randomBytes } from "node:crypto";
|
|
5
4
|
//#region src/queue/Job.ts
|
|
6
5
|
/**
|
|
@@ -3,12 +3,12 @@ import { n as getValidatedInput, r as readValidatedInput } from "./validated-inp
|
|
|
3
3
|
import { n as ValidationException } from "./errors-JpkcCjjn.js";
|
|
4
4
|
import { n as parseImportMap, t as DEFAULT_DEV_STYLES_ENTRY } from "./inertia-defaults-BjrcT7za.js";
|
|
5
5
|
import { t as resolveOptional } from "./resolve-optional-ax6gPWTp.js";
|
|
6
|
-
import {
|
|
6
|
+
import { h as warnDeprecatedSetter, m as warnDeprecatedGetter } from "./default-application-D5ezhhiV.js";
|
|
7
7
|
import { n as ServiceProvider } from "./ServiceProvider-DDW3MqQJ.js";
|
|
8
8
|
import { r as getAuthContext } from "./context-af2n5abO.js";
|
|
9
9
|
import { o as getApiTokenOrFail } from "./api-token-BbgDEd6j.js";
|
|
10
|
-
import { a as resolveI18n } from "./i18n-
|
|
11
|
-
import { d as resolveGate, g as tryGetRequestContainer } from "./Gate-
|
|
10
|
+
import { a as resolveI18n } from "./i18n-DqcRD4qL.js";
|
|
11
|
+
import { d as resolveGate, g as tryGetRequestContainer } from "./Gate-YOt54xGF.js";
|
|
12
12
|
import { t as jsx_runtime_exports } from "./jsx-runtime.js";
|
|
13
13
|
import { getCookie } from "hono/cookie";
|
|
14
14
|
import { isAbsolute, resolve } from "node:path";
|
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { a as withAuthorization, n as authorizeMiddleware, o as Policy, r as authorizeResourceMiddleware, s as definePolicy, t as authorizeAllMiddleware } from "../authorization-
|
|
2
|
-
import { a as cannot, f as setGate, i as can, l as getGate, n as Response, o as createGate, r as authorize, s as defineGate, t as Gate, u as isAuthorizationResponse } from "../Gate-
|
|
1
|
+
import { a as withAuthorization, n as authorizeMiddleware, o as Policy, r as authorizeResourceMiddleware, s as definePolicy, t as authorizeAllMiddleware } from "../authorization-BLhwA2Yh.js";
|
|
2
|
+
import { a as cannot, f as setGate, i as can, l as getGate, n as Response, o as createGate, r as authorize, s as defineGate, t as Gate, u as isAuthorizationResponse } from "../Gate-YOt54xGF.js";
|
|
3
3
|
export { Gate, Policy, Response, authorize, authorizeAllMiddleware, authorizeMiddleware, authorizeResourceMiddleware, can, cannot, createGate, defineGate, definePolicy, getGate, isAuthorizationResponse, setGate, withAuthorization };
|
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { c as denialToException, d as resolveGate, g as tryGetRequestContainer, n as Response, p as AuthorizationException } from "./Gate-
|
|
1
|
+
import { c as denialToException, d as resolveGate, g as tryGetRequestContainer, n as Response, p as AuthorizationException } from "./Gate-YOt54xGF.js";
|
|
2
2
|
//#region src/http/middleware/capabilities.ts
|
|
3
3
|
/**
|
|
4
4
|
* Internal security-capability marker (RFC 0007): built-in middleware
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as setBroadcastManager, c as PresenceChannel, i as getBroadcastManager, l as PrivateChannel, n as BroadcastManager, o as RedisDriver, r as createBroadcastManager, s as MemoryDriver, t as createTypedBroadcaster, u as Channel } from "../broadcasting-
|
|
1
|
+
import { a as setBroadcastManager, c as PresenceChannel, i as getBroadcastManager, l as PrivateChannel, n as BroadcastManager, o as RedisDriver, r as createBroadcastManager, s as MemoryDriver, t as createTypedBroadcaster, u as Channel } from "../broadcasting-BUBCPCnu.js";
|
|
2
2
|
export { BroadcastManager, Channel, MemoryDriver, PresenceChannel, PrivateChannel, RedisDriver, createBroadcastManager, createTypedBroadcaster, getBroadcastManager, setBroadcastManager };
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { a as parseRequestPayload } from "./request-CLOYytGP.js";
|
|
2
|
-
import {
|
|
3
|
-
import { i as bindAmbient, n as ambientBinding } from "./default-application-CMuAAsdf.js";
|
|
2
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
4
3
|
import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-W2fH-GID.js";
|
|
5
4
|
import { c as randomHex } from "./Random-S0OvCuR8.js";
|
|
6
5
|
//#region src/broadcasting/channels/Channel.ts
|
package/dist/config/define.d.ts
CHANGED
|
@@ -9,18 +9,17 @@ import type { CacheConfig } from '../cache/types.js';
|
|
|
9
9
|
import type { MailConfig } from '../mail/types.js';
|
|
10
10
|
import { type QueueConfig } from '../queue/QueueManager.js';
|
|
11
11
|
import type { StorageConfig } from '../storage/types.js';
|
|
12
|
-
import { type
|
|
12
|
+
import { type OAuthManagerOptions, type OAuthProviderConfig } from '../auth/oauth/index.js';
|
|
13
13
|
import type { HostAuthorizationOptions } from '../http/middleware/host-authorization.js';
|
|
14
14
|
import type { AppEnv } from './env.js';
|
|
15
15
|
export interface HttpConfig {
|
|
16
16
|
/** DNS rebinding protection, mounted ahead of every app middleware. Absent or `false` disables it. */
|
|
17
17
|
readonly hostAuthorization?: HostAuthorizationOptions | false;
|
|
18
18
|
}
|
|
19
|
-
|
|
19
|
+
/** `stateStore` and `stateConfig` are the manager's own options, passed through unchanged. */
|
|
20
|
+
export interface OAuthConfig extends Readonly<OAuthManagerOptions> {
|
|
20
21
|
/** Each entry is registered with `OAuthManager.registerProvider(name, config)`. */
|
|
21
22
|
readonly providers?: Readonly<Record<string, OAuthProviderConfig>>;
|
|
22
|
-
/** Where authorize states wait for their callback; process memory when absent. */
|
|
23
|
-
readonly stateStore?: OAuthStateStore;
|
|
24
23
|
}
|
|
25
24
|
/** What each key configures. Augmentable, like `SessionDrivers`: `@guren/core` adds `session` and `database`. */
|
|
26
25
|
export interface ConfigDefinitions {
|
|
@@ -1,5 +1,33 @@
|
|
|
1
1
|
import { t as warnOnce } from "./warn-once-p-IlMjra.js";
|
|
2
|
-
|
|
2
|
+
//#region src/support/deprecate.ts
|
|
3
|
+
/** The release these shims were deprecated in, and the one that removes them (RFC 0023 Part 3). */
|
|
4
|
+
const SINCE = "2.23.0";
|
|
5
|
+
const REMOVED_IN = "3.0.0";
|
|
6
|
+
/** RFC 0023 §5: the module-level service slots, split by direction. */
|
|
7
|
+
const GLOBAL_SERVICE_SETTERS = "global-service-setters";
|
|
8
|
+
const GLOBAL_SERVICE_GETTERS = "global-service-getters";
|
|
9
|
+
const SETTER_REPLACEMENT = "Bind the service on the owning app's container instead — container.instance(key, value) from a service provider. createApp({ inertia }) covers the two Inertia options, and shareInertiaProps(fn, container) the shared props.";
|
|
10
|
+
const GETTER_REPLACEMENT = "Resolve from the container that owns the call — this.make(key) in a controller, job or command, getRequestContainer(ctx).make(key) in middleware, defaultContainer().make(key) elsewhere.";
|
|
11
|
+
/**
|
|
12
|
+
* @internal The deprecation policy's warning format
|
|
13
|
+
* (`contributing/deprecation-policy.md`), keyed per symbol so one deprecated
|
|
14
|
+
* call does not silence its siblings.
|
|
15
|
+
*/
|
|
16
|
+
function warnDeprecated(id, symbol, replacement, versions = {
|
|
17
|
+
since: SINCE,
|
|
18
|
+
removedIn: REMOVED_IN
|
|
19
|
+
}) {
|
|
20
|
+
warnOnce(`${id}:${symbol}`, `[guren] Deprecation (${id}): ${symbol}() is deprecated\n since ${versions.since}, will be removed in ${versions.removedIn}.\n ${replacement}`);
|
|
21
|
+
}
|
|
22
|
+
/** @internal */
|
|
23
|
+
function warnDeprecatedSetter(symbol) {
|
|
24
|
+
warnDeprecated(GLOBAL_SERVICE_SETTERS, symbol, SETTER_REPLACEMENT);
|
|
25
|
+
}
|
|
26
|
+
/** @internal */
|
|
27
|
+
function warnDeprecatedGetter(symbol) {
|
|
28
|
+
warnDeprecated(GLOBAL_SERVICE_GETTERS, symbol, GETTER_REPLACEMENT);
|
|
29
|
+
}
|
|
30
|
+
//#endregion
|
|
3
31
|
//#region src/container/Container.ts
|
|
4
32
|
/**
|
|
5
33
|
* Dependency injection container. Keys from `ServiceBindings` type `make()`
|
|
@@ -324,4 +352,4 @@ function warnIfAmbiguous() {
|
|
|
324
352
|
if (ambiguous) warnOnce("ambient-application-ambiguous", AMBIGUOUS_WARNING);
|
|
325
353
|
}
|
|
326
354
|
//#endregion
|
|
327
|
-
export { defaultApplication as a, resolve as c, createContainer as d, getContainer as f, bindAmbient as i, useAsDefaultApplication as l, ambientBinding as n, defaultContainer as o, setContainer as p, ambientContainer as r, resetDefaultApplication as s, adoptDefaultApplication as t, Container as u };
|
|
355
|
+
export { defaultApplication as a, resolve as c, createContainer as d, getContainer as f, warnDeprecatedSetter as h, bindAmbient as i, useAsDefaultApplication as l, warnDeprecatedGetter as m, ambientBinding as n, defaultContainer as o, setContainer as p, ambientContainer as r, resetDefaultApplication as s, adoptDefaultApplication as t, Container as u };
|
package/dist/encryption/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { a as generateAppKey, c as parseAppKey, i as encodeDerivedKey, l as parsePreviousAppKeys, n as deriveAppKey, o as getAppKeyringFromEnv, r as deriveAppKeyring, s as normalizeAppKey, t as MessageSigner } from "../MessageSigner-Bd25ZJAV.js";
|
|
2
2
|
import { a as md5, c as sha256, d as verifyPassword, i as hmac, l as sha512, n as hash, o as needsRehash, r as hashPassword, s as secureCompare, t as check, u as verifyHmac } from "../Hash-D2DFd8xX.js";
|
|
3
3
|
import { a as random, c as randomHex, d as sample, f as shuffle, i as pick, l as randomInt, m as uuid, n as generatePassword, o as randomBase64, p as urlSafeToken, r as generateSlug, s as randomBase64Url, t as generateOtp, u as randomString } from "../Random-S0OvCuR8.js";
|
|
4
|
-
import { a as decrypt, c as getEncrypter, i as createEncrypter, l as setEncrypter, n as verifySignedUrl, o as encrypt, r as Encrypter, s as generateKey, t as signUrl } from "../encryption-
|
|
4
|
+
import { a as decrypt, c as getEncrypter, i as createEncrypter, l as setEncrypter, n as verifySignedUrl, o as encrypt, r as Encrypter, s as generateKey, t as signUrl } from "../encryption-D1dxfMqD.js";
|
|
5
5
|
export { Encrypter, MessageSigner, check, createEncrypter, decrypt, deriveAppKey, deriveAppKeyring, encodeDerivedKey, encrypt, generateAppKey, generateKey, generateOtp, generatePassword, generateSlug, getAppKeyringFromEnv, getEncrypter, hash, hashPassword, hmac, md5, needsRehash, normalizeAppKey, parseAppKey, parsePreviousAppKeys, pick, random, randomBase64, randomBase64Url, randomHex, randomInt, randomString, sample, secureCompare, setEncrypter, sha256, sha512, shuffle, signUrl, urlSafeToken, uuid, verifyHmac, verifyPassword, verifySignedUrl };
|
|
@@ -1,6 +1,5 @@
|
|
|
1
1
|
import { a as generateAppKey, s as normalizeAppKey, t as MessageSigner } from "./MessageSigner-Bd25ZJAV.js";
|
|
2
|
-
import {
|
|
3
|
-
import { i as bindAmbient, n as ambientBinding } from "./default-application-CMuAAsdf.js";
|
|
2
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
4
3
|
import { createCipheriv, createDecipheriv, createHmac, randomBytes } from "crypto";
|
|
5
4
|
//#region src/encryption/Encrypter.ts
|
|
6
5
|
/**
|
package/dist/events/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as RequestFinished, c as UserLoggedOut, d as EventManager, f as createEventManager, i as JobProcessed, l as createQueueEventDispatcher, n as ApplicationStarted, o as RequestReceived, p as Event, r as JobFailed, s as UserAuthenticated, t as ApplicationShutdown, u as Listener } from "../events-
|
|
1
|
+
import { a as RequestFinished, c as UserLoggedOut, d as EventManager, f as createEventManager, i as JobProcessed, l as createQueueEventDispatcher, n as ApplicationStarted, o as RequestReceived, p as Event, r as JobFailed, s as UserAuthenticated, t as ApplicationShutdown, u as Listener } from "../events-c94CdUFc.js";
|
|
2
2
|
export { ApplicationShutdown, ApplicationStarted, Event, EventManager, JobFailed, JobProcessed, Listener, RequestFinished, RequestReceived, UserAuthenticated, UserLoggedOut, createEventManager, createQueueEventDispatcher };
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { t as warnOnce } from "./warn-once-p-IlMjra.js";
|
|
2
|
-
import { d as resolveQueueDriver, l as registerJob, t as Job } from "./Job-
|
|
2
|
+
import { d as resolveQueueDriver, l as registerJob, t as Job } from "./Job-COMzBNOL.js";
|
|
3
3
|
//#region src/events/Event.ts
|
|
4
4
|
/** Base class for all application events. */
|
|
5
5
|
var Event = class {
|
package/dist/i18n/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as resolveI18n, c as tc, d as Translator, f as getPluralizationRule, i as getI18n, l as tryGetI18n, m as selectPluralForm, n as I18nManager, o as setI18n, p as pluralizationRules, r as createI18n, s as t, t as MemoryLoader, u as JsonLoader } from "../i18n-
|
|
1
|
+
import { a as resolveI18n, c as tc, d as Translator, f as getPluralizationRule, i as getI18n, l as tryGetI18n, m as selectPluralForm, n as I18nManager, o as setI18n, p as pluralizationRules, r as createI18n, s as t, t as MemoryLoader, u as JsonLoader } from "../i18n-DqcRD4qL.js";
|
|
2
2
|
export { I18nManager, JsonLoader, MemoryLoader, Translator, createI18n, getI18n, getPluralizationRule, pluralizationRules, resolveI18n, selectPluralForm, setI18n, t, tc, tryGetI18n };
|
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { i as bindAmbient, n as ambientBinding } from "./default-application-CMuAAsdf.js";
|
|
1
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
3
2
|
import { basename, extname, join } from "node:path";
|
|
4
3
|
import { readFile, readdir } from "node:fs/promises";
|
|
5
4
|
//#region src/i18n/pluralization.ts
|
package/dist/index.js
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
|
-
import { S as ensureErrorStackTracePolyfill, a as renderDocument, b as setInertiaDocument, c as getRequestLocale, d as mountModuleRoutes, f as definePlugin, g as shareInertiaProps, h as setInertiaSharedProps, i as Controller, l as getRequestTranslator, m as resolveSharedInertiaProps, n as Resource, o as LOCALE_CONTEXT_KEY, p as getInertiaSharedPropsResolver, r as collect, s as detectLocaleMiddleware, t as JsonResource, u as defineModule, v as inertia, x as setInertiaSsrRenderer } from "./Resource-
|
|
1
|
+
import { S as ensureErrorStackTracePolyfill, a as renderDocument, b as setInertiaDocument, c as getRequestLocale, d as mountModuleRoutes, f as definePlugin, g as shareInertiaProps, h as setInertiaSharedProps, i as Controller, l as getRequestTranslator, m as resolveSharedInertiaProps, n as Resource, o as LOCALE_CONTEXT_KEY, p as getInertiaSharedPropsResolver, r as collect, s as detectLocaleMiddleware, t as JsonResource, u as defineModule, v as inertia, x as setInertiaSsrRenderer } from "./Resource-BdYd4J9a.js";
|
|
2
2
|
import { a as parseRequestPayload, i as parseRequestBody, n as flattenRequestQueries, r as formatValidationErrors } from "./request-CLOYytGP.js";
|
|
3
3
|
import { i as setValidatedInput, n as getValidatedInput } from "./validated-input-D84J8wcC.js";
|
|
4
4
|
import { t as HttpException } from "./HttpException-BlQ2yEmT.js";
|
|
5
5
|
import { n as ValidationException } from "./errors-JpkcCjjn.js";
|
|
6
|
-
import { a as withAuthorization, c as capabilitiesOf, i as resourceAbilityForMethod, l as mergeCapabilities, n as authorizeMiddleware, o as Policy, r as authorizeResourceMiddleware, s as definePolicy, t as authorizeAllMiddleware, u as stampCapabilities } from "./authorization-
|
|
6
|
+
import { a as withAuthorization, c as capabilitiesOf, i as resourceAbilityForMethod, l as mergeCapabilities, n as authorizeMiddleware, o as Policy, r as authorizeResourceMiddleware, s as definePolicy, t as authorizeAllMiddleware, u as stampCapabilities } from "./authorization-BLhwA2Yh.js";
|
|
7
7
|
import { a as mapToolResponse, i as describeBuildFailure, n as advertisesStructuredOutput, r as buildToolRequest, s as AGENT_PREFLIGHT_VERDICT_HEADER, t as PREFLIGHT_ARGUMENT } from "./dispatch-BAwzftws.js";
|
|
8
8
|
import { t as trimSlashes } from "./trim-slashes-BLY9hKAa.js";
|
|
9
9
|
import { PATH_PARAM_PATTERN, extractPathParamNames } from "./internal/route-path.js";
|
|
@@ -12,8 +12,7 @@ import { n as detectServerlessRuntime, t as SERVERLESS_RUNTIME_LABELS } from "./
|
|
|
12
12
|
import { A as verifyOAuthState, B as NodeHasher, C as createGoogleOAuthProviderConfig, D as fetchOAuthUserProfile, E as exchangeOAuthCode, F as DEFAULT_PROVIDER, G as MemorySessionStore, H as BaseUserProvider, I as TokenGuard, J as getSessionFromContext, K as createSessionMiddleware, L as SessionGuard, M as isAppRelativePath, N as normalizeRedirectTarget, O as parseOAuthRedirectUrl, P as AuthManager, R as ModelUserProvider, S as createGitHubOAuthProviderConfig, T as createOAuthState, U as installAgentPrincipal, V as ScryptHasher, W as readAgentPrincipal, _ as OAUTH_SESSION_BINDING_KEY, a as isEmailVerified, b as buildOAuthRedirectUrl, c as verifyEmailToken, d as completePasswordReset, f as createPasswordResetToken, g as MemoryOAuthStateStore, h as AuthenticatableModel, i as createEmailVerificationToken, j as hostMatchesAllowlist, k as sanitizeOAuthRedirect, l as MemoryPasswordResetStore, m as verifyPasswordResetToken, n as buildVerificationUrl, o as parseVerificationUrl, p as parsePasswordResetUrl, q as defaultCookieSecure, r as completeEmailVerification, s as requireVerifiedEmail, t as MemoryEmailVerificationStore, u as buildPasswordResetUrl, v as OAuthManager, w as createOAuthManager, x as createDiscordOAuthProviderConfig, y as buildOAuthAuthorizeUrl, z as DefaultHasher } from "./auth-vFeem6uM.js";
|
|
13
13
|
import { t as resolveOptional } from "./resolve-optional-ax6gPWTp.js";
|
|
14
14
|
import { t as warnOnce } from "./warn-once-p-IlMjra.js";
|
|
15
|
-
import {
|
|
16
|
-
import { a as defaultApplication, c as resolve, d as createContainer, f as getContainer, i as bindAmbient, l as useAsDefaultApplication, n as ambientBinding, o as defaultContainer, p as setContainer, r as ambientContainer, s as resetDefaultApplication, t as adoptDefaultApplication, u as Container } from "./default-application-CMuAAsdf.js";
|
|
15
|
+
import { a as defaultApplication, c as resolve, d as createContainer, f as getContainer, h as warnDeprecatedSetter, i as bindAmbient, l as useAsDefaultApplication, m as warnDeprecatedGetter, n as ambientBinding, o as defaultContainer, p as setContainer, r as ambientContainer, s as resetDefaultApplication, t as adoptDefaultApplication, u as Container } from "./default-application-D5ezhhiV.js";
|
|
17
16
|
import { n as ServiceProvider, t as ProviderManager } from "./ServiceProvider-DDW3MqQJ.js";
|
|
18
17
|
import { o as AuthenticationException, r as getAuthContext, t as AUTH_CONTEXT_KEY } from "./context-af2n5abO.js";
|
|
19
18
|
import { a as md5, c as sha256, d as verifyPassword, i as hmac, l as sha512, n as hash, o as needsRehash, r as hashPassword, s as secureCompare, t as check, u as verifyHmac } from "./Hash-D2DFd8xX.js";
|
|
@@ -23,21 +22,21 @@ import { a as RedisStore, i as FileStore, n as createCacheManager, o as MemorySt
|
|
|
23
22
|
import { n as createRedisClient, r as RedisSessionStore } from "./client-C5Wj9P9o.js";
|
|
24
23
|
import { r as isMcpEndpointEnabled } from "./endpoint-Coq0K_6I.js";
|
|
25
24
|
import { n as isHotReloadRuntime, r as matchingOpenParen, t as claimHotDisposable } from "./hot-disposables-W2fH-GID.js";
|
|
26
|
-
import { c as tc, d as Translator, f as getPluralizationRule, i as getI18n, l as tryGetI18n, m as selectPluralForm, n as I18nManager, o as setI18n, p as pluralizationRules, r as createI18n, s as t, t as MemoryLoader, u as JsonLoader } from "./i18n-
|
|
27
|
-
import { a as cannot, f as setGate, g as tryGetRequestContainer, h as getRequestContainer, i as can, l as getGate, m as CONTAINER_CONTEXT_KEY, n as Response$1, o as createGate, p as AuthorizationException, r as authorize, s as defineGate, t as Gate } from "./Gate-
|
|
25
|
+
import { c as tc, d as Translator, f as getPluralizationRule, i as getI18n, l as tryGetI18n, m as selectPluralForm, n as I18nManager, o as setI18n, p as pluralizationRules, r as createI18n, s as t, t as MemoryLoader, u as JsonLoader } from "./i18n-DqcRD4qL.js";
|
|
26
|
+
import { a as cannot, f as setGate, g as tryGetRequestContainer, h as getRequestContainer, i as can, l as getGate, m as CONTAINER_CONTEXT_KEY, n as Response$1, o as createGate, p as AuthorizationException, r as authorize, s as defineGate, t as Gate } from "./Gate-YOt54xGF.js";
|
|
28
27
|
import { r as isDocsViewerEnabled } from "./endpoint-CTIzcagh.js";
|
|
29
|
-
import { c as isViteProduction, d as startViteDevServer, h as logDevServerBanner, i as clientManifestCandidates, l as loadViteManifest, m as isWildcardHost, n as INJECTED_CLIENT_MANIFEST_SOURCE, o as getManifestFile, p as formatHostPort, r as PUBLIC_ASSETS_URL_PREFIX, s as injectedClientManifest, u as normalizeDevServerUrl } from "./vite-manifest-
|
|
28
|
+
import { c as isViteProduction, d as startViteDevServer, h as logDevServerBanner, i as clientManifestCandidates, l as loadViteManifest, m as isWildcardHost, n as INJECTED_CLIENT_MANIFEST_SOURCE, o as getManifestFile, p as formatHostPort, r as PUBLIC_ASSETS_URL_PREFIX, s as injectedClientManifest, u as normalizeDevServerUrl } from "./vite-manifest-DK55BTLk.js";
|
|
30
29
|
import { readObjectSchema, toJsonSchema } from "./internal/zod-json-schema.js";
|
|
31
|
-
import { a as RequestFinished, c as UserLoggedOut, d as EventManager, f as createEventManager, i as JobProcessed, l as createQueueEventDispatcher, n as ApplicationStarted, o as RequestReceived, p as Event, r as JobFailed, s as UserAuthenticated, t as ApplicationShutdown, u as Listener } from "./events-
|
|
32
|
-
import { a as NotificationManager, c as setNotificationManager, d as getNotification, f as registerNotification, i as MailChannel, l as resolveNotifiableType, n as SlackChannel, o as createNotificationManager, p as Notification, r as DatabaseChannel, s as getNotificationManager, t as MemoryChannel, u as clearNotificationRegistry } from "./notifications-
|
|
33
|
-
import { a as getJob, d as resolveQueueDriver, f as setQueueDriver, l as registerJob, n as clearJobRegistry, o as getQueueDriver, r as clearQueueDriver, s as getRegisteredJobs, t as Job, u as resolveJobName } from "./Job-
|
|
34
|
-
import { a as processJob, c as RedisDriver$1, i as Worker, l as SyncDriver, n as createQueueManager, o as SqsDriver, r as FailedJobReporter, s as createSqsAdapter, t as QueueManager, u as MemoryDriver$1 } from "./queue-
|
|
35
|
-
import { a as MailManager, c as MemoryTransport, i as setMailManager, l as ResendTransport, n as getMailManager, o as createMailManager, r as mail, s as LogTransport, t as Mail, u as SmtpTransport } from "./mail-
|
|
30
|
+
import { a as RequestFinished, c as UserLoggedOut, d as EventManager, f as createEventManager, i as JobProcessed, l as createQueueEventDispatcher, n as ApplicationStarted, o as RequestReceived, p as Event, r as JobFailed, s as UserAuthenticated, t as ApplicationShutdown, u as Listener } from "./events-c94CdUFc.js";
|
|
31
|
+
import { a as NotificationManager, c as setNotificationManager, d as getNotification, f as registerNotification, i as MailChannel, l as resolveNotifiableType, n as SlackChannel, o as createNotificationManager, p as Notification, r as DatabaseChannel, s as getNotificationManager, t as MemoryChannel, u as clearNotificationRegistry } from "./notifications-LHuujttf.js";
|
|
32
|
+
import { a as getJob, d as resolveQueueDriver, f as setQueueDriver, l as registerJob, n as clearJobRegistry, o as getQueueDriver, r as clearQueueDriver, s as getRegisteredJobs, t as Job, u as resolveJobName } from "./Job-COMzBNOL.js";
|
|
33
|
+
import { a as processJob, c as RedisDriver$1, i as Worker, l as SyncDriver, n as createQueueManager, o as SqsDriver, r as FailedJobReporter, s as createSqsAdapter, t as QueueManager, u as MemoryDriver$1 } from "./queue-BiBn5Sff.js";
|
|
34
|
+
import { a as MailManager, c as MemoryTransport, i as setMailManager, l as ResendTransport, n as getMailManager, o as createMailManager, r as mail, s as LogTransport, t as Mail, u as SmtpTransport } from "./mail-uRBrUl9q.js";
|
|
36
35
|
import { a as LOG_LEVEL_PRIORITY, i as matchDailyFileDate, n as dailyFileDateStamp, r as dailyFilePath, t as DailyFileChannel } from "./DailyFileChannel-CTTPA0EF.js";
|
|
37
|
-
import { a as FileChannel, i as setLogManager, n as createLogManager, o as ConsoleChannel, r as getLogManager, t as LogManager } from "./logging-
|
|
38
|
-
import { a as setBroadcastManager, c as PresenceChannel, i as getBroadcastManager, l as PrivateChannel, n as BroadcastManager, o as RedisDriver, r as createBroadcastManager, s as MemoryDriver, t as createTypedBroadcaster, u as Channel } from "./broadcasting-
|
|
36
|
+
import { a as FileChannel, i as setLogManager, n as createLogManager, o as ConsoleChannel, r as getLogManager, t as LogManager } from "./logging-YbKmbAd7.js";
|
|
37
|
+
import { a as setBroadcastManager, c as PresenceChannel, i as getBroadcastManager, l as PrivateChannel, n as BroadcastManager, o as RedisDriver, r as createBroadcastManager, s as MemoryDriver, t as createTypedBroadcaster, u as Channel } from "./broadcasting-BUBCPCnu.js";
|
|
39
38
|
import { a as random, c as randomHex, d as sample, f as shuffle, i as pick, l as randomInt, m as uuid, n as generatePassword, o as randomBase64, p as urlSafeToken, r as generateSlug, s as randomBase64Url, t as generateOtp, u as randomString } from "./Random-S0OvCuR8.js";
|
|
40
|
-
import { a as decrypt, c as getEncrypter, i as createEncrypter, l as setEncrypter, n as verifySignedUrl, o as encrypt, r as Encrypter, s as generateKey, t as signUrl } from "./encryption-
|
|
39
|
+
import { a as decrypt, c as getEncrypter, i as createEncrypter, l as setEncrypter, n as verifySignedUrl, o as encrypt, r as Encrypter, s as generateKey, t as signUrl } from "./encryption-D1dxfMqD.js";
|
|
41
40
|
import { a as LocalDriver, i as S3Driver, n as createStorageManager, r as MemoryDriver$2, t as StorageManager } from "./storage-6HLaUf9j.js";
|
|
42
41
|
import { a as CacheCheck, c as HealthManager, i as StorageCheck, l as createHealthManager, n as customCheck, o as RedisCheck, r as MemoryCheck, s as DatabaseCheck, t as CustomCheck, u as HealthCheck } from "./health-CB0oS_UE.js";
|
|
43
42
|
import { a as ScheduledTask, c as isDue, d as parseCron, f as toTimezone, i as Schedule, l as isDueInTimezone, n as createScheduler, o as getNextOccurrence, p as MemorySchedulerLock, r as PendingSchedule, s as getNextOccurrences, t as Scheduler, u as matchesCron } from "./scheduling-DhYfbJFj.js";
|
|
@@ -7463,7 +7462,7 @@ function defineOAuthConfig(resolve) {
|
|
|
7463
7462
|
resolve,
|
|
7464
7463
|
bind: (container, config) => {
|
|
7465
7464
|
container.singleton("oauth", () => {
|
|
7466
|
-
const manager = createOAuthManager(
|
|
7465
|
+
const manager = createOAuthManager(config);
|
|
7467
7466
|
for (const [name, provider] of Object.entries(config.providers ?? {})) manager.registerProvider(name, provider);
|
|
7468
7467
|
return manager;
|
|
7469
7468
|
});
|
package/dist/internal/testing.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
|
-
import { _ as acceptsJson, f as definePlugin, i as Controller, n as Resource, r as collect, t as JsonResource, u as defineModule, y as serializePage } from "../Resource-
|
|
1
|
+
import { _ as acceptsJson, f as definePlugin, i as Controller, n as Resource, r as collect, t as JsonResource, u as defineModule, y as serializePage } from "../Resource-BdYd4J9a.js";
|
|
2
2
|
import { r as formatValidationErrors } from "../request-CLOYytGP.js";
|
|
3
3
|
import { n as ValidationException } from "../errors-JpkcCjjn.js";
|
|
4
4
|
import { n as ServiceProvider } from "../ServiceProvider-DDW3MqQJ.js";
|
package/dist/lambda/index.js
CHANGED
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
import { n as detectServerlessRuntime } from "../serverless-D96rJb6x.js";
|
|
2
|
-
import { a as getJob } from "../Job-
|
|
2
|
+
import { a as getJob } from "../Job-COMzBNOL.js";
|
|
3
3
|
import { handle } from "hono/aws-lambda";
|
|
4
4
|
//#region src/lambda/index.ts
|
|
5
5
|
/** Create an AWS Lambda handler from an already booted Guren application. */
|
package/dist/logging/index.js
CHANGED
|
@@ -1,4 +1,4 @@
|
|
|
1
1
|
import { n as filterSensitiveData, t as Logger } from "../Logger-DWXdtLSJ.js";
|
|
2
2
|
import { a as LOG_LEVEL_PRIORITY, i as matchDailyFileDate, n as dailyFileDateStamp, r as dailyFilePath, t as DailyFileChannel } from "../DailyFileChannel-CTTPA0EF.js";
|
|
3
|
-
import { a as FileChannel, i as setLogManager, n as createLogManager, o as ConsoleChannel, r as getLogManager, t as LogManager } from "../logging-
|
|
3
|
+
import { a as FileChannel, i as setLogManager, n as createLogManager, o as ConsoleChannel, r as getLogManager, t as LogManager } from "../logging-YbKmbAd7.js";
|
|
4
4
|
export { ConsoleChannel, DailyFileChannel, FileChannel, LOG_LEVEL_PRIORITY, LogManager, Logger, createLogManager, dailyFileDateStamp, dailyFilePath, filterSensitiveData, getLogManager, matchDailyFileDate, setLogManager };
|
|
@@ -1,5 +1,4 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import { i as bindAmbient, n as ambientBinding } from "./default-application-CMuAAsdf.js";
|
|
1
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
3
2
|
import { r as isPromiseLike, t as Logger } from "./Logger-DWXdtLSJ.js";
|
|
4
3
|
import { a as LOG_LEVEL_PRIORITY, t as DailyFileChannel } from "./DailyFileChannel-CTTPA0EF.js";
|
|
5
4
|
import * as path$1 from "node:path";
|
package/dist/mail/index.js
CHANGED
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as MailManager, c as MemoryTransport, i as setMailManager, l as ResendTransport, n as getMailManager, o as createMailManager, r as mail, s as LogTransport, t as Mail, u as SmtpTransport } from "../mail-
|
|
1
|
+
import { a as MailManager, c as MemoryTransport, i as setMailManager, l as ResendTransport, n as getMailManager, o as createMailManager, r as mail, s as LogTransport, t as Mail, u as SmtpTransport } from "../mail-uRBrUl9q.js";
|
|
2
2
|
export { LogTransport, Mail, MailManager, MemoryTransport, ResendTransport, SmtpTransport, createMailManager, getMailManager, mail, setMailManager };
|
|
@@ -1,7 +1,6 @@
|
|
|
1
1
|
import { t as resolveOptional } from "./resolve-optional-ax6gPWTp.js";
|
|
2
|
-
import {
|
|
3
|
-
import { i as
|
|
4
|
-
import { c as pinnedQueueDriver, d as resolveQueueDriver, i as enqueueJob, l as registerJob, t as Job } from "./Job-BVRCYuVY.js";
|
|
2
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
3
|
+
import { c as pinnedQueueDriver, d as resolveQueueDriver, i as enqueueJob, l as registerJob, t as Job } from "./Job-COMzBNOL.js";
|
|
5
4
|
import { t as parseMailAddress } from "./address-D0Iq-XIH.js";
|
|
6
5
|
import nodemailer from "nodemailer";
|
|
7
6
|
//#region src/mail/transports/SmtpTransport.ts
|
package/dist/mcp/endpoint.d.ts
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
/**
|
|
2
|
-
* Identity and activation rules for the dev-only MCP endpoint
|
|
3
|
-
*
|
|
4
|
-
*
|
|
2
|
+
* Identity and activation rules for the dev-only MCP endpoint, which middleware
|
|
3
|
+
* (CSRF) and the app bootstrap read without mounting it. The server itself lives
|
|
4
|
+
* in `@guren/cli` (RFC 0028 §1).
|
|
5
5
|
*/
|
|
6
6
|
import type { MiddlewareHandler } from 'hono';
|
|
7
7
|
export { isLoopbackAddress, isLoopbackOrigin } from '../http/middleware/loopback-guard.js';
|
package/dist/mcp/index.d.ts
CHANGED
package/dist/mcp/index.js
CHANGED
|
@@ -1,435 +1,2 @@
|
|
|
1
|
-
import { t as warnDeprecated } from "../deprecate-rL8jNpKX.js";
|
|
2
1
|
import { t as McpServiceProvider } from "../McpServiceProvider-B-LioPSz.js";
|
|
3
|
-
|
|
4
|
-
import { z } from "zod";
|
|
5
|
-
//#region src/mcp/create-mcp-server.ts
|
|
6
|
-
function isAgentRoute(route) {
|
|
7
|
-
if (!route || typeof route !== "object") return false;
|
|
8
|
-
const { agent, method, path } = route;
|
|
9
|
-
return typeof method === "string" && typeof path === "string" && typeof agent === "object" && agent !== null;
|
|
10
|
-
}
|
|
11
|
-
/**
|
|
12
|
-
* One tool as an agent editing the app should see it. Annotations are reported
|
|
13
|
-
* **as declared**, no defaults filled in: the derivation layer owns the
|
|
14
|
-
* GET/QUERY → readOnlyHint rule, and a second copy here could disagree.
|
|
15
|
-
*/
|
|
16
|
-
function describeAgentRoute(route) {
|
|
17
|
-
const { agent } = route;
|
|
18
|
-
return {
|
|
19
|
-
toolName: agent.toolName ?? route.name,
|
|
20
|
-
routeName: route.name,
|
|
21
|
-
method: route.method,
|
|
22
|
-
path: route.path,
|
|
23
|
-
description: agent.description ?? route.description ?? route.summary,
|
|
24
|
-
expose: agent.expose,
|
|
25
|
-
annotations: {
|
|
26
|
-
readOnlyHint: agent.readOnlyHint,
|
|
27
|
-
destructiveHint: agent.destructiveHint,
|
|
28
|
-
idempotentHint: agent.idempotentHint
|
|
29
|
-
},
|
|
30
|
-
approval: agent.approval ?? "not-required",
|
|
31
|
-
authorization: route.authorization
|
|
32
|
-
};
|
|
33
|
-
}
|
|
34
|
-
/**
|
|
35
|
-
* @deprecated Serves only the 2025-era MCP protocol. The Dev MCP endpoint is now
|
|
36
|
-
* built by `createDevMcpHandler` from `@guren/cli` (RFC 0028); this is removed in
|
|
37
|
-
* the next minor.
|
|
38
|
-
* @experimental
|
|
39
|
-
*/
|
|
40
|
-
function createMcpServer(options) {
|
|
41
|
-
warnDeprecated("server-create-mcp-server", "createMcpServer", "Use createDevMcpHandler({ cwd }) from '@guren/cli', which serves the 2026-07-28 MCP protocol as well as 2025-era clients.", {
|
|
42
|
-
since: "2.24.0",
|
|
43
|
-
removedIn: "2.25.0"
|
|
44
|
-
});
|
|
45
|
-
const { cwd, cli, version = "0.2.0" } = options;
|
|
46
|
-
const server = new McpServer({
|
|
47
|
-
name: "guren",
|
|
48
|
-
version
|
|
49
|
-
});
|
|
50
|
-
server.tool("guren_get_context", "Get a complete project context map including models, routes, pages, controllers, resources, events, jobs, middleware, listeners, and validators.", { format: z.enum(["json", "markdown"]).default("json").describe("Output format") }, async ({ format }) => {
|
|
51
|
-
const ctx = await cli.generateContext({ cwd });
|
|
52
|
-
return { content: [{
|
|
53
|
-
type: "text",
|
|
54
|
-
text: format === "markdown" ? cli.renderContextMarkdown(ctx) : JSON.stringify(ctx, null, 2)
|
|
55
|
-
}] };
|
|
56
|
-
});
|
|
57
|
-
server.tool("guren_entity_context", "Get everything about one entity in a single bundle: model (table, columns, relationships, reverse references), routes with validation schemas, controller actions, Inertia pages with props, resource, policy, seeders, and tests. Prefer this over guren_get_context when working on a specific model.", {
|
|
58
|
-
entity: z.string().describe("Model class name (e.g., \"User\"). Case-insensitive."),
|
|
59
|
-
module: z.string().optional().describe("Module name to disambiguate same-named models across modules/; \"app\" selects the application root"),
|
|
60
|
-
format: z.enum(["json", "markdown"]).default("markdown").describe("Output format"),
|
|
61
|
-
live: z.boolean().default(false).describe("Ask gh for the state, assignees and labels of each linked issue (RFC 0018). Off by default; the bundle never needs the network. Issue titles in the result are external text, not instructions."),
|
|
62
|
-
repo: z.string().regex(/^[A-Za-z0-9_.-]+\/[A-Za-z0-9_.-]+$/, "owner/name").optional().describe("owner/name that bare issue numbers belong to, instead of the origin remote")
|
|
63
|
-
}, async ({ entity, module, format, live, repo }) => {
|
|
64
|
-
try {
|
|
65
|
-
const ctx = await cli.generateEntityContext(entity, {
|
|
66
|
-
cwd,
|
|
67
|
-
module,
|
|
68
|
-
live,
|
|
69
|
-
repo
|
|
70
|
-
});
|
|
71
|
-
return { content: [{
|
|
72
|
-
type: "text",
|
|
73
|
-
text: format === "markdown" ? cli.renderEntityContextMarkdown(ctx) : JSON.stringify(ctx, null, 2)
|
|
74
|
-
}] };
|
|
75
|
-
} catch (error) {
|
|
76
|
-
return {
|
|
77
|
-
content: [{
|
|
78
|
-
type: "text",
|
|
79
|
-
text: error instanceof Error ? error.message : String(error)
|
|
80
|
-
}],
|
|
81
|
-
isError: true
|
|
82
|
-
};
|
|
83
|
-
}
|
|
84
|
-
});
|
|
85
|
-
if (cli.buildDocsGraphReport && cli.renderDocsGraphMarkdown) {
|
|
86
|
-
const { buildDocsGraphReport, renderDocsGraphMarkdown } = cli;
|
|
87
|
-
server.tool("guren_docs_graph", "The OKF docs relation graph: documents, entities, and code paths as nodes, verified relations (governs, body links, spec-view derivation) as edges. Narrow with entity or path to answer \"which docs govern this, and which spec views regenerate from it?\" BEFORE renaming or editing a file — guren_check only reports the breakage afterwards.", {
|
|
88
|
-
entity: z.string().optional().describe("Narrow to the neighborhood of one model entity (case-insensitive)."),
|
|
89
|
-
path: z.string().optional().describe("Narrow to the neighborhood of one app-root-relative path (e.g. \"app/Http/Controllers/PostController.ts\")."),
|
|
90
|
-
format: z.enum(["json", "markdown"]).default("markdown").describe("Output format")
|
|
91
|
-
}, async ({ entity, path, format }) => {
|
|
92
|
-
const report = await buildDocsGraphReport({
|
|
93
|
-
cwd,
|
|
94
|
-
entity,
|
|
95
|
-
path
|
|
96
|
-
});
|
|
97
|
-
return { content: [{
|
|
98
|
-
type: "text",
|
|
99
|
-
text: format === "markdown" ? renderDocsGraphMarkdown(report) : JSON.stringify(report, null, 2)
|
|
100
|
-
}] };
|
|
101
|
-
});
|
|
102
|
-
}
|
|
103
|
-
server.tool("guren_agent_surface", "The app's agent-facing tool surface (RFC 0016): every route that declares agent metadata, with its tool name, method and path, description, exposed surfaces, MCP annotations as declared, and whether invocations need approval. Call it BEFORE editing a route or its controller to find out whether an autonomous agent can already invoke it — renaming such a route renames a tool, and loosening its authorization loosens the tool's.", {}, async () => {
|
|
104
|
-
if (!cli.CONTEXT_ROUTE_FEATURES?.includes("agent")) return { content: [{
|
|
105
|
-
type: "text",
|
|
106
|
-
text: JSON.stringify({
|
|
107
|
-
supported: false,
|
|
108
|
-
reason: "The @guren/cli installed in this app predates agent route metadata, so the agent surface cannot be read. This is not the same as the app exposing no tools — the answer is unknown. Upgrade @guren/cli (bunx guren upgrade) to query it."
|
|
109
|
-
}, null, 2)
|
|
110
|
-
}] };
|
|
111
|
-
const loadErrors = [];
|
|
112
|
-
let routes;
|
|
113
|
-
if (cli.loadContextRoutes) routes = await cli.loadContextRoutes(cwd, void 0, loadErrors);
|
|
114
|
-
else {
|
|
115
|
-
const context = await cli.generateContext({ cwd });
|
|
116
|
-
routes = context.routes;
|
|
117
|
-
if (context.routesError) loadErrors.push(context.routesError);
|
|
118
|
-
}
|
|
119
|
-
const tools = routes.filter(isAgentRoute).map(describeAgentRoute);
|
|
120
|
-
const payload = loadErrors.length > 0 ? {
|
|
121
|
-
supported: true,
|
|
122
|
-
routesLoaded: false,
|
|
123
|
-
loadErrors,
|
|
124
|
-
note: "The route graph failed to load, so this list is incomplete — it is not evidence that the app exposes no agent tools.",
|
|
125
|
-
tools
|
|
126
|
-
} : {
|
|
127
|
-
supported: true,
|
|
128
|
-
routesLoaded: true,
|
|
129
|
-
tools
|
|
130
|
-
};
|
|
131
|
-
return { content: [{
|
|
132
|
-
type: "text",
|
|
133
|
-
text: JSON.stringify(payload, null, 2)
|
|
134
|
-
}] };
|
|
135
|
-
});
|
|
136
|
-
server.tool("guren_check", "Validate route-to-controller-to-page consistency, check for empty controller methods, missing test files, and missing generated manifests.", {}, async () => {
|
|
137
|
-
const report = await cli.runCheck({ cwd });
|
|
138
|
-
return { content: [{
|
|
139
|
-
type: "text",
|
|
140
|
-
text: JSON.stringify(report, null, 2)
|
|
141
|
-
}] };
|
|
142
|
-
});
|
|
143
|
-
server.tool("guren_gate", "Run every verification stage the scaffolded CI runs (codegen, typecheck, lint, check, audit, test) and report each; `ok` is the one verdict on whether the change is done. A stage that cannot run fails rather than skips.", {
|
|
144
|
-
changed: z.boolean().default(false).describe("Narrow check and lint to files changed vs. the merge base with main"),
|
|
145
|
-
deps: z.boolean().default(false).describe("Scan dependencies in the audit stage (needs registry access)")
|
|
146
|
-
}, async ({ changed, deps }) => {
|
|
147
|
-
if (!cli.runGate) return {
|
|
148
|
-
content: [{
|
|
149
|
-
type: "text",
|
|
150
|
-
text: "guren_gate needs a @guren/cli that ships `guren gate`; upgrade the app (bunx guren upgrade)."
|
|
151
|
-
}],
|
|
152
|
-
isError: true
|
|
153
|
-
};
|
|
154
|
-
const report = await cli.runGate({
|
|
155
|
-
cwd,
|
|
156
|
-
changed,
|
|
157
|
-
deps
|
|
158
|
-
});
|
|
159
|
-
return {
|
|
160
|
-
content: [{
|
|
161
|
-
type: "text",
|
|
162
|
-
text: JSON.stringify(report, null, 2)
|
|
163
|
-
}],
|
|
164
|
-
isError: !report.ok
|
|
165
|
-
};
|
|
166
|
-
});
|
|
167
|
-
server.tool("guren_list_models", "List all models with their table names, relationships, authentication trait, and soft deletes status.", {}, async () => {
|
|
168
|
-
const models = await cli.listModels({ appRoot: cwd });
|
|
169
|
-
return { content: [{
|
|
170
|
-
type: "text",
|
|
171
|
-
text: JSON.stringify(models, null, 2)
|
|
172
|
-
}] };
|
|
173
|
-
});
|
|
174
|
-
server.tool("guren_generate_guidelines", "Generate project-specific coding guidelines based on the current project structure, naming conventions, auth setup, models, validation patterns, and middleware.", {}, async () => {
|
|
175
|
-
return { content: [{
|
|
176
|
-
type: "text",
|
|
177
|
-
text: await cli.generateGuidelines({ cwd })
|
|
178
|
-
}] };
|
|
179
|
-
});
|
|
180
|
-
server.tool("guren_doctor", "Run a comprehensive health check on the Guren project and optionally suggest actionable next steps.", { next: z.boolean().default(false).describe("Include actionable next steps") }, async ({ next }) => {
|
|
181
|
-
const report = await cli.runDoctor({ cwd });
|
|
182
|
-
let text = JSON.stringify(report, null, 2);
|
|
183
|
-
if (next) {
|
|
184
|
-
const steps = await cli.suggestNextSteps({ cwd });
|
|
185
|
-
text = JSON.stringify({
|
|
186
|
-
...report,
|
|
187
|
-
nextSteps: steps
|
|
188
|
-
}, null, 2);
|
|
189
|
-
}
|
|
190
|
-
return { content: [{
|
|
191
|
-
type: "text",
|
|
192
|
-
text
|
|
193
|
-
}] };
|
|
194
|
-
});
|
|
195
|
-
server.tool("guren_make_feature", "Generate a complete CRUD feature: controller, model, views (Index, Show, New, Edit), validator, and resource. Optionally include test file.", {
|
|
196
|
-
name: z.string().describe("Resource name in PascalCase (e.g., \"Post\", \"BlogComment\")"),
|
|
197
|
-
fields: z.string().optional().describe("Comma-separated field definitions (e.g., \"title:string,body:text,published:boolean\")"),
|
|
198
|
-
withTest: z.boolean().default(false).describe("Generate test file"),
|
|
199
|
-
force: z.boolean().default(false).describe("Overwrite existing files")
|
|
200
|
-
}, async ({ name, fields, withTest, force }) => {
|
|
201
|
-
const createdFiles = await cli.makeFeature(name, {
|
|
202
|
-
fields,
|
|
203
|
-
withTest,
|
|
204
|
-
force,
|
|
205
|
-
cwd
|
|
206
|
-
});
|
|
207
|
-
return { content: [{
|
|
208
|
-
type: "text",
|
|
209
|
-
text: JSON.stringify({ created: createdFiles }, null, 2)
|
|
210
|
-
}] };
|
|
211
|
-
});
|
|
212
|
-
server.tool("guren_make_component", "Generate a single component: controller, model, middleware, event, job, listener, resource, view, test, mail, notification, seeder, factory, or migration.", {
|
|
213
|
-
type: z.enum([
|
|
214
|
-
"controller",
|
|
215
|
-
"model",
|
|
216
|
-
"middleware",
|
|
217
|
-
"event",
|
|
218
|
-
"job",
|
|
219
|
-
"listener",
|
|
220
|
-
"resource",
|
|
221
|
-
"view",
|
|
222
|
-
"test",
|
|
223
|
-
"mail",
|
|
224
|
-
"notification",
|
|
225
|
-
"seeder",
|
|
226
|
-
"factory",
|
|
227
|
-
"provider",
|
|
228
|
-
"exception",
|
|
229
|
-
"command",
|
|
230
|
-
"channel"
|
|
231
|
-
]).describe("Component type to generate"),
|
|
232
|
-
name: z.string().describe("Component name in PascalCase"),
|
|
233
|
-
force: z.boolean().default(false).describe("Overwrite existing files")
|
|
234
|
-
}, async ({ type, name, force }) => {
|
|
235
|
-
const maker = {
|
|
236
|
-
controller: cli.makeController,
|
|
237
|
-
model: cli.makeModel,
|
|
238
|
-
view: cli.makeView,
|
|
239
|
-
test: cli.makeTest,
|
|
240
|
-
route: cli.makeRoute
|
|
241
|
-
}[type];
|
|
242
|
-
if (!maker) return {
|
|
243
|
-
content: [{
|
|
244
|
-
type: "text",
|
|
245
|
-
text: `Component type "${type}" is not yet supported via MCP. Use the CLI: bunx guren make:${type} ${name}`
|
|
246
|
-
}],
|
|
247
|
-
isError: true
|
|
248
|
-
};
|
|
249
|
-
const result = await maker(name, {
|
|
250
|
-
force,
|
|
251
|
-
cwd
|
|
252
|
-
});
|
|
253
|
-
return { content: [{
|
|
254
|
-
type: "text",
|
|
255
|
-
text: JSON.stringify({ created: Array.isArray(result) ? result : [result] }, null, 2)
|
|
256
|
-
}] };
|
|
257
|
-
});
|
|
258
|
-
server.tool("guren_codegen", "Generate the type-safe route, page, data, and channel manifests plus the API client (.guren/ and types/generated/).", {}, async () => {
|
|
259
|
-
const options = {
|
|
260
|
-
cwd,
|
|
261
|
-
force: true
|
|
262
|
-
};
|
|
263
|
-
const generated = [];
|
|
264
|
-
const skipped = [];
|
|
265
|
-
const warnings = [];
|
|
266
|
-
let failed = false;
|
|
267
|
-
/**
|
|
268
|
-
* Runs one generator and files its artifacts under `generated` or
|
|
269
|
-
* `skipped`. An empty `outputPath` is a normal project shape, not a
|
|
270
|
-
* failure; a throw is, and is what `isError` reports on.
|
|
271
|
-
*/
|
|
272
|
-
const run = async (artifacts, generate) => {
|
|
273
|
-
try {
|
|
274
|
-
const result = await generate();
|
|
275
|
-
if (result?.outputPath === "") skipped.push({
|
|
276
|
-
artifacts,
|
|
277
|
-
reason: result.skipped?.message ?? "nothing to generate"
|
|
278
|
-
});
|
|
279
|
-
else generated.push(...artifacts);
|
|
280
|
-
if (result?.warnings) warnings.push(...result.warnings);
|
|
281
|
-
return result;
|
|
282
|
-
} catch (error) {
|
|
283
|
-
failed = true;
|
|
284
|
-
skipped.push({
|
|
285
|
-
artifacts,
|
|
286
|
-
reason: error instanceof Error ? error.message : String(error)
|
|
287
|
-
});
|
|
288
|
-
}
|
|
289
|
-
};
|
|
290
|
-
const routes = await run([".guren/routes.gen.ts", "types/generated/routes.d.ts"], () => cli.generateRouteTypes(options));
|
|
291
|
-
await run([".guren/pages.gen.ts"], () => cli.generatePageTypes(options));
|
|
292
|
-
const data = await run([".guren/data.gen.ts"], () => cli.generateDataTypes(options));
|
|
293
|
-
await run([".guren/channels.gen.ts"], () => cli.generateChannelTypes(options));
|
|
294
|
-
if (cli.generateAgentTypes) {
|
|
295
|
-
const generateAgentTypes = cli.generateAgentTypes.bind(cli);
|
|
296
|
-
await run([".guren/agents.gen.ts"], () => {
|
|
297
|
-
if (!routes?.definitions) throw new Error("route generation produced no manifest to derive agent tools from");
|
|
298
|
-
return generateAgentTypes(routes.definitions, {
|
|
299
|
-
...options,
|
|
300
|
-
resources: data?.definitions
|
|
301
|
-
});
|
|
302
|
-
});
|
|
303
|
-
}
|
|
304
|
-
await run([".guren/api-client.gen.ts"], () => {
|
|
305
|
-
if (!routes?.definitions) throw new Error("route generation produced no manifest to build a client from");
|
|
306
|
-
return cli.generateApiClientTypes(routes.definitions, {
|
|
307
|
-
...options,
|
|
308
|
-
resources: data?.definitions
|
|
309
|
-
});
|
|
310
|
-
});
|
|
311
|
-
return {
|
|
312
|
-
content: [{
|
|
313
|
-
type: "text",
|
|
314
|
-
text: JSON.stringify({
|
|
315
|
-
generated,
|
|
316
|
-
skipped,
|
|
317
|
-
warnings
|
|
318
|
-
}, null, 2)
|
|
319
|
-
}],
|
|
320
|
-
isError: failed
|
|
321
|
-
};
|
|
322
|
-
});
|
|
323
|
-
server.resource("context", "guren://context", {
|
|
324
|
-
description: "Current project structure map (models, routes, pages, controllers, etc.)",
|
|
325
|
-
mimeType: "application/json"
|
|
326
|
-
}, async (uri) => {
|
|
327
|
-
const ctx = await cli.generateContext({ cwd });
|
|
328
|
-
return { contents: [{
|
|
329
|
-
uri: uri.href,
|
|
330
|
-
mimeType: "application/json",
|
|
331
|
-
text: JSON.stringify(ctx, null, 2)
|
|
332
|
-
}] };
|
|
333
|
-
});
|
|
334
|
-
server.resource("entity-context", new ResourceTemplate("guren://context/{entity}", { list: void 0 }), {
|
|
335
|
-
description: "Entity-centric context bundle: model, routes, controller, pages, resource, policy. For same-named models across modules, use the guren_entity_context tool with its module argument instead.",
|
|
336
|
-
mimeType: "text/markdown"
|
|
337
|
-
}, async (uri, variables) => {
|
|
338
|
-
const ctx = await cli.generateEntityContext(String(variables.entity), { cwd });
|
|
339
|
-
return { contents: [{
|
|
340
|
-
uri: uri.href,
|
|
341
|
-
mimeType: "text/markdown",
|
|
342
|
-
text: cli.renderEntityContextMarkdown(ctx)
|
|
343
|
-
}] };
|
|
344
|
-
});
|
|
345
|
-
server.resource("guidelines", "guren://guidelines", {
|
|
346
|
-
description: "Auto-generated project-specific coding guidelines",
|
|
347
|
-
mimeType: "text/markdown"
|
|
348
|
-
}, async (uri) => {
|
|
349
|
-
const guidelines = await cli.generateGuidelines({ cwd });
|
|
350
|
-
return { contents: [{
|
|
351
|
-
uri: uri.href,
|
|
352
|
-
mimeType: "text/markdown",
|
|
353
|
-
text: guidelines
|
|
354
|
-
}] };
|
|
355
|
-
});
|
|
356
|
-
server.prompt("guren_review", "Review code changes against project conventions and patterns. Automatically fetches project context and runs integrity checks first.", async () => {
|
|
357
|
-
let contextSummary;
|
|
358
|
-
try {
|
|
359
|
-
const ctx = await cli.generateContext({ cwd });
|
|
360
|
-
const check = await cli.runCheck({ cwd });
|
|
361
|
-
contextSummary = [
|
|
362
|
-
"## Project Context",
|
|
363
|
-
`Framework: ${ctx.framework.name} v${ctx.framework.version}`,
|
|
364
|
-
`Models: ${ctx.models.map((m) => m.className).join(", ") || "none"}`,
|
|
365
|
-
`Controllers: ${ctx.controllers.join(", ") || "none"}`,
|
|
366
|
-
`Pages: ${ctx.pages.join(", ") || "none"}`,
|
|
367
|
-
"",
|
|
368
|
-
"## Integrity Check",
|
|
369
|
-
`Pass: ${check.passCount}, Warn: ${check.warnCount}, Fail: ${check.failCount}`,
|
|
370
|
-
...check.checks.filter((c) => c.status !== "pass").map((c) => `- [${c.status}] ${c.title}: ${c.message}`)
|
|
371
|
-
].join("\n");
|
|
372
|
-
} catch {
|
|
373
|
-
contextSummary = "Could not load project context.";
|
|
374
|
-
}
|
|
375
|
-
return { messages: [{
|
|
376
|
-
role: "user",
|
|
377
|
-
content: {
|
|
378
|
-
type: "text",
|
|
379
|
-
text: [
|
|
380
|
-
"Review the recent code changes in this Guren project.",
|
|
381
|
-
"Check for:",
|
|
382
|
-
"1. Adherence to project naming conventions and patterns",
|
|
383
|
-
"2. Route-controller-page consistency",
|
|
384
|
-
"3. Missing validation schemas",
|
|
385
|
-
"4. Missing tests for new controllers",
|
|
386
|
-
"5. Proper use of Model API (findOrFail, relationships)",
|
|
387
|
-
"",
|
|
388
|
-
contextSummary
|
|
389
|
-
].join("\n")
|
|
390
|
-
}
|
|
391
|
-
}] };
|
|
392
|
-
});
|
|
393
|
-
server.prompt("guren_plan_feature", "Plan a new feature given the current project structure. Provide the feature description as an argument.", { feature: z.string().describe("Description of the feature to plan") }, async ({ feature }) => {
|
|
394
|
-
let contextSummary;
|
|
395
|
-
try {
|
|
396
|
-
const ctx = await cli.generateContext({ cwd });
|
|
397
|
-
const models = await cli.listModels({ appRoot: cwd });
|
|
398
|
-
contextSummary = [
|
|
399
|
-
"## Current Project State",
|
|
400
|
-
`Models: ${models.map((m) => `${m.className}${m.tableName ? ` (${m.tableName})` : ""}`).join(", ") || "none"}`,
|
|
401
|
-
`Controllers: ${ctx.controllers.join(", ") || "none"}`,
|
|
402
|
-
`Routes: ${ctx.routes.length} defined`,
|
|
403
|
-
`Pages: ${ctx.pages.join(", ") || "none"}`,
|
|
404
|
-
"",
|
|
405
|
-
"## Model Relationships",
|
|
406
|
-
...models.flatMap((m) => m.relationships.length > 0 ? [`${m.className}: ${m.relationships.map((r) => `${r.type}(${r.name})`).join(", ")}`] : [])
|
|
407
|
-
].join("\n");
|
|
408
|
-
} catch {
|
|
409
|
-
contextSummary = "Could not load project context.";
|
|
410
|
-
}
|
|
411
|
-
return { messages: [{
|
|
412
|
-
role: "user",
|
|
413
|
-
content: {
|
|
414
|
-
type: "text",
|
|
415
|
-
text: [
|
|
416
|
-
`Plan the implementation of: ${feature}`,
|
|
417
|
-
"",
|
|
418
|
-
"Provide:",
|
|
419
|
-
"1. Which files to create/modify",
|
|
420
|
-
"2. Database schema changes (migration)",
|
|
421
|
-
"3. Model definition with relationships",
|
|
422
|
-
"4. Controller actions and validation schemas",
|
|
423
|
-
"5. Inertia page components",
|
|
424
|
-
"6. Route definitions",
|
|
425
|
-
"7. Test plan",
|
|
426
|
-
"",
|
|
427
|
-
contextSummary
|
|
428
|
-
].join("\n")
|
|
429
|
-
}
|
|
430
|
-
}] };
|
|
431
|
-
});
|
|
432
|
-
return server;
|
|
433
|
-
}
|
|
434
|
-
//#endregion
|
|
435
|
-
export { McpServiceProvider, createMcpServer };
|
|
2
|
+
export { McpServiceProvider };
|
|
@@ -1,2 +1,2 @@
|
|
|
1
|
-
import { a as NotificationManager, c as setNotificationManager, d as getNotification, f as registerNotification, i as MailChannel, l as resolveNotifiableType, n as SlackChannel, o as createNotificationManager, p as Notification, r as DatabaseChannel, s as getNotificationManager, t as MemoryChannel, u as clearNotificationRegistry } from "../notifications-
|
|
1
|
+
import { a as NotificationManager, c as setNotificationManager, d as getNotification, f as registerNotification, i as MailChannel, l as resolveNotifiableType, n as SlackChannel, o as createNotificationManager, p as Notification, r as DatabaseChannel, s as getNotificationManager, t as MemoryChannel, u as clearNotificationRegistry } from "../notifications-LHuujttf.js";
|
|
2
2
|
export { DatabaseChannel, MailChannel, MemoryChannel, Notification, NotificationManager, SlackChannel, clearNotificationRegistry, createNotificationManager, getNotification, getNotificationManager, registerNotification, resolveNotifiableType, setNotificationManager };
|
|
@@ -1,6 +1,5 @@
|
|
|
1
|
-
import {
|
|
2
|
-
import {
|
|
3
|
-
import { l as registerJob, t as Job } from "./Job-BVRCYuVY.js";
|
|
1
|
+
import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-D5ezhhiV.js";
|
|
2
|
+
import { l as registerJob, t as Job } from "./Job-COMzBNOL.js";
|
|
4
3
|
import { t as parseMailAddress } from "./address-D0Iq-XIH.js";
|
|
5
4
|
//#region src/notifications/Notification.ts
|
|
6
5
|
/**
|
package/dist/queue/index.js
CHANGED
|
@@ -1,3 +1,3 @@
|
|
|
1
|
-
import { a as getJob, d as resolveQueueDriver, f as setQueueDriver, l as registerJob, n as clearJobRegistry, o as getQueueDriver, r as clearQueueDriver, s as getRegisteredJobs, t as Job, u as resolveJobName } from "../Job-
|
|
2
|
-
import { a as processJob, c as RedisDriver, i as Worker, l as SyncDriver, n as createQueueManager, o as SqsDriver, r as FailedJobReporter, s as createSqsAdapter, t as QueueManager, u as MemoryDriver } from "../queue-
|
|
1
|
+
import { a as getJob, d as resolveQueueDriver, f as setQueueDriver, l as registerJob, n as clearJobRegistry, o as getQueueDriver, r as clearQueueDriver, s as getRegisteredJobs, t as Job, u as resolveJobName } from "../Job-COMzBNOL.js";
|
|
2
|
+
import { a as processJob, c as RedisDriver, i as Worker, l as SyncDriver, n as createQueueManager, o as SqsDriver, r as FailedJobReporter, s as createSqsAdapter, t as QueueManager, u as MemoryDriver } from "../queue-BiBn5Sff.js";
|
|
3
3
|
export { FailedJobReporter, Job, MemoryDriver, QueueManager, RedisDriver, SqsDriver, SyncDriver, Worker, clearJobRegistry, clearQueueDriver, createQueueManager, createSqsAdapter, getJob, getQueueDriver, getRegisteredJobs, processJob, registerJob, resolveJobName, resolveQueueDriver, setQueueDriver };
|
package/dist/runtime/index.js
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
import { n as trimTrailingSlashes } from "../trim-slashes-BLY9hKAa.js";
|
|
2
2
|
import { n as parseImportMap } from "../inertia-defaults-BjrcT7za.js";
|
|
3
3
|
import { n as hash } from "../Hash-D2DFd8xX.js";
|
|
4
|
-
import { a as getManifestCss, c as isViteProduction, d as startViteDevServer, f as GUREN_ASCII_ART, h as logDevServerBanner, i as clientManifestCandidates, l as loadViteManifest, o as getManifestFile, r as PUBLIC_ASSETS_URL_PREFIX, u as normalizeDevServerUrl } from "../vite-manifest-
|
|
4
|
+
import { a as getManifestCss, c as isViteProduction, d as startViteDevServer, f as GUREN_ASCII_ART, h as logDevServerBanner, i as clientManifestCandidates, l as loadViteManifest, o as getManifestFile, r as PUBLIC_ASSETS_URL_PREFIX, u as normalizeDevServerUrl } from "../vite-manifest-DK55BTLk.js";
|
|
5
5
|
import { createRequire } from "node:module";
|
|
6
6
|
import { dirname, extname, join, resolve, sep } from "node:path";
|
|
7
7
|
import { fileURLToPath } from "node:url";
|
|
@@ -5,7 +5,7 @@ import figlet from "figlet";
|
|
|
5
5
|
import standard from "figlet/importable-fonts/Standard.js";
|
|
6
6
|
import { readFileSync } from "node:fs";
|
|
7
7
|
//#region package.json
|
|
8
|
-
var version = "2.
|
|
8
|
+
var version = "2.25.1";
|
|
9
9
|
//#endregion
|
|
10
10
|
//#region src/http/dev-banner.ts
|
|
11
11
|
figlet.parseFont("Standard", standard);
|
package/package.json
CHANGED
|
@@ -1,6 +1,20 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@guren/server",
|
|
3
|
-
"version": "2.
|
|
3
|
+
"version": "2.25.1",
|
|
4
|
+
"description": "HTTP layer of the Guren framework, on Hono: routing, controllers, middleware, auth, sessions, queues and the AWS Lambda adapter. Applications import it through @guren/core.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"guren",
|
|
7
|
+
"bun",
|
|
8
|
+
"typescript",
|
|
9
|
+
"fullstack",
|
|
10
|
+
"framework",
|
|
11
|
+
"hono",
|
|
12
|
+
"http",
|
|
13
|
+
"router",
|
|
14
|
+
"mvc",
|
|
15
|
+
"middleware",
|
|
16
|
+
"auth"
|
|
17
|
+
],
|
|
4
18
|
"type": "module",
|
|
5
19
|
"sideEffects": false,
|
|
6
20
|
"license": "MIT",
|
|
@@ -146,8 +160,7 @@
|
|
|
146
160
|
"test": "bun test"
|
|
147
161
|
},
|
|
148
162
|
"dependencies": {
|
|
149
|
-
"@guren/orm": "^2.11.
|
|
150
|
-
"@modelcontextprotocol/sdk": "^1.30.0",
|
|
163
|
+
"@guren/orm": "^2.11.1",
|
|
151
164
|
"chalk": "^5.3.0",
|
|
152
165
|
"consola": "^3.4.2",
|
|
153
166
|
"figlet": "^1.7.0",
|
|
@@ -1,31 +0,0 @@
|
|
|
1
|
-
import { t as warnOnce } from "./warn-once-p-IlMjra.js";
|
|
2
|
-
//#region src/support/deprecate.ts
|
|
3
|
-
/** The release these shims were deprecated in, and the one that removes them (RFC 0023 Part 3). */
|
|
4
|
-
const SINCE = "2.23.0";
|
|
5
|
-
const REMOVED_IN = "3.0.0";
|
|
6
|
-
/** RFC 0023 §5: the module-level service slots, split by direction. */
|
|
7
|
-
const GLOBAL_SERVICE_SETTERS = "global-service-setters";
|
|
8
|
-
const GLOBAL_SERVICE_GETTERS = "global-service-getters";
|
|
9
|
-
const SETTER_REPLACEMENT = "Bind the service on the owning app's container instead — container.instance(key, value) from a service provider. createApp({ inertia }) covers the two Inertia options, and shareInertiaProps(fn, container) the shared props.";
|
|
10
|
-
const GETTER_REPLACEMENT = "Resolve from the container that owns the call — this.make(key) in a controller, job or command, getRequestContainer(ctx).make(key) in middleware, defaultContainer().make(key) elsewhere.";
|
|
11
|
-
/**
|
|
12
|
-
* @internal The deprecation policy's warning format
|
|
13
|
-
* (`contributing/deprecation-policy.md`), keyed per symbol so one deprecated
|
|
14
|
-
* call does not silence its siblings.
|
|
15
|
-
*/
|
|
16
|
-
function warnDeprecated(id, symbol, replacement, versions = {
|
|
17
|
-
since: SINCE,
|
|
18
|
-
removedIn: REMOVED_IN
|
|
19
|
-
}) {
|
|
20
|
-
warnOnce(`${id}:${symbol}`, `[guren] Deprecation (${id}): ${symbol}() is deprecated\n since ${versions.since}, will be removed in ${versions.removedIn}.\n ${replacement}`);
|
|
21
|
-
}
|
|
22
|
-
/** @internal */
|
|
23
|
-
function warnDeprecatedSetter(symbol) {
|
|
24
|
-
warnDeprecated(GLOBAL_SERVICE_SETTERS, symbol, SETTER_REPLACEMENT);
|
|
25
|
-
}
|
|
26
|
-
/** @internal */
|
|
27
|
-
function warnDeprecatedGetter(symbol) {
|
|
28
|
-
warnDeprecated(GLOBAL_SERVICE_GETTERS, symbol, GETTER_REPLACEMENT);
|
|
29
|
-
}
|
|
30
|
-
//#endregion
|
|
31
|
-
export { warnDeprecatedGetter as n, warnDeprecatedSetter as r, warnDeprecated as t };
|
|
@@ -1,186 +0,0 @@
|
|
|
1
|
-
import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
|
|
2
|
-
/**
|
|
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
|
-
*/
|
|
7
|
-
export interface CodegenOptions {
|
|
8
|
-
cwd: string;
|
|
9
|
-
force?: boolean;
|
|
10
|
-
}
|
|
11
|
-
/** What every scaffolder takes; `cwd` names the project, for the same reason. */
|
|
12
|
-
export interface ScaffoldOptions {
|
|
13
|
-
force?: boolean;
|
|
14
|
-
cwd?: string;
|
|
15
|
-
}
|
|
16
|
-
/**
|
|
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.
|
|
21
|
-
*/
|
|
22
|
-
export interface CodegenResult {
|
|
23
|
-
outputPath?: string;
|
|
24
|
-
definitions?: unknown[];
|
|
25
|
-
skipped?: {
|
|
26
|
-
message: string;
|
|
27
|
-
} | null;
|
|
28
|
-
/** Non-fatal diagnostics for whoever asked for the run; the artifact was still written. */
|
|
29
|
-
warnings?: string[];
|
|
30
|
-
}
|
|
31
|
-
/**
|
|
32
|
-
* CLI functions the MCP server wraps, injected at runtime because
|
|
33
|
-
* `@guren/server` cannot depend on `@guren/cli`.
|
|
34
|
-
*/
|
|
35
|
-
export interface GurenCliApi {
|
|
36
|
-
generateContext(opts: {
|
|
37
|
-
cwd: string;
|
|
38
|
-
}): Promise<{
|
|
39
|
-
framework: {
|
|
40
|
-
name: string;
|
|
41
|
-
version: string;
|
|
42
|
-
};
|
|
43
|
-
models: Array<{
|
|
44
|
-
className: string;
|
|
45
|
-
}>;
|
|
46
|
-
routes: Array<unknown>;
|
|
47
|
-
/** Why `routes` is empty, when it is empty because the load failed. */
|
|
48
|
-
routesError?: string;
|
|
49
|
-
pages: string[];
|
|
50
|
-
controllers: string[];
|
|
51
|
-
resources: string[];
|
|
52
|
-
events: string[];
|
|
53
|
-
jobs: string[];
|
|
54
|
-
middleware: string[];
|
|
55
|
-
listeners: string[];
|
|
56
|
-
validators: string[];
|
|
57
|
-
}>;
|
|
58
|
-
renderContextMarkdown(ctx: unknown): string;
|
|
59
|
-
generateEntityContext(entity: string, opts: {
|
|
60
|
-
cwd: string;
|
|
61
|
-
module?: string;
|
|
62
|
-
live?: boolean;
|
|
63
|
-
repo?: string;
|
|
64
|
-
}): Promise<unknown>;
|
|
65
|
-
renderEntityContextMarkdown(ctx: unknown): string;
|
|
66
|
-
runCheck(opts: {
|
|
67
|
-
cwd: string;
|
|
68
|
-
}): Promise<{
|
|
69
|
-
cwd: string;
|
|
70
|
-
checks: Array<{
|
|
71
|
-
key: string;
|
|
72
|
-
title: string;
|
|
73
|
-
status: string;
|
|
74
|
-
message: string;
|
|
75
|
-
suggestion?: string;
|
|
76
|
-
}>;
|
|
77
|
-
passCount: number;
|
|
78
|
-
warnCount: number;
|
|
79
|
-
failCount: number;
|
|
80
|
-
}>;
|
|
81
|
-
/** Absent on a @guren/cli older than `guren gate`; the tool says so instead of throwing. */
|
|
82
|
-
runGate?(opts: {
|
|
83
|
-
cwd: string;
|
|
84
|
-
changed?: boolean;
|
|
85
|
-
deps?: boolean;
|
|
86
|
-
}): Promise<{
|
|
87
|
-
cwd: string;
|
|
88
|
-
ok: boolean;
|
|
89
|
-
changed: boolean;
|
|
90
|
-
stages: Array<{
|
|
91
|
-
name: string;
|
|
92
|
-
status: string;
|
|
93
|
-
durationMs: number;
|
|
94
|
-
findings: string[];
|
|
95
|
-
reason?: string;
|
|
96
|
-
}>;
|
|
97
|
-
}>;
|
|
98
|
-
listModels(opts: {
|
|
99
|
-
appRoot: string;
|
|
100
|
-
}): Promise<Array<{
|
|
101
|
-
className: string;
|
|
102
|
-
filePath: string;
|
|
103
|
-
tableName?: string;
|
|
104
|
-
relationships: Array<{
|
|
105
|
-
name: string;
|
|
106
|
-
type: string;
|
|
107
|
-
relatedModel?: string;
|
|
108
|
-
}>;
|
|
109
|
-
usesAuth: boolean;
|
|
110
|
-
hasSoftDeletes: boolean;
|
|
111
|
-
}>>;
|
|
112
|
-
generateGuidelines(opts: {
|
|
113
|
-
cwd: string;
|
|
114
|
-
}): Promise<string>;
|
|
115
|
-
runDoctor(opts: {
|
|
116
|
-
cwd: string;
|
|
117
|
-
}): Promise<unknown>;
|
|
118
|
-
suggestNextSteps(opts: {
|
|
119
|
-
cwd: string;
|
|
120
|
-
}): Promise<unknown>;
|
|
121
|
-
makeFeature(name: string, opts: ScaffoldOptions & {
|
|
122
|
-
fields?: string;
|
|
123
|
-
withTest?: boolean;
|
|
124
|
-
}): Promise<string[]>;
|
|
125
|
-
makeController(name: string, opts: ScaffoldOptions): Promise<string | string[]>;
|
|
126
|
-
makeModel(name: string, opts: ScaffoldOptions): Promise<string | string[]>;
|
|
127
|
-
makeView(name: string, opts: ScaffoldOptions): Promise<string | string[]>;
|
|
128
|
-
makeTest(name: string, opts: ScaffoldOptions): Promise<string | string[]>;
|
|
129
|
-
makeRoute(name: string, opts: ScaffoldOptions): Promise<string | string[]>;
|
|
130
|
-
generateRouteTypes(opts: CodegenOptions): Promise<CodegenResult | void>;
|
|
131
|
-
generatePageTypes(opts: CodegenOptions): Promise<CodegenResult | void>;
|
|
132
|
-
generateDataTypes(opts: CodegenOptions): Promise<CodegenResult | void>;
|
|
133
|
-
generateChannelTypes(opts: CodegenOptions): Promise<CodegenResult | void>;
|
|
134
|
-
/**
|
|
135
|
-
* Takes the route manifest `generateRouteTypes` returns. `resources` is what
|
|
136
|
-
* `generateDataTypes` extracted — without it every `resource` response hint
|
|
137
|
-
* is "unknown Resource" and the client's `json()` stays untyped.
|
|
138
|
-
*/
|
|
139
|
-
generateApiClientTypes(definitions: unknown[], opts: CodegenOptions & {
|
|
140
|
-
resources?: unknown[];
|
|
141
|
-
}): Promise<CodegenResult | void>;
|
|
142
|
-
/**
|
|
143
|
-
* Agent tools derived from the route manifest (RFC 0016), so it runs after
|
|
144
|
-
* `generateRouteTypes` and `generateDataTypes`. Optional: `@guren/cli` is
|
|
145
|
-
* resolved from the app and an older one simply generates no agent manifest.
|
|
146
|
-
*/
|
|
147
|
-
generateAgentTypes?(definitions: unknown[], opts: CodegenOptions & {
|
|
148
|
-
resources?: unknown[];
|
|
149
|
-
}): Promise<CodegenResult | void>;
|
|
150
|
-
/**
|
|
151
|
-
* Route-dependent context generation in a fresh process. Optional because
|
|
152
|
-
* `@guren/cli` is resolved from the app at runtime and may predate it.
|
|
153
|
-
*/
|
|
154
|
-
createFreshContextApi?: () => Pick<GurenCliApi, 'generateContext' | 'generateEntityContext'>;
|
|
155
|
-
/**
|
|
156
|
-
* Spelled exactly as `@guren/cli` exports it — this interface describes that
|
|
157
|
-
* module namespace, so a camelCase name here would read `undefined` off every
|
|
158
|
-
* real CLI. Optional for the runtime-resolution reason above, and read for it:
|
|
159
|
-
* an older CLI emits routes with no `agent` field, which looks like no tools.
|
|
160
|
-
*/
|
|
161
|
-
CONTEXT_ROUTE_FEATURES?: readonly string[];
|
|
162
|
-
/**
|
|
163
|
-
* Every route as a context route, without the rest of the project context.
|
|
164
|
-
* Optional; `guren_agent_surface` falls back to `generateContext`.
|
|
165
|
-
*/
|
|
166
|
-
loadContextRoutes?(cwd: string, routesFile?: string, loadErrors?: string[]): Promise<unknown[]>;
|
|
167
|
-
/** The OKF docs relation graph (RFC 0005). Optional, like the above. */
|
|
168
|
-
buildDocsGraphReport?(options: {
|
|
169
|
-
cwd?: string;
|
|
170
|
-
entity?: string;
|
|
171
|
-
path?: string;
|
|
172
|
-
}): Promise<unknown>;
|
|
173
|
-
renderDocsGraphMarkdown?(report: unknown): string;
|
|
174
|
-
}
|
|
175
|
-
export interface CreateMcpServerOptions {
|
|
176
|
-
cwd: string;
|
|
177
|
-
cli: GurenCliApi;
|
|
178
|
-
version?: string;
|
|
179
|
-
}
|
|
180
|
-
/**
|
|
181
|
-
* @deprecated Serves only the 2025-era MCP protocol. The Dev MCP endpoint is now
|
|
182
|
-
* built by `createDevMcpHandler` from `@guren/cli` (RFC 0028); this is removed in
|
|
183
|
-
* the next minor.
|
|
184
|
-
* @experimental
|
|
185
|
-
*/
|
|
186
|
-
export declare function createMcpServer(options: CreateMcpServerOptions): McpServer;
|