@guren/server 2.20.0 → 2.21.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,2 +1,2 @@
1
- import { $ as buildTokenUrl, A as verifyOAuthState, B as getApiToken, C as createGoogleOAuthProviderConfig, D as fetchOAuthUserProfile, E as exchangeOAuthCode, F as TokenGuard, G as readBearerToken, H as getUserApiTokens, I as API_TOKEN_KEY, J as tokenCan, K as revokeAllApiTokens, L as MemoryApiTokenStore, O as parseOAuthRedirectUrl, P as AuthManager, Q as SessionGuard, R as createApiToken, S as createGitHubOAuthProviderConfig, T as createOAuthState, V as getApiTokenOrFail, W as parseApiToken, X as tokenCanAny, Y as tokenCanAll, Z as verifyApiToken, _ as OAUTH_SESSION_BINDING_KEY, a as isEmailVerified, at as secureStringCompare, b as buildOAuthRedirectUrl, c as verifyEmailToken, ct as NodeHasher, d as completePasswordReset, dt as BaseUserProvider, et as generateId, f as createPasswordResetToken, g as MemoryOAuthStateStore, h as AuthenticatableModel, i as createEmailVerificationToken, it as secureCompare, k as sanitizeOAuthRedirect, l as MemoryPasswordResetStore, lt as ScryptHasher, m as verifyPasswordResetToken, n as buildVerificationUrl, nt as hashToken, o as parseVerificationUrl, ot as ModelUserProvider, p as parsePasswordResetUrl, q as revokeApiToken, r as completeEmailVerification, rt as parseTokenUrl, s as requireVerifiedEmail, t as MemoryEmailVerificationStore, tt as generateToken, u as buildPasswordResetUrl, v as OAuthManager, w as createOAuthManager, x as createDiscordOAuthProviderConfig, y as buildOAuthAuthorizeUrl, z as createBearerTokenMiddleware } from "../auth-BXcHQwHf.js";
1
+ import { $ as buildTokenUrl, A as verifyOAuthState, B as getApiToken, C as createGoogleOAuthProviderConfig, D as fetchOAuthUserProfile, E as exchangeOAuthCode, F as TokenGuard, G as readBearerToken, H as getUserApiTokens, I as API_TOKEN_KEY, J as tokenCan, K as revokeAllApiTokens, L as MemoryApiTokenStore, O as parseOAuthRedirectUrl, P as AuthManager, Q as SessionGuard, R as createApiToken, S as createGitHubOAuthProviderConfig, T as createOAuthState, V as getApiTokenOrFail, W as parseApiToken, X as tokenCanAny, Y as tokenCanAll, Z as verifyApiToken, _ as OAUTH_SESSION_BINDING_KEY, a as isEmailVerified, at as secureStringCompare, b as buildOAuthRedirectUrl, c as verifyEmailToken, ct as NodeHasher, d as completePasswordReset, dt as BaseUserProvider, et as generateId, f as createPasswordResetToken, g as MemoryOAuthStateStore, h as AuthenticatableModel, i as createEmailVerificationToken, it as secureCompare, k as sanitizeOAuthRedirect, l as MemoryPasswordResetStore, lt as ScryptHasher, m as verifyPasswordResetToken, n as buildVerificationUrl, nt as hashToken, o as parseVerificationUrl, ot as ModelUserProvider, p as parsePasswordResetUrl, q as revokeApiToken, r as completeEmailVerification, rt as parseTokenUrl, s as requireVerifiedEmail, t as MemoryEmailVerificationStore, tt as generateToken, u as buildPasswordResetUrl, v as OAuthManager, w as createOAuthManager, x as createDiscordOAuthProviderConfig, y as buildOAuthAuthorizeUrl, z as createBearerTokenMiddleware } from "../auth-CjE2oO50.js";
2
2
  export { API_TOKEN_KEY, AuthManager, AuthenticatableModel, BaseUserProvider, MemoryApiTokenStore, MemoryEmailVerificationStore, MemoryOAuthStateStore, MemoryPasswordResetStore, ModelUserProvider, NodeHasher, OAUTH_SESSION_BINDING_KEY, OAuthManager, ScryptHasher, SessionGuard, TokenGuard, buildOAuthAuthorizeUrl, buildOAuthRedirectUrl, buildPasswordResetUrl, buildTokenUrl, buildVerificationUrl, completeEmailVerification, completePasswordReset, createApiToken, createBearerTokenMiddleware, createDiscordOAuthProviderConfig, createEmailVerificationToken, createGitHubOAuthProviderConfig, createGoogleOAuthProviderConfig, createOAuthManager, createOAuthState, createPasswordResetToken, exchangeOAuthCode, fetchOAuthUserProfile, generateId, generateToken, getApiToken, getApiTokenOrFail, getUserApiTokens, hashToken, isEmailVerified, parseApiToken, parseOAuthRedirectUrl, parsePasswordResetUrl, parseTokenUrl, parseVerificationUrl, readBearerToken, requireVerifiedEmail, revokeAllApiTokens, revokeApiToken, sanitizeOAuthRedirect, secureCompare, secureStringCompare, tokenCan, tokenCanAll, tokenCanAny, verifyApiToken, verifyEmailToken, verifyOAuthState, verifyPasswordResetToken };
