@guren/server 2.23.0 → 2.23.2

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.
@@ -17,10 +17,10 @@ function resolveOptional(container, key) {
17
17
  let globalDriver = null;
18
18
  /**
19
19
  * Pins the driver `Job.dispatch()` sends through, ahead of the container's
20
- * `queue` manager. An explicit override rather than a fallback: `@guren/testing`'s
21
- * `fakeQueue()` and the tutorial's queue test inject through it (RFC 0023 §3).
22
- * The pin survives its deprecation window because nothing else expresses it; it
23
- * goes with this setter in Part 3.
20
+ * `queue` manager: an override rather than a fallback (RFC 0023 §3). A test
21
+ * needs no pin: a `QueueManager` wrapping `fakeQueue().getDriver()`, bound with
22
+ * `app.container.fake('queue', manager)`, is what `Job.dispatch()` resolves.
23
+ * The pin goes with this setter in Part 3.
24
24
  * @deprecated since 2.23.0, removed in 3.0.0 (RFC 0023). Bind the manager on the
25
25
  * app's container — `QueueServiceProvider` already does — and inject a fake with
26
26
  * `app.container.fake('queue', manager)`.
@@ -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-BdJnaq1O.js";
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-DVfG2vgN.js";
2
2
  export { BroadcastManager, Channel, MemoryDriver, PresenceChannel, PrivateChannel, RedisDriver, createBroadcastManager, createTypedBroadcaster, getBroadcastManager, setBroadcastManager };
@@ -1,6 +1,6 @@
1
1
  import { a as parseRequestPayload } from "./request-CLOYytGP.js";
2
2
  import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-Chbrul_m.js";
3
- import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-B5BXqaIH.js";
3
+ import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-W2fH-GID.js";
4
4
  import { c as randomHex } from "./Random-S0OvCuR8.js";
5
5
  //#region src/broadcasting/channels/Channel.ts
6
6
  var Channel = class {
@@ -1,2 +1,2 @@
1
- import { a as RedisStore, i as FileStore, n as createCacheManager, o as MemoryStore, r as TaggedCache, t as CacheManager } from "../cache-DikxP7Bk.js";
1
+ import { a as RedisStore, i as FileStore, n as createCacheManager, o as MemoryStore, r as TaggedCache, t as CacheManager } from "../cache-93n2PCnB.js";
2
2
  export { CacheManager, FileStore, MemoryStore, RedisStore, TaggedCache, createCacheManager };
@@ -1,5 +1,5 @@
1
1
  import { r as isPromiseLike } from "./Logger-DWXdtLSJ.js";
2
- import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-B5BXqaIH.js";
2
+ import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-W2fH-GID.js";
3
3
  import { createHash } from "node:crypto";
4
4
  import { dirname, join } from "node:path";
5
5
  import { mkdir, readFile, readdir, rm, unlink, writeFile } from "node:fs/promises";
@@ -1,5 +1,5 @@
1
1
  import type { Container } from '../container/index.js';
2
- import type { OutputInterface, CommandInstance } from './types.js';
2
+ import type { OutputInterface, CommandInstance, ConsoleHandleOptions } from './types.js';
3
3
  import { Input } from './Input.js';
4
4
  import * as readline from 'readline';
5
5
  /** Base class for console commands. */
@@ -57,10 +57,10 @@ export declare abstract class Command implements CommandInstance {
57
57
  protected createReadline(): readline.Interface;
58
58
  withProgress<T>(items: T[], callback: (item: T, index: number) => Promise<void>): Promise<void>;
59
59
  protected kernel?: {
60
- handle(argv: string[]): Promise<number>;
60
+ handle(argv: string[], options?: ConsoleHandleOptions): Promise<number>;
61
61
  };
62
62
  setKernel(kernel: {
63
- handle(argv: string[]): Promise<number>;
63
+ handle(argv: string[], options?: ConsoleHandleOptions): Promise<number>;
64
64
  }): void;
65
65
  call(command: string, args?: string[]): Promise<number>;
66
66
  protected resolve<T>(key: string): T;
@@ -1,5 +1,5 @@
1
1
  import type { Container } from '../container/index.js';
2
- import type { CommandClass, ConsoleKernelOptions, OutputInterface } from './types.js';
2
+ import type { CommandClass, ConsoleHandleOptions, ConsoleKernelOptions, OutputInterface } from './types.js';
3
3
  /** Console kernel for managing and executing commands. */
4
4
  export declare class ConsoleKernel {
5
5
  protected commands: Map<string, CommandClass>;
@@ -13,7 +13,7 @@ export declare class ConsoleKernel {
13
13
  hasCommand(name: string): boolean;
14
14
  setOutput(output: OutputInterface): this;
15
15
  getOutput(): OutputInterface;
16
- handle(argv?: string[]): Promise<number>;
16
+ handle(argv?: string[], options?: ConsoleHandleOptions): Promise<number>;
17
17
  protected runCommand(CommandClass: CommandClass, args: string[]): Promise<number>;
18
18
  protected showHelp(): void;
19
19
  protected showCommandHelp(commandName: string): void;
@@ -1,4 +1,4 @@
1
- export type { ArgumentDefinition, OptionDefinition, ParsedSignature, CommandClass, CommandInstance, ConsoleKernelOptions, OutputInterface, InputInterface, ScheduledCommand, PromptInterface, ProgressInterface, } from './types.js';
1
+ export type { ArgumentDefinition, OptionDefinition, ParsedSignature, CommandClass, CommandInstance, ConsoleKernelOptions, ConsoleHandleOptions, OutputInterface, InputInterface, ScheduledCommand, PromptInterface, ProgressInterface, } from './types.js';
2
2
  export { Command } from './Command.js';
3
3
  export { Input, parseSignature } from './Input.js';
4
4
  export { Output, BufferedOutput } from './Output.js';
@@ -28,10 +28,18 @@ export interface CommandInstance {
28
28
  setInput(argv: string[]): void;
29
29
  setOutput(output: OutputInterface): void;
30
30
  setKernel(kernel: {
31
- handle(argv: string[]): Promise<number>;
31
+ handle(argv: string[], options?: ConsoleHandleOptions): Promise<number>;
32
32
  }): void;
33
33
  run(): Promise<number>;
34
34
  }
35
+ export interface ConsoleHandleOptions {
36
+ /**
37
+ * Whether `--help` / `-h` among the arguments prints the command's help instead of
38
+ * running it (default `true`). `call()` passes `false`: arguments assembled by code
39
+ * may carry either token as a value, and a silent call would report the skip as success.
40
+ */
41
+ helpFlags?: boolean;
42
+ }
35
43
  export interface OutputInterface {
36
44
  info(message: string): void;
37
45
  error(message: string): void;
@@ -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-C86rS63h.js";
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-CaJKZ2qk.js";
2
2
  export { ApplicationShutdown, ApplicationStarted, Event, EventManager, JobFailed, JobProcessed, Listener, RequestFinished, RequestReceived, UserAuthenticated, UserLoggedOut, createEventManager, createQueueEventDispatcher };
@@ -1,4 +1,4 @@
1
- import { d as resolveQueueDriver, l as registerJob, t as Job } from "./Job-BxioDEcS.js";
1
+ import { d as resolveQueueDriver, l as registerJob, t as Job } from "./Job-BVvaY-7p.js";
2
2
  import { t as warnOnce } from "./warn-once-p-IlMjra.js";
3
3
  //#region src/events/Event.ts
4
4
  /** Base class for all application events. */
@@ -58,6 +58,7 @@ function getRegistry() {
58
58
  * instead, dropping every timer with it, so `--hot` is the only mode that leaks.
59
59
  * Exported so callers can skip building the `Error` whose stack identifies them
60
60
  * — capturing one formats the whole stack into a string.
61
+ * Twin of `packages/orm/src/hot-reload-runtime.ts` — keep the two in step.
61
62
  */
62
63
  function isHotReloadRuntime() {
63
64
  return typeof process !== "undefined" && Array.isArray(process.execArgv) && process.execArgv.includes("--hot");
@@ -18,6 +18,7 @@ export interface HotDisposableClaim {
18
18
  * instead, dropping every timer with it, so `--hot` is the only mode that leaks.
19
19
  * Exported so callers can skip building the `Error` whose stack identifies them
20
20
  * — capturing one formats the whole stack into a string.
21
+ * Twin of `packages/orm/src/hot-reload-runtime.ts` — keep the two in step.
21
22
  */
22
23
  export declare function isHotReloadRuntime(): boolean;
23
24
  /**
package/dist/index.js CHANGED
@@ -8,33 +8,33 @@ import { PATH_PARAM_PATTERN, extractPathParamNames } from "./internal/route-path
8
8
  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";
9
9
  import { n as detectServerlessRuntime, t as SERVERLESS_RUNTIME_LABELS } from "./serverless-D96rJb6x.js";
10
10
  import { $ as SessionGuard, A as verifyOAuthState, B as createBearerTokenMiddleware, C as createGoogleOAuthProviderConfig, D as fetchOAuthUserProfile, E as exchangeOAuthCode, F as DEFAULT_PROVIDER, G as parseApiToken, H as getApiTokenOrFail, I as TokenGuard, J as revokeApiToken, K as readBearerToken, L as API_TOKEN_KEY, M as isAppRelativePath, N as normalizeRedirectTarget, O as parseOAuthRedirectUrl, P as AuthManager, Q as verifyApiToken, R as MemoryApiTokenStore, S as createGitHubOAuthProviderConfig, T as createOAuthState, U as getUserApiTokens, V as getApiToken, W as hasBearerHeader, X as tokenCanAll, Y as tokenCan, Z as tokenCanAny, _ as OAUTH_SESSION_BINDING_KEY, _t as getSessionFromContext, a as isEmailVerified, b as buildOAuthRedirectUrl, c as verifyEmailToken, ct as DefaultHasher, d as completePasswordReset, dt as BaseUserProvider, f as createPasswordResetToken, ft as installAgentPrincipal, g as MemoryOAuthStateStore, gt as defaultCookieSecure, h as AuthenticatableModel, ht as createSessionMiddleware, i as createEmailVerificationToken, j as hostMatchesAllowlist, k as sanitizeOAuthRedirect, l as MemoryPasswordResetStore, lt as NodeHasher, m as verifyPasswordResetToken, mt as MemorySessionStore, n as buildVerificationUrl, o as parseVerificationUrl, p as parsePasswordResetUrl, pt as readAgentPrincipal, q as revokeAllApiTokens, r as completeEmailVerification, s as requireVerifiedEmail, st as ModelUserProvider, t as MemoryEmailVerificationStore, u as buildPasswordResetUrl, ut as ScryptHasher, v as OAuthManager, w as createOAuthManager, x as createDiscordOAuthProviderConfig, y as buildOAuthAuthorizeUrl, z as createApiToken } from "./auth-D_W1cJp3.js";
11
- import { _ as parseImportMap, c as isViteProduction, d as startViteDevServer, g as DEFAULT_DEV_STYLES_ENTRY, 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-B8720V7w.js";
12
- import { a as getJob, d as resolveQueueDriver, f as setQueueDriver, l as registerJob, n as clearJobRegistry, o as getQueueDriver, p as resolveOptional, r as clearQueueDriver, s as getRegisteredJobs, t as Job, u as resolveJobName } from "./Job-BxioDEcS.js";
11
+ import { _ as parseImportMap, c as isViteProduction, d as startViteDevServer, g as DEFAULT_DEV_STYLES_ENTRY, 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-2p0IRIcy.js";
12
+ import { a as getJob, d as resolveQueueDriver, f as setQueueDriver, l as registerJob, n as clearJobRegistry, o as getQueueDriver, p as resolveOptional, r as clearQueueDriver, s as getRegisteredJobs, t as Job, u as resolveJobName } from "./Job-BVvaY-7p.js";
13
13
  import { t as warnOnce } from "./warn-once-p-IlMjra.js";
14
14
  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-Chbrul_m.js";
15
15
  import { n as ProviderManager, r as ServiceProvider } from "./loopback-guard-DT9gHF0F.js";
16
16
  import { o as AuthenticationException, r as getAuthContext, t as AUTH_CONTEXT_KEY } from "./context-af2n5abO.js";
17
17
  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";
18
18
  import { a as runInRequestScope, i as keepAlive, n as filterSensitiveData, t as Logger } from "./Logger-DWXdtLSJ.js";
19
- import { a as RedisStore, i as FileStore, n as createCacheManager, o as MemoryStore, r as TaggedCache, s as resolveLazyRedisClient, t as CacheManager } from "./cache-DikxP7Bk.js";
19
+ import { a as RedisStore, i as FileStore, n as createCacheManager, o as MemoryStore, r as TaggedCache, s as resolveLazyRedisClient, t as CacheManager } from "./cache-93n2PCnB.js";
20
20
  import { n as createRedisClient, r as RedisSessionStore } from "./client-C5Wj9P9o.js";
21
21
  import { r as isMcpEndpointEnabled } from "./endpoint-Dsw3Acvq.js";
22
- import { n as isHotReloadRuntime, r as matchingOpenParen, t as claimHotDisposable } from "./hot-disposables-B5BXqaIH.js";
22
+ import { n as isHotReloadRuntime, r as matchingOpenParen, t as claimHotDisposable } from "./hot-disposables-W2fH-GID.js";
23
23
  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-DRo1g0AN.js";
24
24
  import { r as isDocsViewerEnabled } from "./endpoint-BXipU2Jj.js";
25
25
  import { t as jsx_runtime_exports } from "./jsx-runtime.js";
26
26
  import { readObjectSchema, toJsonSchema } from "./internal/zod-json-schema.js";
27
- 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-C86rS63h.js";
28
- 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-CE3U7uyg.js";
29
- 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-B3x_RKnB.js";
30
- 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-CmxO2Ttx.js";
27
+ 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-CaJKZ2qk.js";
28
+ 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-BLid0Y6M.js";
29
+ 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-IdJjqbyJ.js";
30
+ 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-zMjQimaJ.js";
31
31
  import { a as DailyFileChannel, c as matchDailyFileDate, d as LOG_LEVEL_PRIORITY, i as setLogManager, l as FileChannel, n as createLogManager, o as dailyFileDateStamp, r as getLogManager, s as dailyFilePath, t as LogManager, u as ConsoleChannel } from "./logging-CXotojgW.js";
32
- 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-BdJnaq1O.js";
32
+ 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-DVfG2vgN.js";
33
33
  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";
34
34
  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-BRjZnshr.js";
35
35
  import { a as LocalDriver, i as S3Driver, n as createStorageManager, r as MemoryDriver$2, t as StorageManager } from "./storage-6HLaUf9j.js";
36
36
  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";
37
- 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-DudNXGnh.js";
37
+ 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";
38
38
  import { Hono } from "hono";
39
39
  import { deleteCookie, getCookie } from "hono/cookie";
40
40
  import { createCipheriv, createDecipheriv, randomBytes } from "node:crypto";
@@ -3597,6 +3597,7 @@ var Application = class {
3597
3597
  port: boundPort,
3598
3598
  assetsUrl: resolvedAssetsUrl ?? "http://localhost:5173"
3599
3599
  });
3600
+ else if (typeof process !== "undefined" && process.env.NODE_ENV === "production") console.info(`[guren] Listening on http://${formatHostPort(boundHostname, boundPort)}`);
3600
3601
  return address;
3601
3602
  }
3602
3603
  /**
@@ -7238,7 +7239,7 @@ var Command = class {
7238
7239
  }
7239
7240
  async call(command, args = []) {
7240
7241
  if (!this.kernel) throw new Error("Kernel not set. Cannot call other commands.");
7241
- return this.kernel.handle([command, ...args]);
7242
+ return this.kernel.handle([command, ...args], { helpFlags: false });
7242
7243
  }
7243
7244
  resolve(key) {
7244
7245
  if (!this.container) throw new Error("Container not available");
@@ -7409,6 +7410,16 @@ var BufferedOutput = class extends Output {
7409
7410
  };
7410
7411
  //#endregion
7411
7412
  //#region src/console/ConsoleKernel.ts
7413
+ /**
7414
+ * `--help` / `-h` anywhere in argv, even where `Input` would read it as an option's
7415
+ * value: a command that ignored the flag would otherwise run for real. `Input` has no
7416
+ * `--` terminator, so neither does this. A signature declaring either name keeps it.
7417
+ */
7418
+ function requestsHelp(signature, args) {
7419
+ const claimsLong = signature.options.some((opt) => opt.name === "help");
7420
+ const claimsShort = signature.options.some((opt) => opt.shortcut === "h" || opt.name === "h");
7421
+ return args.some((arg) => arg === "--help" && !claimsLong || arg === "-h" && !claimsShort);
7422
+ }
7412
7423
  /** Past the longest label, but never narrower than `min`. */
7413
7424
  function helpColumn(labels, min) {
7414
7425
  return Math.max(min, ...labels.map((label) => label.length + 2));
@@ -7452,7 +7463,7 @@ var ConsoleKernel = class {
7452
7463
  getOutput() {
7453
7464
  return this.output;
7454
7465
  }
7455
- async handle(argv = process.argv.slice(2)) {
7466
+ async handle(argv = process.argv.slice(2), options = {}) {
7456
7467
  const [commandName, ...args] = argv;
7457
7468
  if (!commandName) {
7458
7469
  this.showHelp();
@@ -7474,6 +7485,10 @@ var ConsoleKernel = class {
7474
7485
  this.suggestCommands(commandName);
7475
7486
  return 1;
7476
7487
  }
7488
+ if (options.helpFlags !== false && requestsHelp(parseSignature(CommandClass.signature), args)) {
7489
+ this.showCommandHelp(commandName);
7490
+ return 0;
7491
+ }
7477
7492
  return this.runCommand(CommandClass, args);
7478
7493
  }
7479
7494
  async runCommand(CommandClass, args) {
@@ -7572,7 +7587,7 @@ var ConsoleKernel = class {
7572
7587
  async call(commandName, args = [], silent = false) {
7573
7588
  const originalOutput = this.output;
7574
7589
  if (silent) this.output = new BufferedOutput();
7575
- const result = await this.handle([commandName, ...args]);
7590
+ const result = await this.handle([commandName, ...args], { helpFlags: false });
7576
7591
  if (silent) this.output = originalOutput;
7577
7592
  return result;
7578
7593
  }
@@ -1,5 +1,5 @@
1
1
  import { n as detectServerlessRuntime } from "../serverless-D96rJb6x.js";
2
- import { a as getJob } from "../Job-BxioDEcS.js";
2
+ import { a as getJob } from "../Job-BVvaY-7p.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. */
@@ -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-CmxO2Ttx.js";
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-zMjQimaJ.js";
2
2
  export { LogTransport, Mail, MailManager, MemoryTransport, ResendTransport, SmtpTransport, createMailManager, getMailManager, mail, setMailManager };
@@ -1,4 +1,4 @@
1
- import { c as pinnedQueueDriver, d as resolveQueueDriver, i as enqueueJob, l as registerJob, p as resolveOptional, t as Job } from "./Job-BxioDEcS.js";
1
+ import { c as pinnedQueueDriver, d as resolveQueueDriver, i as enqueueJob, l as registerJob, p as resolveOptional, t as Job } from "./Job-BVvaY-7p.js";
2
2
  import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-Chbrul_m.js";
3
3
  import { t as parseMailAddress } from "./address-D0Iq-XIH.js";
4
4
  import nodemailer from "nodemailer";
@@ -146,8 +146,8 @@ export declare class Controller {
146
146
  * data is emitted verbatim, so sanitize user-supplied URLs upstream.
147
147
  */
148
148
  protected view<P>(component: FC<P>, props: P, options?: ViewOptions): Promise<Response>;
149
- protected inertia<TPage extends InertiaPageContractLike>(page: TPage, props: InertiaPageProps<TPage>, options?: InertiaResponseOptions): Promise<InertiaResponse<InertiaPageComponent<TPage>, InertiaPageProps<TPage> & ResolvedSharedInertiaProps>>;
150
149
  protected inertia<Component extends string, Props extends DefaultInertiaProps>(component: Component, props: Props, options?: InertiaResponseOptions): Promise<InertiaResponse<Component, Props & ResolvedSharedInertiaProps>>;
150
+ protected inertia<TPage extends InertiaPageContractLike>(page: TPage, props: InertiaPageProps<TPage>, options?: InertiaResponseOptions): Promise<InertiaResponse<InertiaPageComponent<TPage>, InertiaPageProps<TPage> & ResolvedSharedInertiaProps>>;
151
151
  /**
152
152
  * Locale for the current request: the request-scoped `locale` context
153
153
  * variable wins over the app-wide i18n locale. Falls back to `'en'`.
@@ -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-CE3U7uyg.js";
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-BLid0Y6M.js";
2
2
  export { DatabaseChannel, MailChannel, MemoryChannel, Notification, NotificationManager, SlackChannel, clearNotificationRegistry, createNotificationManager, getNotification, getNotificationManager, registerNotification, resolveNotifiableType, setNotificationManager };
@@ -1,4 +1,4 @@
1
- import { l as registerJob, t as Job } from "./Job-BxioDEcS.js";
1
+ import { l as registerJob, t as Job } from "./Job-BVvaY-7p.js";
2
2
  import { h as warnDeprecatedSetter, i as bindAmbient, m as warnDeprecatedGetter, n as ambientBinding } from "./default-application-Chbrul_m.js";
3
3
  import { t as parseMailAddress } from "./address-D0Iq-XIH.js";
4
4
  //#region src/notifications/Notification.ts
@@ -3,10 +3,10 @@ import type { ServiceBindings } from '../container/bindings.js';
3
3
  import type { ContainerLike } from '../container/types.js';
4
4
  /**
5
5
  * Pins the driver `Job.dispatch()` sends through, ahead of the container's
6
- * `queue` manager. An explicit override rather than a fallback: `@guren/testing`'s
7
- * `fakeQueue()` and the tutorial's queue test inject through it (RFC 0023 §3).
8
- * The pin survives its deprecation window because nothing else expresses it; it
9
- * goes with this setter in Part 3.
6
+ * `queue` manager: an override rather than a fallback (RFC 0023 §3). A test
7
+ * needs no pin: a `QueueManager` wrapping `fakeQueue().getDriver()`, bound with
8
+ * `app.container.fake('queue', manager)`, is what `Job.dispatch()` resolves.
9
+ * The pin goes with this setter in Part 3.
10
10
  * @deprecated since 2.23.0, removed in 3.0.0 (RFC 0023). Bind the manager on the
11
11
  * app's container — `QueueServiceProvider` already does — and inject a fake with
12
12
  * `app.container.fake('queue', manager)`.
@@ -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-BxioDEcS.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-B3x_RKnB.js";
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-BVvaY-7p.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-IdJjqbyJ.js";
3
3
  export { FailedJobReporter, Job, MemoryDriver, QueueManager, RedisDriver, SqsDriver, SyncDriver, Worker, clearJobRegistry, clearQueueDriver, createQueueManager, createSqsAdapter, getJob, getQueueDriver, getRegisteredJobs, processJob, registerJob, resolveJobName, resolveQueueDriver, setQueueDriver };
@@ -1,4 +1,4 @@
1
- import { a as getJob, i as enqueueJob } from "./Job-BxioDEcS.js";
1
+ import { a as getJob, i as enqueueJob } from "./Job-BVvaY-7p.js";
2
2
  //#region src/queue/drivers/MemoryDriver.ts
3
3
  /** In-memory queue driver for development and testing. */
4
4
  var MemoryDriver = class {
@@ -1,5 +1,5 @@
1
1
  import { n as trimTrailingSlashes } from "../trim-slashes-BLY9hKAa.js";
2
- import { _ as parseImportMap, 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-B8720V7w.js";
2
+ import { _ as parseImportMap, 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-2p0IRIcy.js";
3
3
  import { n as hash } from "../Hash-D2DFd8xX.js";
4
4
  import { createRequire } from "node:module";
5
5
  import { dirname, extname, join, resolve, sep } from "node:path";
@@ -1,2 +1,2 @@
1
- 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-DudNXGnh.js";
1
+ 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";
2
2
  export { MemorySchedulerLock, PendingSchedule, Schedule, ScheduledTask, Scheduler, createScheduler, getNextOccurrence, getNextOccurrences, isDue, isDueInTimezone, matchesCron, parseCron, toTimezone };
@@ -1,5 +1,5 @@
1
1
  import { t as warnOnce } from "./warn-once-p-IlMjra.js";
2
- import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-B5BXqaIH.js";
2
+ import { n as isHotReloadRuntime, t as claimHotDisposable } from "./hot-disposables-W2fH-GID.js";
3
3
  //#region src/scheduling/MemorySchedulerLock.ts
4
4
  /**
5
5
  * Single-process `SchedulerLock`: one server, or tests. Two processes each
@@ -34,7 +34,7 @@ function parseImportMap(value, options = {}) {
34
34
  const DEFAULT_DEV_STYLES_ENTRY = "/resources/css/app.css";
35
35
  //#endregion
36
36
  //#region package.json
37
- var version = "2.23.0";
37
+ var version = "2.23.2";
38
38
  //#endregion
39
39
  //#region src/http/dev-banner.ts
40
40
  figlet.parseFont("Standard", standard);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@guren/server",
3
- "version": "2.23.0",
3
+ "version": "2.23.2",
4
4
  "type": "module",
5
5
  "sideEffects": false,
6
6
  "license": "MIT",
@@ -142,7 +142,7 @@
142
142
  "test": "bun test"
143
143
  },
144
144
  "dependencies": {
145
- "@guren/orm": "^2.9.0",
145
+ "@guren/orm": "^2.10.1",
146
146
  "@modelcontextprotocol/sdk": "^1.30.0",
147
147
  "chalk": "^5.3.0",
148
148
  "consola": "^3.4.2",