@@ -9,6 +9,7 @@ import type { PasswordHasher } from './PasswordHasher.js';
9
9
  export declare class DefaultHasher implements PasswordHasher {
10
10
  private readonly bun;
11
11
  private readonly node;
12
+ private readonly testing;
12
13
  constructor();
13
14
  hash(plain: string): Promise<string>;
14
15
  verify(hashed: string, plain: string): Promise<boolean>;
@@ -637,6 +637,21 @@ var NodeHasher = class {
637
637
  //#endregion
638
638
  //#region src/auth/password/DefaultHasher.ts
639
639
  /**
640
+ * Parameters used while `GUREN_TESTING` is set (by `TestApp` and `guren tool:call --as`).
641
+ * The production defaults cost ~136 ms per hash (Bun 1.3, Apple M-series), the whole
642
+ * 180 ms of every test creating a user; these measure ~1 ms. Verification reads the
643
+ * parameters the hash carries, so a hash written here verifies at that cost anywhere.
644
+ */
645
+ const TESTING_ARGON2_OPTIONS = {
646
+ memoryCost: 1024,
647
+ timeCost: 1
648
+ };
649
+ const TESTING_SCRYPT_COST = 1024;
650
+ /** Read per call, not at construction: the provider owning this hasher is built at boot, and `TestApp` may set the variable later. */
651
+ function testingHashCost() {
652
+ return typeof process !== "undefined" && Boolean(process.env.GUREN_TESTING);
653
+ }
654
+ /**
640
655
  * Runtime-detecting password hasher behind `Hash`, the default for
641
656
  * `AuthenticatableModel` and `ModelUserProvider`: `Bun.password` on Bun (Argon2id,
642
657
  * despite `ScryptHasher`'s name), `crypto.scrypt` otherwise. **Verification routes
@@ -646,18 +661,22 @@ var NodeHasher = class {
646
661
  var DefaultHasher = class {
647
662
  bun;
648
663
  node;
664
+ testing;
649
665
  constructor() {
650
- this.bun = typeof Bun !== "undefined" ? new ScryptHasher() : null;
666
+ const onBun = typeof Bun !== "undefined";
667
+ this.bun = onBun ? new ScryptHasher() : null;
651
668
  this.node = new NodeHasher();
669
+ this.testing = onBun ? new ScryptHasher(TESTING_ARGON2_OPTIONS) : new NodeHasher({ cost: TESTING_SCRYPT_COST });
652
670
  }
653
671
  hash(plain) {
654
- return (this.bun ?? this.node).hash(plain);
672
+ return (testingHashCost() ? this.testing : this.bun ?? this.node).hash(plain);
655
673
  }
656
674
  verify(hashed, plain) {
657
675
  return this.delegateFor(hashed).verify(hashed, plain);
658
676
  }
659
677
  needsRehash(hashed) {
660
678
  if (hashed.startsWith("$scrypt$") !== (this.bun === null)) return true;
679
+ if (!this.testing.needsRehash(hashed)) return !testingHashCost();
661
680
  return this.delegateFor(hashed).needsRehash(hashed);
662
681
  }
663
682
  delegateFor(hashed) {
@@ -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-DUhlolkJ.js";
1
+ import { a as RedisStore, i as FileStore, n as createCacheManager, o as MemoryStore, r as TaggedCache, t as CacheManager } from "../cache-thXRnaju.js";
2
2
  export { CacheManager, FileStore, MemoryStore, RedisStore, TaggedCache, createCacheManager };
@@ -1,6 +1,7 @@
1
1
  import { Hono } from 'hono';
2
2
  import type { MiddlewareHandler, ExecutionContext } from 'hono';
3
3
  import { Router } from '../mvc/Router.js';
4
+ import { type PrototypeFixtureLoader } from '../mvc/prototype.js';
4
5
  import { Container, type GurenModule } from '../container/index.js';
5
6
  import { type ServiceProviderConstructor } from '../container/ServiceProvider.js';
6
7
  import { AuthManager } from '../auth/AuthManager.js';
@@ -67,6 +68,12 @@ export interface ApplicationOptions {
67
68
  readonly securityHeaders?: SecurityHeadersOptions | false;
68
69
  /** DNS rebinding protection. Off unless configured; the template configures it. */
69
70
  readonly hostAuthorization?: HostAuthorizationOptions | false;
71
+ /**
72
+ * The fixture module routes registered with the `prototype` handler answer
73
+ * from (RFC 0021): `() => import('../resources/js/prototype/index.js')`.
74
+ * Loaded at boot only when such a route exists.
75
+ */
76
+ readonly prototype?: PrototypeFixtureLoader;
70
77
  }
71
78
  export interface I18nPluginOptions {
72
79
  /** Detection only resolves to one of these; all are preloaded during `boot()`. */
@@ -164,6 +171,14 @@ export declare class Application {
164
171
  /** Matched by exact path — see {@link declareCookielessAuthPath}. */
165
172
  getCookielessAuthPaths(): ReadonlySet<string>;
166
173
  mountRoutes(): Promise<void>;
174
+ /**
175
+ * Every failure here is one a request would otherwise surface as a 500:
176
+ * an unnamed prototype route cannot be looked up, a named one the fixture
177
+ * does not answer, no loader to answer from at all. Process-shared fixture
178
+ * state is a developer's own `bun run dev`, not a deployment, hence the
179
+ * production refusal; `GUREN_PROTOTYPE_ROUTES=1` overrides it deliberately.
180
+ */
181
+ private preparePrototypeRoutes;
167
182
  use(path: string, ...middleware: MiddlewareHandler[]): void;
168
183
  /**
169
184
  * Registers providers, runs the boot callback, mounts routes, boots providers.
@@ -3,7 +3,7 @@ export type Middleware = MiddlewareHandler;
3
3
  export declare function defineMiddleware(handler: MiddlewareHandler): MiddlewareHandler;
4
4
  export declare function jsonResponse(data: unknown, status?: number): Response;
5
5
  export { createSessionMiddleware, MemorySessionStore, getSessionFromContext } from './session.js';
6
- export { DEFAULT_SESSION_STORE_NAME, PER_PROCESS_SESSION_DRIVERS, SessionManager } from './session-manager.js';
6
+ export { BUILT_IN_SESSION_DRIVERS, DEFAULT_SESSION_STORE_NAME, PER_PROCESS_SESSION_DRIVERS, SessionManager } from './session-manager.js';
7
7
  export { CookieSessionStore } from './cookie-session-store.js';
8
8
  export type { CookieSessionStoreOptions } from './cookie-session-store.js';
9
9
  export type { CookieSessionDriverOptions, SessionConfig, SessionDrivers, SessionStoreConfig, SessionDriverFactory, MemorySessionDriverOptions, RedisSessionDriverOptions, } from './session-manager.js';
@@ -41,6 +41,13 @@ export type SessionStoreConfig = {
41
41
  /** The store `SessionConfig.default` names when it names none, and the one driver that shares no state between requests. */
42
42
  export declare const DEFAULT_SESSION_STORE_NAME = "memory";
43
43
  export declare const PER_PROCESS_SESSION_DRIVERS: ReadonlySet<string>;
44
+ /**
45
+ * Every driver the framework itself registers, and whether it survives a
46
+ * runtime that shares no memory between requests. Read by static checks that
47
+ * cannot boot the app; a plugin's driver is declared in its `gurenPlugin`
48
+ * manifest instead, and a name in neither is unverifiable, not absent.
49
+ */
50
+ export declare const BUILT_IN_SESSION_DRIVERS: ReadonlyMap<string, boolean>;
44
51
  /** Cookie and TTL settings plus the named stores one of which is the default. */
45
52
  export interface SessionConfig extends SessionCookieOptions {
46
53
  /** @default 'memory' */
@@ -1,2 +1,2 @@
1
- import { a as setI18n, c as tryGetI18n, d as getPluralizationRule, f as pluralizationRules, i as getI18n, l as JsonLoader, n as I18nManager, o as t, p as selectPluralForm, r as createI18n, s as tc, t as MemoryLoader, u as Translator } from "../i18n-Cg1aajRP.js";
1
+ import { a as setI18n, c as tryGetI18n, d as getPluralizationRule, f as pluralizationRules, i as getI18n, l as JsonLoader, n as I18nManager, o as t, p as selectPluralForm, r as createI18n, s as tc, t as MemoryLoader, u as Translator } from "../i18n-BZ2VrSud.js";
2
2
  export { I18nManager, JsonLoader, MemoryLoader, Translator, createI18n, getI18n, getPluralizationRule, pluralizationRules, selectPluralForm, setI18n, t, tc, tryGetI18n };
package/dist/index.d.ts CHANGED
@@ -10,6 +10,8 @@ export type { ContentfulStatusCode } from 'hono/utils/http-status';
10
10
  export { viteAsset } from './http/vite-assets.js';
11
11
  export type { ViteAssetOptions } from './http/vite-assets.js';
12
12
  export { Router } from './mvc/Router.js';
13
+ export { prototype } from './mvc/prototype.js';
14
+ export type { PrototypeFixture, PrototypeFixtureLoader, PrototypeResult, PrototypeRouteHandler, PrototypeServerContext, } from './mvc/prototype.js';
13
15
  export type { BindableModel, AgentRouteMetadata, RouteBuilder, RouteContractOptions, RouteDefinition, RouteMiddlewareInput, RouteModelBinding, RouteOpenApiMetadata, ResourceAction as RouteResourceAction, ResourceResponseHint, ResourceResponseShape, ResourceRouteOptions, } from './mvc/Router.js';
14
16
  export { deriveAgentTools } from './agent/derive.js';
15
17
  export type { AgentToolInputSource, AgentToolSchema, DeriveAgentToolsResult, DerivedAgentTool, DerivedAgentToolAnnotations, DerivedAgentToolExposure, } from './agent/derive.js';
@@ -43,7 +45,7 @@ export { InertiaServiceProvider, AuthServiceProvider, OAuthServiceProvider, Even
43
45
  export { FormRequest } from './http/FormRequest.js';
44
46
  export { AuthManager, SessionGuard, TokenGuard, ModelUserProvider, BaseUserProvider, AuthenticatableModel, ScryptHasher, createPasswordResetToken, verifyPasswordResetToken, completePasswordReset, buildPasswordResetUrl, parsePasswordResetUrl, MemoryPasswordResetStore, createEmailVerificationToken, verifyEmailToken, completeEmailVerification, buildVerificationUrl, parseVerificationUrl, isEmailVerified, requireVerifiedEmail, MemoryEmailVerificationStore, createApiToken, parseApiToken, readBearerToken, verifyApiToken, tokenCan, tokenCanAll, tokenCanAny, revokeApiToken, revokeAllApiTokens, getUserApiTokens, createBearerTokenMiddleware, getApiToken, getApiTokenOrFail, MemoryApiTokenStore, API_TOKEN_KEY, OAuthManager, MemoryOAuthStateStore, createOAuthManager, createOAuthState, verifyOAuthState, sanitizeOAuthRedirect, OAUTH_SESSION_BINDING_KEY, buildOAuthAuthorizeUrl, exchangeOAuthCode, fetchOAuthUserProfile, createGitHubOAuthProviderConfig, createGoogleOAuthProviderConfig, createDiscordOAuthProviderConfig, buildOAuthRedirectUrl, parseOAuthRedirectUrl, } from './auth/index.js';
45
47
  export type { AuthContext as AuthRuntimeContext, AuthCredentials, AuthManagerOptions, Authenticatable, Guard, GuardContext, GuardFactory, UserProvider, ProviderFactory, DefaultSanitizedKeys, Sanitized, PasswordResetConfig, PasswordResetTokenStore, PasswordResetTokenResult, EmailVerificationConfig, EmailVerificationTokenStore, EmailVerificationToken, EmailVerificationTokenResult, ApiToken, ApiTokenGuardOptions, ApiTokenStore, CreateApiTokenOptions, CreateApiTokenResult, BearerTokenMiddlewareOptions, VerifiedApiToken, TokenGuardOptions, OAuthProviderConfig, OAuthTokenResult, OAuthUserProfile, OAuthFallbackEmail, OAuthStatePayload, OAuthStateStore, OAuthStateConfig, OAuthAuthorizeOptions, OAuthCallbackPayload, OAuthManagerOptions, OAuthProviderFactoryInput, OAuthBindingSession, } from './auth/index.js';
46
- export { defineMiddleware, jsonResponse, createSessionMiddleware, MemorySessionStore, SessionManager, CookieSessionStore, DEFAULT_SESSION_STORE_NAME, PER_PROCESS_SESSION_DRIVERS, getSessionFromContext, requireAuthenticated, requireGuest, attachAuthContext, createCsrfMiddleware, getCsrfToken, csrfField, verifyCsrfToken, CSRF_TOKEN_KEY, CSRF_HEADER_NAME, CSRF_FORM_FIELD, validateRequest, validateRequestWith, getValidatedData, validate, validateSafe, VALIDATED_DATA_KEY, createRateLimitMiddleware, getRateLimitInfo, resetRateLimit, MemoryRateLimitStore, SlidingWindowRateLimitStore, createSecurityHeaders, createCspMiddleware, getCspNonce, CSP_NONCE_KEY, createHostAuthorizationMiddleware, createCorsMiddleware, createRedirectSafetyMiddleware, isSafeRedirectUrl, createForceHttpsMiddleware, requestIdMiddleware, requestLoggingMiddleware, detectLocaleMiddleware, LOCALE_CONTEXT_KEY, getRequestLocale, getRequestTranslator, } from './http/middleware/index.js';
48
+ export { defineMiddleware, jsonResponse, createSessionMiddleware, MemorySessionStore, SessionManager, CookieSessionStore, DEFAULT_SESSION_STORE_NAME, BUILT_IN_SESSION_DRIVERS, PER_PROCESS_SESSION_DRIVERS, getSessionFromContext, requireAuthenticated, requireGuest, attachAuthContext, createCsrfMiddleware, getCsrfToken, csrfField, verifyCsrfToken, CSRF_TOKEN_KEY, CSRF_HEADER_NAME, CSRF_FORM_FIELD, validateRequest, validateRequestWith, getValidatedData, validate, validateSafe, VALIDATED_DATA_KEY, createRateLimitMiddleware, getRateLimitInfo, resetRateLimit, MemoryRateLimitStore, SlidingWindowRateLimitStore, createSecurityHeaders, createCspMiddleware, getCspNonce, CSP_NONCE_KEY, createHostAuthorizationMiddleware, createCorsMiddleware, createRedirectSafetyMiddleware, isSafeRedirectUrl, createForceHttpsMiddleware, requestIdMiddleware, requestLoggingMiddleware, detectLocaleMiddleware, LOCALE_CONTEXT_KEY, getRequestLocale, getRequestTranslator, } from './http/middleware/index.js';
47
49
  export { AUTH_CONTEXT_KEY } from './http/middleware/auth.js';
48
50
  export type { Middleware, Session, SessionData, SessionStore, SessionConfig, SessionDrivers, SessionStoreConfig, SessionDriverFactory, SessionCookieOptions, SessionInlineCodec, CookieSessionStoreOptions, CookieSessionDriverOptions, MemorySessionDriverOptions, RedisSessionDriverOptions, AuthContext, RequireAuthOptions, CsrfOptions, CookielessAuthEndpoints, ValidationSchema, ValidateRequestOptions, RateLimitOptions, RateLimitStore, RateLimitEntry, RateLimitInfo, SecurityHeadersOptions, HstsOptions, CspOptions, CspDirectives, HostAuthorizationOptions, CorsOptions, RedirectSafetyOptions, ForceHttpsOptions, DetectLocaleOptions, DetectLocaleVariables, TranslatorBinding, LocaleSource, } from './http/middleware/index.js';
49
51
  export { Validator, FieldValidator, createValidator, quickValidate, quickValidateOrThrow, required, nullable, requiredIf, requiredUnless, requiredWith, requiredWithout, string as stringRule, numeric, integer, boolean as booleanRule, array as arrayRule, object as objectRule, email as emailRule, url as urlRule, uuid as uuidRule, ip, ipv4, ipv6, json as jsonRule, alpha, alphaNum, alphaDash, regex, min, max, between, size, inValues, notIn, confirmed, same, different, date as dateRule, dateFormat, after, afterOrEqual, before, beforeOrEqual, startsWith, endsWith, file as fileRule, image as imageRule, mimes, maxFileSize, minFileSize, custom, unique, exists, } from './http/validation/index.js';