@ghuri/core 0.1.0-alpha.4 → 0.1.0-alpha.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"sources":["../src/app.ts","../src/commands.ts","../src/apps.ts","../src/checks.ts","../src/middleware.ts","../src/clickjacking.ts","../src/settings.ts","../src/signals.ts","../src/tasks.ts","../src/cache.ts","../src/carriers.ts","../src/user.ts","../src/views.ts"],"sourcesContent":["import type { Context } from 'hono'\nimport { Hono } from 'hono'\nimport { apps } from './apps'\nimport { runChecks } from './checks'\nimport {\n createContext,\n type Env,\n type ExecutionContextLike,\n type GhuriContext,\n runWithContext,\n setGlobalContext,\n} from './context'\nimport { ImproperlyConfigured } from './errors'\nimport { type ExceptionHandler, handleException, notFoundHandler } from './exceptions'\nimport { type MiddlewareEntry, toHonoMiddleware, validateHost } from './middleware'\nimport { defineSettings, type GhuriSettings, isSettingsFactory, type SettingsFactory } from './settings'\nimport { requestFinished, requestStarted } from './signals'\nimport { type MessageBatchLike, type ScheduledEventLike, taskHandlers } from './tasks'\nimport { getResolver, type UrlPatterns, type UrlResolver } from './urls'\n\nexport interface CreateAppOptions {\n /** Customize the Hono app. Called after MIDDLEWARE is installed and before the URL patterns. */\n hono?: (app: Hono) => void\n /** Custom error handling. Return a Response to override the default mapping, or undefined to fall through. */\n onError?: ExceptionHandler\n /** Run system checks when the app starts with DEBUG on (default true). */\n checks?: boolean\n}\n\n/** The object a Worker exports (`export default createApp(settings)`). */\nexport interface GhuriApp {\n fetch(request: Request, env?: Env, ctx?: ExecutionContextLike): Promise<Response>\n /** Cron Triggers: dispatches to handlers registered with `onSchedule()`. */\n scheduled(event: ScheduledEventLike, env?: Env, ctx?: ExecutionContextLike): Promise<void>\n /** Queue consumer: dispatches to handlers registered with `onQueue()`. */\n queue(batch: MessageBatchLike, env?: Env, ctx?: ExecutionContextLike): Promise<void>\n /** Populate apps without a request and install a global context (CLI, scripts, tests). */\n setup(env?: Env): Promise<GhuriContext>\n /**\n * Run `fn` inside a fresh Ghuri context (apps populated, settings resolved), like a request without\n * HTTP. Used for work that does not arrive through `fetch`: Durable Object events, WebSocket messages,\n * scripts. Unlike `setup()`, it installs no global context.\n */\n run<T>(\n env: Env | undefined,\n ctx: ExecutionContextLike | undefined,\n fn: (ctx: GhuriContext) => Promise<T>,\n ): Promise<T>\n /** The built Hono router (for testing / composition). Requests through it still get a Ghuri context. */\n hono(env?: Env): Promise<Hono>\n}\n\ninterface Built {\n hono: Hono\n urlconf: UrlResolver\n}\n\nconst EMPTY_ENV: Env = Object.freeze({}) as Env\n\nfunction toFactory(\n settings: SettingsFactory | ((env: Env) => GhuriSettings) | GhuriSettings,\n): SettingsFactory {\n if (isSettingsFactory(settings)) return settings\n if (typeof settings === 'function') return defineSettings(settings)\n if (settings && typeof settings === 'object') return defineSettings(() => settings)\n throw new ImproperlyConfigured('createApp() expects settings created with defineSettings().')\n}\n\nfunction safeExecutionCtx(c: Context): ExecutionContextLike | undefined {\n try {\n return c.executionCtx\n } catch {\n return undefined\n }\n}\n\nfunction reportChecks(messages: Awaited<ReturnType<typeof runChecks>>): void {\n if (!messages.length) return\n const serious = messages.filter((m) => m.isSerious())\n for (const m of messages) (m.isSerious() ? console.error : console.warn)(`System check: ${m.toString()}`)\n if (serious.length) {\n throw new ImproperlyConfigured(\n `System check identified ${serious.length} error(s):\\n${serious.map((m) => m.toString()).join('\\n')}`,\n )\n }\n}\n\n/**\n * Create the application (Django's `wsgi.py`). The returned object is a Workers module handler\n * (`fetch` / `scheduled` / `queue`) and also works with `serve()` from `@ghuri/core/node`.\n */\nexport function createApp(\n settingsInput: SettingsFactory | ((env: Env) => GhuriSettings) | GhuriSettings,\n options: CreateAppOptions = {},\n): GhuriApp {\n const factory = toFactory(settingsInput)\n const builds = new WeakMap<GhuriSettings, Promise<Built>>()\n let app: GhuriApp\n\n const resolveSettings = (env: Env | undefined): GhuriSettings => factory(env ?? EMPTY_ENV)\n\n async function prepare(settings: GhuriSettings, env: Env): Promise<void> {\n const ctx = createContext({ env, settings })\n await runWithContext(ctx, async () => {\n await apps.populate(settings.INSTALLED_APPS)\n if (settings.DEBUG && options.checks !== false) reportChecks(await runChecks({ settings }))\n })\n }\n\n function buildHono(settings: GhuriSettings): Built {\n const urlconf = getResolver(settings.ROOT_URLCONF as UrlPatterns)\n const hono = new Hono()\n\n // 1. Per-request Ghuri context + request signals.\n hono.use('*', async (c, next) => {\n const ctx = createContext({\n env: c.env ?? EMPTY_ENV,\n settings,\n executionCtx: safeExecutionCtx(c),\n request: c.req.raw,\n hono: c,\n })\n c.set('ghuri', ctx)\n await runWithContext(ctx, async () => {\n await requestStarted.send(app, { request: c.req.raw })\n try {\n await next()\n } finally {\n try {\n await requestFinished.send(app, { request: c.req.raw, response: c.res })\n } catch (err) {\n console.error('requestFinished receiver failed:', err)\n }\n }\n })\n })\n // 2. ALLOWED_HOSTS.\n hono.use('*', async (_c, next) => {\n validateHost(_c)\n await next()\n })\n // 3. MIDDLEWARE, in order.\n for (const entry of settings.MIDDLEWARE ?? []) hono.use('*', toHonoMiddleware(entry as MiddlewareEntry))\n // 4. User customization, then URL patterns.\n options.hono?.(hono)\n urlconf.mount(hono)\n // 5. Error handling.\n hono.notFound(notFoundHandler(urlconf))\n hono.onError(async (err, c) => {\n if (options.onError) {\n const res = await options.onError(err, c)\n if (res instanceof Response) return res\n }\n return handleException(err, c)\n })\n return { hono, urlconf }\n }\n\n function getBuilt(settings: GhuriSettings, env: Env): Promise<Built> {\n let p = builds.get(settings)\n if (!p) {\n p = prepare(settings, env).then(() => buildHono(settings))\n p.catch(() => builds.delete(settings))\n builds.set(settings, p)\n }\n return p\n }\n\n function startupFailure(err: unknown, settings: GhuriSettings | undefined): Response {\n console.error('Ghuri failed to start:', err)\n const debug = settings?.DEBUG\n const body = debug\n ? `Ghuri failed to start.\\n\\n${(err as Error)?.stack ?? String(err)}`\n : 'Internal Server Error'\n return new Response(body, { status: 500, headers: { 'content-type': 'text/plain; charset=UTF-8' } })\n }\n\n async function withTaskContext<T>(\n env: Env | undefined,\n execCtx: ExecutionContextLike | undefined,\n fn: (ctx: GhuriContext) => Promise<T>,\n ): Promise<T> {\n const e = env ?? EMPTY_ENV\n const settings = resolveSettings(e)\n await getBuilt(settings, e)\n const ctx = createContext({ env: e, settings, executionCtx: execCtx })\n return runWithContext(ctx, () => fn(ctx))\n }\n\n app = {\n async fetch(request, env, ctx) {\n const e = env ?? EMPTY_ENV\n let settings: GhuriSettings | undefined\n let built: Built\n try {\n settings = resolveSettings(e)\n built = await getBuilt(settings, e)\n } catch (err) {\n return startupFailure(err, settings)\n }\n return built.hono.fetch(request, e, ctx as any)\n },\n\n async scheduled(event, env, ctx) {\n await withTaskContext(env, ctx, async (gctx) => {\n const handlers = taskHandlers.schedulesFor(event.cron)\n if (!handlers.length) console.warn(`No onSchedule() handler registered for cron '${event.cron}'.`)\n const errors: unknown[] = []\n for (const h of handlers) {\n try {\n await h(event, gctx)\n } catch (err) {\n console.error(`Scheduled handler for '${event.cron}' failed:`, err)\n errors.push(err)\n }\n }\n if (errors.length === 1) throw errors[0]\n if (errors.length > 1) throw new AggregateError(errors, `${errors.length} scheduled handlers failed.`)\n })\n },\n\n async queue(batch, env, ctx) {\n await withTaskContext(env, ctx, async (gctx) => {\n const handlers = taskHandlers.queuesFor(batch.queue)\n if (!handlers.length) {\n throw new ImproperlyConfigured(`No onQueue() handler registered for queue '${batch.queue}'.`)\n }\n for (const h of handlers) await h(batch, gctx)\n })\n },\n\n async setup(env) {\n const e = env ?? EMPTY_ENV\n const settings = resolveSettings(e)\n await getBuilt(settings, e)\n const ctx = createContext({ env: e, settings })\n setGlobalContext(ctx)\n return ctx\n },\n\n run(env, ctx, fn) {\n return withTaskContext(env, ctx, fn)\n },\n\n async hono(env) {\n const e = env ?? EMPTY_ENV\n return (await getBuilt(resolveSettings(e), e)).hono\n },\n }\n return app\n}\n","import { GhuriError } from './errors'\n\nexport class CommandError extends GhuriError {\n constructor(\n message: string,\n readonly returncode = 1,\n ) {\n super(message)\n }\n}\n\nexport interface ArgumentSpec {\n name: string\n help?: string\n required?: boolean\n variadic?: boolean\n default?: unknown\n}\n\nexport interface OptionSpec {\n /** e.g. '--remote', '-n, --name <value>', '--no-input' */\n flags: string\n help?: string\n default?: unknown\n}\n\n/** Minimal parser description; the CLI turns it into real argv parsing. */\nexport class ArgumentParser {\n readonly arguments: ArgumentSpec[] = []\n readonly options: OptionSpec[] = []\n\n argument(name: string, opts: Omit<ArgumentSpec, 'name'> = {}): this {\n this.arguments.push({ name, ...opts })\n return this\n }\n\n option(flags: string, opts: Omit<OptionSpec, 'flags'> = {}): this {\n this.options.push({ flags, ...opts })\n return this\n }\n}\n\nexport interface CommandStyle {\n success(s: string): string\n warning(s: string): string\n error(s: string): string\n notice(s: string): string\n bold(s: string): string\n}\n\nexport interface CommandIO {\n stdout(msg: string): void\n stderr(msg: string): void\n style: CommandStyle\n /** Interactive prompt. Undefined when running non-interactively. */\n prompt?(question: string, opts?: { password?: boolean; default?: string }): Promise<string>\n confirm?(question: string, opts?: { default?: boolean }): Promise<boolean>\n}\n\n/** Django's BaseCommand. */\nexport abstract class BaseCommand {\n static help = ''\n addArguments?(parser: ArgumentParser): void\n abstract handle(args: Record<string, unknown>, io: CommandIO): Promise<void | number>\n}\n\nexport type CommandClass = (new () => BaseCommand) & { help?: string }\n\nexport class CommandRegistry {\n private commands = new Map<string, CommandClass>()\n\n register(name: string, cls: CommandClass): void {\n this.commands.set(name, cls)\n }\n\n get(name: string): CommandClass | undefined {\n return this.commands.get(name)\n }\n\n all(): Map<string, CommandClass> {\n return new Map(this.commands)\n }\n}\n\nconst KEY = Symbol.for('ghuri.core.commands')\nexport const commandRegistry: CommandRegistry = ((globalThis as any)[KEY] ??= new CommandRegistry())\n\nconst identity = (s: string) => s\nexport const plainStyle: CommandStyle = {\n success: identity,\n warning: identity,\n error: identity,\n notice: identity,\n bold: identity,\n}\n\n/** IO that collects output — handy for tests (`callCommand`). */\nexport function bufferIO(): CommandIO & { out: string[]; err: string[] } {\n const out: string[] = []\n const err: string[] = []\n return { out, err, stdout: (m) => out.push(m), stderr: (m) => err.push(m), style: plainStyle }\n}\n\n/** Run a command programmatically (Django's call_command). */\nexport async function callCommand(\n nameOrClass: string | CommandClass,\n args: Record<string, unknown> = {},\n io: CommandIO = bufferIO(),\n): Promise<void | number> {\n const cls = typeof nameOrClass === 'string' ? commandRegistry.get(nameOrClass) : nameOrClass\n if (!cls) throw new CommandError(`Unknown command: '${String(nameOrClass)}'`)\n return new cls().handle(args, io)\n}\n","import { type CommandClass, commandRegistry } from './commands'\nimport { AppRegistryNotReady, ImproperlyConfigured } from './errors'\n\nexport type CommandClassLike = new () => {\n handle(args: Record<string, unknown>, io: any): Promise<void | number>\n}\n\n/** Django's AppConfig. Subclass it in `src/<app>/app.ts`. */\nexport abstract class AppConfig {\n abstract name: string\n label?: string\n verboseName?: string\n /** Directory of the app (`import.meta.dirname`). Only used by the CLI (migrations). */\n path?: string\n /** `import * as models from './models'` — every Model class found is registered to this app. */\n models?: Record<string, unknown> | unknown[]\n /** `import * as migrations from './migrations'` (index generated by makemigrations). */\n migrations?: Record<string, unknown>\n /** `import * as admin from './admin'` — importing the module registers ModelAdmins. */\n admin?: unknown\n /** Agents, signals or any other module the app wants loaded at startup. */\n modules?: Record<string, unknown>\n commands?: Record<string, CommandClassLike>\n ready?(): void | Promise<void>\n\n get appLabel(): string {\n return this.label ?? this.name.split(/[./]/).pop()!\n }\n\n get displayName(): string {\n return this.verboseName ?? this.appLabel.charAt(0).toUpperCase() + this.appLabel.slice(1)\n }\n}\n\nexport type AppConfigClass = new () => AppConfig\n\ntype PopulateHook = (registry: AppRegistry) => void | Promise<void>\n\nexport class AppRegistry {\n private configs = new Map<string, AppConfig>()\n private models = new Map<string, Map<string, unknown>>() // appLabel → lower model name → model\n private hooks: PopulateHook[] = []\n private populating: Promise<void> | null = null\n private _ready = false\n private installedKey: unknown = null\n\n get ready(): boolean {\n return this._ready\n }\n\n /** Packages (the ORM) register hooks that run after configs are created and before `ready()`. */\n onPopulate(hook: PopulateHook): void {\n this.hooks.push(hook)\n }\n\n /** Idempotent for the same INSTALLED_APPS array. Re-populates if a different list is passed (tests). */\n populate(installed: Array<AppConfigClass | AppConfig>): Promise<void> {\n if (this.populating && sameApps(this.installedKey, installed)) return this.populating\n if (this.installedKey !== null && !sameApps(this.installedKey, installed)) this.reset()\n this.installedKey = installed\n this.populating = this.doPopulate(installed).catch((err) => {\n this.reset()\n throw err\n })\n return this.populating\n }\n\n private async doPopulate(installed: Array<AppConfigClass | AppConfig>): Promise<void> {\n for (const entry of installed) {\n const config = typeof entry === 'function' ? new (entry as AppConfigClass)() : entry\n if (!(config instanceof AppConfig) && typeof (config as any)?.name !== 'string') {\n throw new ImproperlyConfigured(`INSTALLED_APPS entry ${String(entry)} is not an AppConfig.`)\n }\n const label = (config as AppConfig).appLabel\n if (this.configs.has(label)) {\n throw new ImproperlyConfigured(`Application labels aren't unique, duplicates: ${label}`)\n }\n this.configs.set(label, config as AppConfig)\n if (!this.models.has(label)) this.models.set(label, new Map())\n for (const [name, cls] of Object.entries((config as AppConfig).commands ?? {})) {\n commandRegistry.register(name, cls as unknown as CommandClass)\n }\n }\n for (const hook of this.hooks) await hook(this)\n for (const config of this.configs.values()) await config.ready?.()\n this._ready = true\n }\n\n /** Clear everything (tests). Hooks stay registered. */\n reset(): void {\n this.configs.clear()\n this.models.clear()\n this.populating = null\n this.installedKey = null\n this._ready = false\n }\n\n getAppConfigs(): AppConfig[] {\n return [...this.configs.values()]\n }\n\n getAppConfig(label: string): AppConfig {\n const c = this.configs.get(label)\n if (!c) throw new LookupError(`No installed app with label '${label}'.`)\n return c\n }\n\n isInstalled(label: string): boolean {\n return this.configs.has(label)\n }\n\n registerModel(appLabel: string, model: unknown): void {\n const name = modelName(model)\n let bucket = this.models.get(appLabel)\n if (!bucket) {\n bucket = new Map()\n this.models.set(appLabel, bucket)\n }\n const existing = bucket.get(name)\n if (existing && existing !== model) {\n throw new ImproperlyConfigured(`Conflicting '${name}' models in application '${appLabel}'.`)\n }\n bucket.set(name, model)\n }\n\n getModels(appLabel?: string): unknown[] {\n if (appLabel) return [...(this.models.get(appLabel)?.values() ?? [])]\n return [...this.models.values()].flatMap((m) => [...m.values()])\n }\n\n /** `getModel('blog.Post')` or `getModel('blog', 'post')` (case-insensitive model name). */\n getModel(appLabelOrDotted: string, name?: string): unknown {\n let app = appLabelOrDotted\n let model = name\n if (model === undefined) {\n const idx = appLabelOrDotted.lastIndexOf('.')\n if (idx < 0)\n throw new LookupError(`Model label must be 'app_label.ModelName', got '${appLabelOrDotted}'.`)\n app = appLabelOrDotted.slice(0, idx)\n model = appLabelOrDotted.slice(idx + 1)\n }\n const found = this.models.get(app)?.get(model.toLowerCase())\n if (!found) {\n if (!this._ready && !this.populating) throw new AppRegistryNotReady(\"Models aren't loaded yet.\")\n throw new LookupError(`App '${app}' doesn't have a '${model}' model.`)\n }\n return found\n }\n}\n\nexport class LookupError extends ImproperlyConfigured {}\n\n/** Same INSTALLED_APPS (identical array, or same entries in the same order — settings resolved per env). */\nfunction sameApps(a: unknown, b: unknown[]): boolean {\n if (a === b) return true\n if (!Array.isArray(a) || a.length !== b.length) return false\n return a.every((x, i) => x === b[i])\n}\n\nfunction modelName(model: unknown): string {\n const m = model as any\n return String(m?._meta?.modelName ?? m?.name ?? '').toLowerCase()\n}\n\n// Singleton shared across duplicate module instances.\nconst KEY = Symbol.for('ghuri.core.apps')\nexport const apps: AppRegistry = ((globalThis as any)[KEY] ??= new AppRegistry())\n\nexport function ensureAppsReady(): void {\n if (!apps.ready) throw new AppRegistryNotReady(\"Apps aren't loaded yet.\")\n}\n","import { type AppConfig, apps } from './apps'\nimport { tryGetContext } from './context'\nimport { ImproperlyConfigured } from './errors'\nimport type { GhuriSettings } from './settings'\nimport { getResolver, type UrlPatterns } from './urls'\n\n/** Check levels (same numbers as Django). */\nexport const CheckLevel = { DEBUG: 10, INFO: 20, WARNING: 30, ERROR: 40, CRITICAL: 50 } as const\nconst { DEBUG, INFO, WARNING, ERROR, CRITICAL } = CheckLevel\n\nconst LEVEL_NAMES: Record<number, string> = {\n 10: 'DEBUG',\n 20: 'INFO',\n 30: 'WARNING',\n 40: 'ERROR',\n 50: 'CRITICAL',\n}\n\n/** One system-check result (Django's CheckMessage). */\nexport class CheckMessage {\n constructor(\n readonly level: number,\n readonly msg: string,\n readonly opts: { hint?: string; id?: string; obj?: unknown } = {},\n ) {}\n\n get hint(): string | undefined {\n return this.opts.hint\n }\n get id(): string | undefined {\n return this.opts.id\n }\n get obj(): unknown {\n return this.opts.obj\n }\n get levelName(): string {\n return LEVEL_NAMES[this.level] ?? String(this.level)\n }\n /** ERROR or worse. */\n isSerious(level = ERROR): boolean {\n return this.level >= level\n }\n toString(): string {\n const obj =\n this.obj === undefined\n ? '?'\n : typeof this.obj === 'function'\n ? (this.obj as any).name\n : String(this.obj)\n return `${obj}: (${this.id ?? this.levelName}) ${this.msg}${this.hint ? `\\n\\tHINT: ${this.hint}` : ''}`\n }\n}\n\nexport interface CheckContext {\n settings: GhuriSettings\n appConfigs: AppConfig[]\n /** True for `ghuri check --deploy`. */\n deploy: boolean\n}\n\nexport type CheckFunction = (\n ctx: CheckContext,\n) => CheckMessage[] | undefined | Promise<CheckMessage[] | undefined>\n\ninterface RegisteredCheck {\n fn: CheckFunction\n tags: string[]\n deployOnly: boolean\n}\n\nclass CheckRegistry {\n private registered: RegisteredCheck[] = []\n\n /** Register a check: `checks.register(fn, { tags: ['models'] })`. Deploy-only checks run with `deploy: true`. */\n register(fn: CheckFunction, opts: { tags?: string[]; deploy?: boolean } = {}): CheckFunction {\n if (!this.registered.some((r) => r.fn === fn)) {\n this.registered.push({ fn, tags: opts.tags ?? [], deployOnly: !!opts.deploy })\n }\n return fn\n }\n\n unregister(fn: CheckFunction): void {\n this.registered = this.registered.filter((r) => r.fn !== fn)\n }\n\n get tags(): string[] {\n return [...new Set(this.registered.flatMap((r) => r.tags))]\n }\n\n all(): RegisteredCheck[] {\n return [...this.registered]\n }\n\n debug = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(DEBUG, msg, opts)\n info = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(INFO, msg, opts)\n warning = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(WARNING, msg, opts)\n error = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(ERROR, msg, opts)\n critical = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(CRITICAL, msg, opts)\n}\n\nconst KEY = Symbol.for('ghuri.core.checks')\n/** The system check registry. */\nexport const checks: CheckRegistry = ((globalThis as any)[KEY] ??= new CheckRegistry())\n\nexport interface RunChecksOptions {\n tags?: string[]\n deploy?: boolean\n settings?: GhuriSettings\n /** Silence messages by id (Django's SILENCED_SYSTEM_CHECKS; also read from settings). */\n silenced?: string[]\n}\n\n/** Run registered checks. Uses the current context's settings unless given. */\nexport async function runChecks(opts: RunChecksOptions = {}): Promise<CheckMessage[]> {\n const settings = opts.settings ?? tryGetContext()?.settings\n if (!settings)\n throw new ImproperlyConfigured('runChecks() needs settings (run inside a Ghuri context or pass them).')\n const silenced = new Set([\n ...(opts.silenced ?? []),\n ...((settings.SILENCED_SYSTEM_CHECKS as string[]) ?? []),\n ])\n const ctx: CheckContext = {\n settings,\n appConfigs: apps.ready ? apps.getAppConfigs() : [],\n deploy: !!opts.deploy,\n }\n const out: CheckMessage[] = []\n for (const r of checks.all()) {\n if (r.deployOnly && !opts.deploy) continue\n if (opts.tags?.length && !r.tags.some((t) => opts.tags!.includes(t))) continue\n let msgs: CheckMessage[] | undefined\n try {\n msgs = await r.fn(ctx)\n } catch (err) {\n msgs = [\n new CheckMessage(ERROR, `Check ${r.fn.name || '(anonymous)'} raised: ${(err as Error).message}`, {\n id: 'core.E000',\n }),\n ]\n }\n for (const m of msgs ?? []) if (!m.id || !silenced.has(m.id)) out.push(m)\n }\n return out\n}\n\n// ---------------------------------------------------------------------------------------------\n// Built-in checks\n// ---------------------------------------------------------------------------------------------\n\nfunction checkUrls({ settings }: CheckContext): CheckMessage[] {\n const out: CheckMessage[] = []\n const walk = (patterns: UrlPatterns) => {\n for (const p of patterns) {\n if (!p.regex && p.route.startsWith('/') && p.route !== '/') {\n out.push(\n checks.warning(\n `Your URL pattern '${p.route}' has a route beginning with a '/'. Remove this slash as it is unnecessary.`,\n { id: 'urls.W002' },\n ),\n )\n }\n if (p.name?.includes(':')) {\n out.push(\n checks.warning(`Your URL pattern '${p.route}' has a name including a ':'.`, {\n id: 'urls.W003',\n hint: 'Use namespaces instead.',\n }),\n )\n }\n if (p.children) walk(p.children)\n }\n }\n try {\n walk(settings.ROOT_URLCONF as UrlPatterns)\n getResolver(settings.ROOT_URLCONF as UrlPatterns)\n } catch (err) {\n out.push(checks.error((err as Error).message, { id: 'urls.E004' }))\n }\n return out\n}\n\nfunction checkMiddleware({ settings }: CheckContext): CheckMessage[] {\n const out: CheckMessage[] = []\n for (const m of settings.MIDDLEWARE ?? []) {\n if (typeof m !== 'function' && !(m && typeof (m as any).handle === 'function')) {\n out.push(\n checks.error(`MIDDLEWARE entry ${String(m)} is neither a Middleware nor a Hono middleware.`, {\n id: 'core.E001',\n }),\n )\n }\n }\n return out\n}\n\nfunction checkSecurity({ settings }: CheckContext): CheckMessage[] {\n const out: CheckMessage[] = []\n const names = (settings.MIDDLEWARE ?? []).map((m: any) => m?.name ?? m?.constructor?.name)\n if (settings.DEBUG) {\n out.push(checks.warning('You should not have DEBUG set to true in deployment.', { id: 'security.W018' }))\n }\n const key = String(settings.SECRET_KEY ?? '')\n if (\n key.length < 50 ||\n new Set(key).size < 5 ||\n key.startsWith('django-insecure-') ||\n key.startsWith('ghuri-insecure-')\n ) {\n out.push(\n checks.warning(\n 'Your SECRET_KEY has less than 50 characters, less than 5 unique characters, or is prefixed with \"ghuri-insecure-\".',\n {\n id: 'security.W009',\n hint: 'Generate a long random value and store it as a secret (wrangler secret put SECRET_KEY).',\n },\n ),\n )\n }\n if (!names.includes('SecurityMiddleware')) {\n out.push(\n checks.warning(\"You do not have 'SecurityMiddleware' in your MIDDLEWARE.\", { id: 'security.W001' }),\n )\n }\n if (!names.includes('CsrfMiddleware')) {\n out.push(\n checks.warning(\"You don't appear to be using Ghuri's CSRF protection middleware.\", {\n id: 'security.W003',\n }),\n )\n }\n if (!settings.SECURE_HSTS_SECONDS) {\n out.push(\n checks.warning('You have not set a value for the SECURE_HSTS_SECONDS setting.', {\n id: 'security.W004',\n }),\n )\n }\n if (!settings.CSRF_COOKIE_SECURE) {\n out.push(checks.warning('You have not set CSRF_COOKIE_SECURE to true.', { id: 'security.W016' }))\n }\n if ((settings.ALLOWED_HOSTS ?? ['*']).length === 0) {\n out.push(checks.warning('ALLOWED_HOSTS must not be empty in deployment.', { id: 'security.W020' }))\n }\n return out\n}\n\nchecks.register(checkUrls, { tags: ['urls'] })\nchecks.register(checkMiddleware, { tags: ['middleware'] })\nchecks.register(checkSecurity, { tags: ['security'], deploy: true })\n","import type { Context, MiddlewareHandler, Next } from 'hono'\nimport { compress } from 'hono/compress'\nimport { cors } from 'hono/cors'\nimport { isXFrameOptionsExempt } from './clickjacking'\nimport {\n CSRF_SAFE_METHODS,\n CsrfFailure,\n checkCsrf,\n getHost,\n hostMatches,\n isCsrfExempt,\n isSecure,\n setCsrfCookieIfNeeded,\n} from './csrf'\nimport { DisallowedHost } from './errors'\nimport { appendSlashRedirect, settingsFor } from './exceptions'\nimport type { GhuriSettings } from './settings'\n\n/**\n * Django-style middleware: wraps the rest of the chain.\n *\n * ```ts\n * class TimingMiddleware extends Middleware {\n * async handle(c: Context, next: Next) {\n * const t = Date.now()\n * await next()\n * c.header('Server-Timing', `app;dur=${Date.now() - t}`)\n * }\n * }\n * ```\n * Return a Response (before or after `next()`) to replace the response.\n */\nexport abstract class Middleware {\n abstract handle(c: Context, next: Next): Promise<Response | void>\n}\n\nexport type MiddlewareClass = new () => Middleware\n\n/** What `MIDDLEWARE` accepts: a Middleware class, an instance (for options), or a plain Hono middleware. */\nexport type MiddlewareEntry = MiddlewareClass | Middleware | MiddlewareHandler\n\nfunction isMiddlewareClass(v: unknown): v is MiddlewareClass {\n return typeof v === 'function' && typeof (v as any).prototype?.handle === 'function'\n}\n\n/** Convert a `MIDDLEWARE` entry into a Hono middleware handler. */\nexport function toHonoMiddleware(entry: MiddlewareEntry): MiddlewareHandler {\n let instance: Middleware | undefined\n if (isMiddlewareClass(entry)) instance = new entry()\n else if (entry && typeof entry === 'object' && typeof (entry as Middleware).handle === 'function')\n instance = entry as Middleware\n else if (typeof entry === 'function') return entry as MiddlewareHandler\n if (!instance) throw new TypeError(`Invalid MIDDLEWARE entry: ${String(entry)}`)\n const mw = instance\n const handler: MiddlewareHandler = async (c, next) => {\n let called = false\n const res = await mw.handle(c, async () => {\n called = true\n await next()\n })\n if (res instanceof Response && res !== c.res) {\n // Replace cleanly instead of merging the previous response's headers.\n if (called) c.res = undefined as any\n c.res = res\n }\n }\n Object.defineProperty(handler, 'name', { value: mw.constructor.name })\n return handler\n}\n\nfunction settings(c: Context): GhuriSettings {\n return (settingsFor(c) ?? {}) as GhuriSettings\n}\n\nfunction setIfMissing(c: Context, name: string, value: string): void {\n if (!c.res.headers.has(name)) c.header(name, value)\n}\n\n// ---------------------------------------------------------------------------------------------\n// Host validation (ALLOWED_HOSTS)\n// ---------------------------------------------------------------------------------------------\n\n/** Django's ALLOWED_HOSTS matching: `'*'`, exact hosts, or `'.example.com'` (domain + subdomains). */\nexport function isAllowedHost(host: string, allowed: string[]): boolean {\n const domain = host.startsWith('[') ? host.slice(0, host.indexOf(']') + 1) : host.replace(/:\\d+$/, '')\n return allowed.some((p) => p === '*' || hostMatches(domain.replace(/\\.$/, ''), p))\n}\n\n/** Throws `DisallowedHost` (400) when the Host header is not in ALLOWED_HOSTS. */\nexport function validateHost(c: Context): void {\n const s = settings(c)\n let allowed = s.ALLOWED_HOSTS ?? ['*']\n if (allowed.length === 0 && s.DEBUG) allowed = ['.localhost', '127.0.0.1', '[::1]']\n if (allowed.includes('*')) return\n const host = getHost(c)\n if (!isAllowedHost(host, allowed)) {\n const domain = host.replace(/:\\d+$/, '')\n throw new DisallowedHost(\n `Invalid HTTP_HOST header: '${host}'. You may need to add '${domain}' to ALLOWED_HOSTS.`,\n )\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Built-ins\n// ---------------------------------------------------------------------------------------------\n\n/**\n * Security headers (Django's SecurityMiddleware). Settings: `SECURE_SSL_REDIRECT`, `SECURE_SSL_HOST`,\n * `SECURE_REDIRECT_EXEMPT`, `SECURE_HSTS_SECONDS` (HSTS is sent on https only, when > 0),\n * `SECURE_HSTS_INCLUDE_SUBDOMAINS`, `SECURE_HSTS_PRELOAD`, `SECURE_CONTENT_TYPE_NOSNIFF` (default true),\n * `SECURE_REFERRER_POLICY` (default 'same-origin'), `SECURE_CROSS_ORIGIN_OPENER_POLICY` (default 'same-origin').\n */\nexport class SecurityMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<Response | void> {\n const s = settings(c)\n const secure = isSecure(c)\n if (s.SECURE_SSL_REDIRECT && !secure) {\n const exempt = ((s.SECURE_REDIRECT_EXEMPT as string[] | undefined) ?? []).some((re) =>\n new RegExp(re).test(c.req.path.replace(/^\\//, '')),\n )\n if (!exempt) {\n const url = new URL(c.req.url)\n const host = (s.SECURE_SSL_HOST as string | undefined) ?? getHost(c)\n return new Response(null, {\n status: 301,\n headers: { Location: `https://${host}${url.pathname}${url.search}` },\n })\n }\n }\n await next()\n const hsts = Number(s.SECURE_HSTS_SECONDS ?? 0)\n if (secure && hsts > 0) {\n let v = `max-age=${hsts}`\n if (s.SECURE_HSTS_INCLUDE_SUBDOMAINS) v += '; includeSubDomains'\n if (s.SECURE_HSTS_PRELOAD) v += '; preload'\n setIfMissing(c, 'Strict-Transport-Security', v)\n }\n if (s.SECURE_CONTENT_TYPE_NOSNIFF !== false) setIfMissing(c, 'X-Content-Type-Options', 'nosniff')\n const referrer = s.SECURE_REFERRER_POLICY === undefined ? 'same-origin' : s.SECURE_REFERRER_POLICY\n if (referrer)\n setIfMissing(c, 'Referrer-Policy', Array.isArray(referrer) ? referrer.join(',') : String(referrer))\n const coop =\n s.SECURE_CROSS_ORIGIN_OPENER_POLICY === undefined ? 'same-origin' : s.SECURE_CROSS_ORIGIN_OPENER_POLICY\n if (coop) setIfMissing(c, 'Cross-Origin-Opener-Policy', String(coop))\n }\n}\n\n/**\n * `X-Frame-Options` header (setting `X_FRAME_OPTIONS`, default 'DENY'). Responses that set it keep theirs;\n * views wrapped in `xframeOptionsExempt()` (or class views with `static xframeOptionsExempt = true`) get none.\n */\nexport class XFrameOptionsMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<void> {\n await next()\n if (isXFrameOptionsExempt(c)) return\n const v = (settings(c).X_FRAME_OPTIONS as string | undefined) ?? 'DENY'\n if (v) setIfMissing(c, 'X-Frame-Options', v.toUpperCase())\n }\n}\n\n/**\n * Django's CommonMiddleware: rejects hosts not in `ALLOWED_HOSTS`, `PREPEND_WWW` redirects, and\n * `APPEND_SLASH` (301 from `/x` to `/x/` for GET/HEAD when only the slashed path matches).\n */\nexport class CommonMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<Response | void> {\n validateHost(c)\n const s = settings(c)\n const host = getHost(c)\n if (s.PREPEND_WWW && host && !host.startsWith('www.')) {\n const url = new URL(c.req.url)\n return new Response(null, {\n status: 301,\n headers: { Location: `${url.protocol}//www.${host}${url.pathname}${url.search}` },\n })\n }\n await next()\n if (c.res.status === 404 && s.APPEND_SLASH !== false) {\n const redirect = appendSlashRedirect(c)\n if (redirect) return redirect\n }\n }\n}\n\nexport interface CorsOptions {\n allowOrigins: string[] | '*'\n allowCredentials?: boolean\n allowMethods?: string[]\n allowHeaders?: string[]\n exposeHeaders?: string[]\n maxAge?: number\n}\n\n/**\n * CORS headers and preflight handling. Configure with the `CORS` setting\n * (`{ allowOrigins: ['https://app.example.com'], allowCredentials: true }`) or `new CorsMiddleware({...})`.\n */\nexport class CorsMiddleware extends Middleware {\n private cache = new WeakMap<object, MiddlewareHandler>()\n\n constructor(private readonly options?: CorsOptions) {\n super()\n }\n\n private handlerFor(opts: CorsOptions): MiddlewareHandler {\n let h = this.cache.get(opts)\n if (!h) {\n const all = opts.allowOrigins === '*'\n const list = all ? [] : (opts.allowOrigins as string[])\n h = cors({\n origin:\n all && !opts.allowCredentials\n ? '*'\n : (origin) => (all || list.includes(origin) || list.includes('*') ? origin : null),\n credentials: opts.allowCredentials,\n allowMethods: opts.allowMethods ?? ['GET', 'HEAD', 'PUT', 'POST', 'DELETE', 'PATCH', 'OPTIONS'],\n allowHeaders: opts.allowHeaders ?? [],\n exposeHeaders: opts.exposeHeaders ?? [],\n maxAge: opts.maxAge ?? 86400,\n })\n this.cache.set(opts, h)\n }\n return h\n }\n\n async handle(c: Context, next: Next): Promise<Response | void> {\n const opts = this.options ?? (settings(c).CORS as CorsOptions | false | undefined)\n if (!opts) return next()\n const res = await this.handlerFor(opts)(c, next)\n return res instanceof Response ? res : undefined\n }\n}\n\n/**\n * Cross-site request forgery protection (Django's CsrfViewMiddleware). Unsafe requests (POST, PUT, PATCH,\n * DELETE) must send the `csrftoken` cookie's token in the `X-CSRFToken` header or the `csrfmiddlewaretoken`\n * form field, and pass Origin/Referer checks against the host and `CSRF_TRUSTED_ORIGINS`.\n * Exempt views with `csrfExempt(view)`; read the token with `getCsrfToken(c)`.\n */\nexport class CsrfMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<void> {\n if (!CSRF_SAFE_METHODS.has(c.req.method) && !isCsrfExempt(c)) {\n const reason = await checkCsrf(c)\n if (reason) throw new CsrfFailure(reason)\n }\n await next()\n setCsrfCookieIfNeeded(c)\n }\n}\n\nconst isWorkers = () => (globalThis as any).navigator?.userAgent === 'Cloudflare-Workers'\n\n/**\n * Compress responses (gzip/deflate). A no-op on Cloudflare Workers, where the edge compresses for you.\n */\nexport class GZipMiddleware extends Middleware {\n private compressor: MiddlewareHandler | undefined\n\n async handle(c: Context, next: Next): Promise<void> {\n if (isWorkers() || typeof (globalThis as any).CompressionStream === 'undefined') return next()\n this.compressor ??= compress()\n await this.compressor(c, next)\n }\n}\n","import type { Context } from 'hono'\nimport { viewHasMarker } from './markers'\nimport { XFRAME_OPTIONS_EXEMPT_MARKER } from './urls'\n\n/**\n * Mark a view (or a mounted Hono app) as exempt from `XFrameOptionsMiddleware` (Django's\n * `xframe_options_exempt`): its responses get no `X-Frame-Options` header from the middleware, so other\n * sites can frame it. A header the view sets itself is always kept. For class views, set\n * `static xframeOptionsExempt = true`.\n *\n * ```ts\n * path('embed/', xframeOptionsExempt(embedView))\n * ```\n */\nexport function xframeOptionsExempt<T extends object>(view: T): T {\n ;(view as any)[XFRAME_OPTIONS_EXEMPT_MARKER] = true\n return view\n}\n\n/** Is the request's view exempt from `XFrameOptionsMiddleware`? */\nexport function isXFrameOptionsExempt(c: Context): boolean {\n return viewHasMarker(c, XFRAME_OPTIONS_EXEMPT_MARKER)\n}\n","import type { Context, MiddlewareHandler } from 'hono'\nimport type { AppConfig, AppConfigClass } from './apps'\nimport type { CacheConfig } from './cache'\nimport { type Env, getContext } from './context'\nimport { type Http404, ImproperlyConfigured, type ObjectDoesNotExist } from './errors'\nimport type { CorsOptions, Middleware } from './middleware'\nimport type { UrlPatterns } from './urls'\n\n/** What `ROOT_URLCONF` accepts (see `path()` / `include()` in urls.ts). */\nexport type UrlPatternsLike = UrlPatterns\n/** What `MIDDLEWARE` accepts: a Middleware class, a configured Middleware instance, or a plain Hono middleware. */\nexport type MiddlewareLike =\n | (new () => { handle(c: any, next: () => Promise<void>): Promise<Response | void> })\n | Middleware\n | MiddlewareHandler\n\n/**\n * A custom error view (Django's `handler404` / `handler500`): receives the request context and the\n * exception, returns the response.\n */\nexport type ErrorView<E = unknown> = (c: Context<any, any, any>, exception: E) => Response | Promise<Response>\n\n/**\n * Project settings. Other packages add keys with declaration merging:\n *\n * ```ts\n * declare module '@ghuri/core' { interface GhuriSettings { DATABASES: Record<string, DatabaseConfig> } }\n * ```\n */\nexport interface GhuriSettings {\n SECRET_KEY: string\n DEBUG?: boolean\n ALLOWED_HOSTS?: string[]\n INSTALLED_APPS: Array<AppConfigClass | AppConfig>\n MIDDLEWARE?: MiddlewareLike[]\n ROOT_URLCONF: UrlPatternsLike\n APPEND_SLASH?: boolean\n /**\n * Custom 404 view (Django's `handler404`). Called with `DEBUG` off for unmatched paths (after the\n * `APPEND_SLASH` redirect and 405 checks) and for `Http404` / `ObjectDoesNotExist` raised by views\n * or middleware. If it throws, the default 404 page is used.\n */\n HANDLER_404?: ErrorView<Http404 | ObjectDoesNotExist>\n /**\n * Custom 500 view (Django's `handler500`). Called with `DEBUG` off for uncaught exceptions (errors\n * not mapped to an HTTP status). If it throws, the default 500 page is used.\n */\n HANDLER_500?: ErrorView<unknown>\n TIME_ZONE?: string\n USE_TZ?: boolean\n CACHES?: Record<string, CacheConfig>\n CSRF_TRUSTED_ORIGINS?: string[]\n CORS?: CorsOptions | false\n /** Paths whose errors are always rendered as JSON (default `['/api']`). */\n API_PATH_PREFIXES?: string[]\n // CSRF (Django names and defaults)\n CSRF_COOKIE_NAME?: string\n CSRF_HEADER_NAME?: string\n CSRF_COOKIE_AGE?: number | null\n CSRF_COOKIE_DOMAIN?: string\n CSRF_COOKIE_PATH?: string\n CSRF_COOKIE_SECURE?: boolean\n CSRF_COOKIE_HTTPONLY?: boolean\n CSRF_COOKIE_SAMESITE?: 'Lax' | 'Strict' | 'None' | false\n // Security (SecurityMiddleware / XFrameOptionsMiddleware / CommonMiddleware)\n SECURE_PROXY_SSL_HEADER?: [string, string]\n USE_X_FORWARDED_HOST?: boolean\n SECURE_SSL_REDIRECT?: boolean\n SECURE_SSL_HOST?: string\n SECURE_REDIRECT_EXEMPT?: string[]\n SECURE_HSTS_SECONDS?: number\n SECURE_HSTS_INCLUDE_SUBDOMAINS?: boolean\n SECURE_HSTS_PRELOAD?: boolean\n SECURE_CONTENT_TYPE_NOSNIFF?: boolean\n SECURE_REFERRER_POLICY?: string | string[] | false\n SECURE_CROSS_ORIGIN_OPENER_POLICY?: string | false\n X_FRAME_OPTIONS?: string | false\n PREPEND_WWW?: boolean\n [key: string]: unknown\n}\n\nexport interface SettingsFactory {\n (env: Env): GhuriSettings\n readonly __ghuriSettings: true\n}\n\nconst DEFAULTS: Partial<GhuriSettings> = {\n DEBUG: false,\n ALLOWED_HOSTS: ['*'],\n MIDDLEWARE: [],\n APPEND_SLASH: true,\n TIME_ZONE: 'UTC',\n USE_TZ: true,\n CSRF_TRUSTED_ORIGINS: [],\n CORS: false,\n}\n\n/** Define project settings as a function of the runtime environment (Worker bindings / process.env). */\nexport function defineSettings(fn: (env: Env) => GhuriSettings): SettingsFactory {\n const cache = new WeakMap<object, GhuriSettings>()\n const factory = ((env: Env) => {\n const key = env ?? {}\n let resolved = cache.get(key)\n if (!resolved) {\n resolved = { ...DEFAULTS, ...fn(env ?? {}) } as GhuriSettings\n validateSettings(resolved)\n cache.set(key, resolved)\n }\n return resolved\n }) as SettingsFactory\n Object.defineProperty(factory, '__ghuriSettings', { value: true })\n return factory\n}\n\nexport function isSettingsFactory(v: unknown): v is SettingsFactory {\n return typeof v === 'function' && (v as any).__ghuriSettings === true\n}\n\nfunction validateSettings(s: GhuriSettings): void {\n if (!s.SECRET_KEY && !s.DEBUG) {\n throw new ImproperlyConfigured(\n 'The SECRET_KEY setting must not be empty (set it in .dev.vars / wrangler secrets).',\n )\n }\n if (!Array.isArray(s.INSTALLED_APPS)) throw new ImproperlyConfigured('INSTALLED_APPS must be an array.')\n if (!Array.isArray(s.ROOT_URLCONF))\n throw new ImproperlyConfigured('ROOT_URLCONF must be an array of url patterns.')\n for (const key of ['HANDLER_404', 'HANDLER_500'] as const) {\n if (s[key] !== undefined && s[key] !== null && typeof s[key] !== 'function') {\n throw new ImproperlyConfigured(`${key} must be a view function (c, exception) => Response.`)\n }\n }\n}\n\n/** Settings for the current request / run. */\nexport function getSettings(): GhuriSettings {\n return getContext().settings\n}\n\n/** Read one setting with a default, e.g. `setting('REST_FRAMEWORK', {})`. */\nexport function setting<T>(name: string, fallback: T): T {\n const v = getSettings()[name]\n return (v === undefined ? fallback : v) as T\n}\n","export type Receiver<A> = (args: A & { sender: unknown }) => void | Promise<void>\n\ninterface Connection<A> {\n receiver: Receiver<A>\n sender?: unknown\n uid?: string\n}\n\n/** Django-style signal. Receivers run sequentially and are awaited. */\nexport class Signal<A extends object = Record<string, unknown>> {\n private receivers: Connection<A>[] = []\n\n constructor(readonly name = 'signal') {}\n\n connect(receiver: Receiver<A>, opts: { sender?: unknown; uid?: string } = {}): void {\n if (opts.uid && this.receivers.some((r) => r.uid === opts.uid)) return\n if (this.receivers.some((r) => r.receiver === receiver && r.sender === opts.sender)) return\n this.receivers.push({ receiver, sender: opts.sender, uid: opts.uid })\n }\n\n disconnect(receiverOrUid: Receiver<A> | string, sender?: unknown): boolean {\n const before = this.receivers.length\n this.receivers = this.receivers.filter((r) =>\n typeof receiverOrUid === 'string'\n ? r.uid !== receiverOrUid\n : !(r.receiver === receiverOrUid && (sender === undefined || r.sender === sender)),\n )\n return this.receivers.length !== before\n }\n\n hasListeners(sender?: unknown): boolean {\n return this.receivers.some((r) => r.sender === undefined || r.sender === sender)\n }\n\n async send(sender: unknown, args: A): Promise<void> {\n for (const r of [...this.receivers]) {\n if (r.sender !== undefined && r.sender !== sender) continue\n await r.receiver({ ...args, sender })\n }\n }\n}\n\n/** Decorator-free helper: `receiver(postSave, { sender: Post })(fn)`. */\nexport function receiver<A extends object>(signal: Signal<A>, opts: { sender?: unknown; uid?: string } = {}) {\n return (fn: Receiver<A>): Receiver<A> => {\n signal.connect(fn, opts)\n return fn\n }\n}\n\nexport const requestStarted = new Signal<{ request: Request }>('requestStarted')\nexport const requestFinished = new Signal<{ request: Request; response?: Response }>('requestFinished')\n","import type { GhuriContext } from './context'\n\n/** Cloudflare `ScheduledController` (structural). */\nexport interface ScheduledEventLike {\n cron: string\n scheduledTime: number\n type?: string\n noRetry?(): void\n}\n\n/** Cloudflare Queues message (structural). */\nexport interface QueueMessageLike<T = unknown> {\n id: string\n timestamp: Date\n body: T\n attempts?: number\n ack(): void\n retry(opts?: { delaySeconds?: number }): void\n}\n\n/** Cloudflare Queues `MessageBatch` (structural). */\nexport interface MessageBatchLike<T = unknown> {\n queue: string\n messages: readonly QueueMessageLike<T>[]\n ackAll(): void\n retryAll(opts?: { delaySeconds?: number }): void\n}\n\nexport type ScheduledHandler = (event: ScheduledEventLike, ctx: GhuriContext) => void | Promise<void>\nexport type QueueHandler<T = any> = (batch: MessageBatchLike<T>, ctx: GhuriContext) => void | Promise<void>\n\ninterface Registry {\n schedules: Array<{ cron: string; handler: ScheduledHandler }>\n queues: Array<{ queue: string; handler: QueueHandler }>\n}\n\nconst KEY = Symbol.for('ghuri.core.tasks')\nconst registry: Registry = ((globalThis as any)[KEY] ??= { schedules: [], queues: [] })\n\n/**\n * Run `handler` for Cron Triggers matching `cron` (the exact expression from wrangler.jsonc, or `'*'` for\n * every trigger). Typically called from an AppConfig's `ready()`. Returns an unregister function.\n */\nexport function onSchedule(cron: string, handler: ScheduledHandler): () => void {\n const entry = { cron, handler }\n registry.schedules.push(entry)\n return () => {\n registry.schedules = registry.schedules.filter((e) => e !== entry)\n }\n}\n\n/** Consume batches of the queue named `queue` (or `'*'` for all queues). Returns an unregister function. */\nexport function onQueue<T = any>(queue: string, handler: QueueHandler<T>): () => void {\n const entry = { queue, handler: handler as QueueHandler }\n registry.queues.push(entry)\n return () => {\n registry.queues = registry.queues.filter((e) => e !== entry)\n }\n}\n\n/** Introspection / test helpers for the cron & queue handler registry. */\nexport const taskHandlers = {\n schedulesFor(cron: string): ScheduledHandler[] {\n return registry.schedules.filter((e) => e.cron === cron || e.cron === '*').map((e) => e.handler)\n },\n queuesFor(queue: string): QueueHandler[] {\n return registry.queues.filter((e) => e.queue === queue || e.queue === '*').map((e) => e.handler)\n },\n clear(): void {\n registry.schedules = []\n registry.queues = []\n },\n}\n","import { type Env, tryGetContext } from './context'\nimport { GhuriError, ImproperlyConfigured } from './errors'\n\n/**\n * Storage backend for the cache. Values are already JSON strings; `ttlSeconds` is `null` for \"never expire\".\n */\nexport interface CacheBackend {\n get(key: string): Promise<string | null | undefined>\n set(key: string, value: string, ttlSeconds: number | null): Promise<void>\n delete(key: string): Promise<void>\n has?(key: string): Promise<boolean>\n /** Remove every key starting with `prefix` (all keys when prefix is ''). */\n clear?(prefix: string): Promise<void>\n}\n\n/** Entry of the `CACHES` setting. Same pattern as database / storage configs. */\nexport interface CacheConfig {\n backend: string\n create(env: Env): CacheBackend\n /** Prepended to every key (Django's KEY_PREFIX). */\n keyPrefix?: string\n /** Default TTL in seconds when `set()` gets none (Django's TIMEOUT, default 300). `null` = forever. */\n timeout?: number | null\n}\n\nexport interface CacheOptions {\n keyPrefix?: string\n timeout?: number | null\n}\n\n/** High-level cache API (Django's `cache`). Values are JSON-serialized. */\nexport class Cache {\n constructor(\n readonly backend: CacheBackend,\n private readonly keyPrefix = '',\n private readonly defaultTimeout: number | null = 300,\n ) {}\n\n makeKey(key: string): string {\n return this.keyPrefix ? `${this.keyPrefix}:${key}` : key\n }\n\n private ttl(ttl: number | null | undefined): number | null {\n return ttl === undefined ? this.defaultTimeout : ttl\n }\n\n async get<T = unknown>(key: string): Promise<T | undefined>\n async get<T = unknown>(key: string, fallback: T): Promise<T>\n async get<T = unknown>(key: string, fallback?: T): Promise<T | undefined> {\n const raw = await this.backend.get(this.makeKey(key))\n if (raw === null || raw === undefined) return fallback\n try {\n return JSON.parse(raw) as T\n } catch {\n return fallback\n }\n }\n\n /** Store `value` for `ttlSeconds` (default: the configured timeout; `null` = forever; `<= 0` deletes). */\n async set(key: string, value: unknown, ttlSeconds?: number | null): Promise<void> {\n const ttl = this.ttl(ttlSeconds)\n if (ttl !== null && ttl <= 0) return this.delete(key)\n if (value === undefined) throw new TypeError('Cannot cache undefined; use null or delete the key.')\n await this.backend.set(this.makeKey(key), JSON.stringify(value), ttl)\n }\n\n /** Set only if the key is missing. Returns true when stored. (Not atomic on KV / Cache API.) */\n async add(key: string, value: unknown, ttlSeconds?: number | null): Promise<boolean> {\n if (await this.has(key)) return false\n await this.set(key, value, ttlSeconds)\n return true\n }\n\n async delete(key: string): Promise<void> {\n await this.backend.delete(this.makeKey(key))\n }\n\n async has(key: string): Promise<boolean> {\n if (this.backend.has) return this.backend.has(this.makeKey(key))\n const raw = await this.backend.get(this.makeKey(key))\n return raw !== null && raw !== undefined\n }\n\n /** Return the cached value, or compute it (`fn` may be async), store and return it. */\n async getOrSet<T>(\n key: string,\n valueOrFn: T | (() => T | Promise<T>),\n ttlSeconds?: number | null,\n ): Promise<T> {\n const raw = await this.backend.get(this.makeKey(key))\n if (raw !== null && raw !== undefined) return JSON.parse(raw) as T\n const value = typeof valueOrFn === 'function' ? await (valueOrFn as () => T | Promise<T>)() : valueOrFn\n if (value !== undefined) await this.set(key, value, ttlSeconds)\n return value\n }\n\n async getMany<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n const out: Record<string, T> = {}\n await Promise.all(\n keys.map(async (k) => {\n const v = await this.get<T>(k)\n if (v !== undefined) out[k] = v\n }),\n )\n return out\n }\n\n async setMany(values: Record<string, unknown>, ttlSeconds?: number | null): Promise<void> {\n await Promise.all(Object.entries(values).map(([k, v]) => this.set(k, v, ttlSeconds)))\n }\n\n async deleteMany(keys: string[]): Promise<void> {\n await Promise.all(keys.map((k) => this.delete(k)))\n }\n\n /** Add `delta` to a numeric value. Throws if the key is missing. (Not atomic on KV / Cache API.) */\n async incr(key: string, delta = 1): Promise<number> {\n const current = await this.get<number>(key)\n if (current === undefined) throw new GhuriError(`Key '${key}' not found.`)\n const next = Number(current) + delta\n await this.set(key, next, null)\n return next\n }\n\n async decr(key: string, delta = 1): Promise<number> {\n return this.incr(key, -delta)\n }\n\n /** Remove every key of this cache (with its key prefix). */\n async clear(): Promise<void> {\n if (!this.backend.clear) throw new GhuriError('This cache backend does not support clear().')\n await this.backend.clear(this.keyPrefix ? `${this.keyPrefix}:` : '')\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Backends\n// ---------------------------------------------------------------------------------------------\n\n/** In-process cache (Django's LocMemCache). Per isolate on Workers; per process on Node. */\nexport function memoryCache(opts: CacheOptions & { maxEntries?: number } = {}): CacheConfig {\n let store: CacheBackend | undefined\n const max = opts.maxEntries ?? 10_000\n return {\n backend: 'memory',\n keyPrefix: opts.keyPrefix,\n timeout: opts.timeout,\n create() {\n if (store) return store\n const map = new Map<string, { value: string; expires: number | null }>()\n const live = (key: string) => {\n const e = map.get(key)\n if (!e) return undefined\n if (e.expires !== null && e.expires <= Date.now()) {\n map.delete(key)\n return undefined\n }\n return e\n }\n store = {\n async get(key) {\n return live(key)?.value\n },\n async set(key, value, ttl) {\n map.delete(key)\n if (map.size >= max) map.delete(map.keys().next().value as string)\n map.set(key, { value, expires: ttl === null ? null : Date.now() + ttl * 1000 })\n },\n async delete(key) {\n map.delete(key)\n },\n async has(key) {\n return live(key) !== undefined\n },\n async clear(prefix) {\n if (!prefix) return map.clear()\n for (const k of [...map.keys()]) if (k.startsWith(prefix)) map.delete(k)\n },\n }\n return store\n },\n }\n}\n\ninterface KVNamespaceLike {\n get(key: string, type?: 'text'): Promise<string | null>\n put(key: string, value: string, opts?: { expirationTtl?: number }): Promise<void>\n delete(key: string): Promise<void>\n list(opts?: {\n prefix?: string\n cursor?: string\n }): Promise<{ keys: Array<{ name: string }>; list_complete: boolean; cursor?: string }>\n}\n\n/**\n * Workers KV cache. `binding` is the KV namespace binding name (or the namespace itself).\n * KV is eventually consistent and its minimum TTL is 60 seconds (shorter TTLs are rounded up).\n */\nexport function kvCache(binding: string | KVNamespaceLike, opts: CacheOptions = {}): CacheConfig {\n return {\n backend: 'kv',\n keyPrefix: opts.keyPrefix,\n timeout: opts.timeout,\n create(env) {\n const kv = (typeof binding === 'string' ? env[binding] : binding) as KVNamespaceLike | undefined\n if (!kv || typeof kv.get !== 'function') {\n throw new ImproperlyConfigured(`KV namespace binding '${String(binding)}' was not found in env.`)\n }\n return {\n async get(key) {\n return kv.get(key, 'text')\n },\n async set(key, value, ttl) {\n await kv.put(key, value, ttl === null ? undefined : { expirationTtl: Math.max(60, Math.ceil(ttl)) })\n },\n async delete(key) {\n await kv.delete(key)\n },\n async clear(prefix) {\n let cursor: string | undefined\n do {\n const page = await kv.list({ prefix, cursor })\n await Promise.all(page.keys.map((k) => kv.delete(k.name)))\n cursor = page.list_complete ? undefined : page.cursor\n } while (cursor)\n },\n }\n },\n }\n}\n\n/**\n * Cloudflare Cache API cache (`caches.default`, or a named cache). Per data center, best effort;\n * `clear()` is not supported.\n */\nexport function cfCache(opts: CacheOptions & { name?: string; baseUrl?: string } = {}): CacheConfig {\n const base = opts.baseUrl ?? 'https://ghuri-cache.internal/'\n return {\n backend: 'cf-cache',\n keyPrefix: opts.keyPrefix,\n timeout: opts.timeout,\n create() {\n const storage = (globalThis as any).caches\n if (!storage) throw new ImproperlyConfigured('cfCache() needs the Cache API (Cloudflare Workers).')\n const open = async (): Promise<any> =>\n opts.name ? storage.open(opts.name) : (storage.default ?? storage.open('default'))\n const url = (key: string) => `${base}${encodeURIComponent(key)}`\n return {\n async get(key) {\n const res = await (await open()).match(url(key))\n return res ? res.text() : undefined\n },\n async set(key, value, ttl) {\n const maxAge = ttl === null ? 31536000 : Math.max(1, Math.ceil(ttl))\n await (await open()).put(\n url(key),\n new Response(value, {\n headers: { 'Content-Type': 'application/json', 'Cache-Control': `max-age=${maxAge}` },\n }),\n )\n },\n async delete(key) {\n await (await open()).delete(url(key))\n },\n }\n },\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Registry\n// ---------------------------------------------------------------------------------------------\n\nconst DEFAULT_KEY = Symbol.for('ghuri.core.defaultCache')\nconst defaultConfig: CacheConfig = ((globalThis as any)[DEFAULT_KEY] ??= memoryCache())\nconst instances = new WeakMap<CacheConfig, WeakMap<object, Cache>>()\nconst NO_ENV = {}\n\nfunction configFor(alias: string): CacheConfig {\n const caches = tryGetContext()?.settings.CACHES\n const cfg = caches?.[alias]\n if (cfg) return cfg\n if (alias === 'default') return defaultConfig\n throw new ImproperlyConfigured(`The cache alias '${alias}' is not configured in CACHES.`)\n}\n\n/** Access configured caches: `caches.get('sessions')`. */\nexport const caches = {\n get(alias = 'default'): Cache {\n const cfg = configFor(alias)\n const env = tryGetContext()?.env ?? NO_ENV\n let perEnv = instances.get(cfg)\n if (!perEnv) {\n perEnv = new WeakMap()\n instances.set(cfg, perEnv)\n }\n let c = perEnv.get(env)\n if (!c) {\n c = new Cache(cfg.create(env), cfg.keyPrefix ?? '', cfg.timeout === undefined ? 300 : cfg.timeout)\n perEnv.set(env, c)\n }\n return c\n },\n}\n\n/** The default cache (resolved per call from the current context's settings). */\nexport const cache = {\n get: <T = unknown>(key: string, fallback?: T): Promise<T | undefined> =>\n caches.get().get<T>(key, fallback as T),\n set: (key: string, value: unknown, ttlSeconds?: number | null) => caches.get().set(key, value, ttlSeconds),\n add: (key: string, value: unknown, ttlSeconds?: number | null) => caches.get().add(key, value, ttlSeconds),\n delete: (key: string) => caches.get().delete(key),\n has: (key: string) => caches.get().has(key),\n getOrSet: <T>(key: string, valueOrFn: T | (() => T | Promise<T>), ttlSeconds?: number | null) =>\n caches.get().getOrSet<T>(key, valueOrFn, ttlSeconds),\n getMany: <T = unknown>(keys: string[]) => caches.get().getMany<T>(keys),\n setMany: (values: Record<string, unknown>, ttlSeconds?: number | null) =>\n caches.get().setMany(values, ttlSeconds),\n deleteMany: (keys: string[]) => caches.get().deleteMany(keys),\n incr: (key: string, delta?: number) => caches.get().incr(key, delta),\n decr: (key: string, delta?: number) => caches.get().decr(key, delta),\n clear: () => caches.get().clear(),\n}\n","/**\n * Context carriers: request-scoped state (the current tenant, a locale…) that work leaving the request has to take\n * along. A package registers a carrier once; code that hands work to a queue, another service or a background\n * task calls `captureContext()` and later `restoreContext(captured, fn)`, without importing those packages.\n *\n * ```ts\n * const ctx = captureContext() // { tenant: '42' } inside a tenant's request, {} otherwise\n * await queue.send({ ...job, context: ctx })\n * // consumer\n * await restoreContext(job.context, () => runJob(job))\n * ```\n */\n\n/** Captured values, keyed by carrier name. JSON-safe, so they can go into a queue message or HTTP headers. */\nexport type CapturedContext = Record<string, string>\n\nexport interface ContextCarrier {\n /** Unique key in the captured object (`'tenant'`). */\n name: string\n /** The value of the current context as a string, or `undefined` when there is nothing to carry. */\n capture(): string | undefined\n /** Run `fn` with `value` (from `capture()`) active again. */\n restore<R>(value: string, fn: () => Promise<R>): Promise<R>\n}\n\nconst KEY = Symbol.for('ghuri.core.contextCarriers')\nconst g = globalThis as any\n// One registry per process, even if the module is loaded twice.\nconst carriers: Map<string, ContextCarrier> = (g[KEY] ??= new Map<string, ContextCarrier>())\n\n/** Register (or replace) a carrier. Packages call this at import time. */\nexport function registerContextCarrier(carrier: ContextCarrier): void {\n carriers.set(carrier.name, carrier)\n}\n\nexport function unregisterContextCarrier(name: string): boolean {\n return carriers.delete(name)\n}\n\n/** Names of the registered carriers. */\nexport function getContextCarriers(): string[] {\n return [...carriers.keys()]\n}\n\n/** The values every registered carrier has in the current context (carriers with nothing to carry are left out). */\nexport function captureContext(): CapturedContext {\n const out: CapturedContext = {}\n for (const c of carriers.values()) {\n const v = c.capture()\n if (typeof v === 'string' && v !== '') out[c.name] = v\n }\n return out\n}\n\n/**\n * Run `fn` with a captured context active again. Keys without a registered carrier are ignored, and an empty or\n * missing `captured` runs `fn` as is, so messages written before a carrier existed keep working.\n */\nexport async function restoreContext<R>(\n captured: CapturedContext | null | undefined,\n fn: () => Promise<R> | R,\n): Promise<R> {\n const entries = Object.entries(captured ?? {}).filter(\n ([name, v]) => carriers.has(name) && typeof v === 'string' && v !== '',\n )\n const run = entries.reduceRight<() => Promise<R>>(\n (next, [name, value]) =>\n () =>\n carriers.get(name)!.restore(value, next),\n async () => fn(),\n )\n return run()\n}\n","import type { Context } from 'hono'\nimport { tryGetContext } from './context'\n\n/** What rest/admin/agents need from a user, without depending on @ghuri/auth. */\nexport interface RequestUser {\n pk: unknown\n isAuthenticated: boolean\n isAnonymous: boolean\n isActive?: boolean\n isStaff?: boolean\n isSuperuser?: boolean\n username?: string\n hasPerm(perm: string, obj?: unknown): Promise<boolean>\n hasPerms?(perms: string[], obj?: unknown): Promise<boolean>\n hasModulePerms?(appLabel: string): Promise<boolean>\n}\n\nexport class AnonymousUser implements RequestUser {\n readonly pk = null\n readonly id = null\n readonly username = ''\n readonly isAuthenticated = false\n readonly isAnonymous = true\n readonly isActive = false\n readonly isStaff = false\n readonly isSuperuser = false\n async hasPerm(): Promise<boolean> {\n return false\n }\n async hasPerms(): Promise<boolean> {\n return false\n }\n async hasModulePerms(): Promise<boolean> {\n return false\n }\n toString(): string {\n return 'AnonymousUser'\n }\n}\n\nexport const anonymousUser: RequestUser = new AnonymousUser()\n\nconst USER_KEY = Symbol.for('ghuri.core.user')\n\n/** The user of the current request (AnonymousUser if no authentication ran). */\nexport function getUser(c?: Context): RequestUser {\n const fromHono = c?.get?.('user' as never) as RequestUser | undefined\n if (fromHono) return fromHono\n const ctx = tryGetContext()\n const fromCtx =\n (ctx?.state.get(USER_KEY) as RequestUser | undefined) ??\n (ctx?.hono?.get?.('user' as never) as RequestUser | undefined)\n return fromCtx ?? anonymousUser\n}\n\nexport function setUser(c: Context | undefined, user: RequestUser): void {\n c?.set?.('user' as never, user as never)\n tryGetContext()?.state.set(USER_KEY, user)\n}\n\nexport type UserLoader = (pk: unknown) => Promise<RequestUser | null>\n\nconst LOADER_KEY = Symbol.for('ghuri.core.userLoader')\n\n/**\n * Register how to load a user by primary key. `@ghuri/auth` registers one in `ready()`, so packages that\n * only keep a user's pk (WebSocket consumers, background jobs) can load it without importing auth.\n */\nexport function registerUserLoader(loader: UserLoader | undefined): void {\n ;(globalThis as any)[LOADER_KEY] = loader\n}\n\n/** Load a user by pk with the registered loader. Returns null when no loader is registered or no user matches. */\nexport async function loadUser(pk: unknown): Promise<RequestUser | null> {\n const loader = (globalThis as any)[LOADER_KEY] as UserLoader | undefined\n if (!loader || pk === null || pk === undefined) return null\n return loader(pk)\n}\n\ndeclare module 'hono' {\n interface ContextVariableMap {\n user: RequestUser\n ghuri: import('./context').GhuriContext\n }\n}\n","import type { Context, HonoRequest } from 'hono'\nimport { jsx } from 'hono/jsx'\nimport { ImproperlyConfigured, MethodNotAllowed } from './errors'\nimport { handleException } from './exceptions'\nimport {\n CSRF_EXEMPT_MARKER,\n kwargs as getKwargs,\n NoReverseMatch,\n reverse,\n type ViewFunction,\n XFRAME_OPTIONS_EXEMPT_MARKER,\n} from './urls'\n\nexport type { ViewFunction } from './urls'\n\n/** Function returned by `View.asView()`. */\nexport interface AsViewFunction<V extends View = View> extends ViewFunction {\n viewClass: new () => V\n viewInitkwargs: Partial<V>\n}\n\nexport type HttpMethodName = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options' | 'trace'\n\ntype Handler = (c: Context) => Response | Promise<Response>\n\n/**\n * Django's class-based `View`. Subclass it and implement `get` / `post` / … handlers; mount it with\n * `path('x/', MyView.asView())`. A new instance is created for every request.\n *\n * ```ts\n * class Hello extends View {\n * greeting = 'Hello'\n * async get(c: Context) { return c.text(`${this.greeting}, ${this.kwargs.name}`) }\n * }\n * path('hello/<name>/', Hello.asView({ greeting: 'Hi' }))\n * ```\n */\nexport abstract class View {\n static httpMethodNames: HttpMethodName[] = [\n 'get',\n 'post',\n 'put',\n 'patch',\n 'delete',\n 'head',\n 'options',\n 'trace',\n ]\n /** Mark every view produced by `asView()` as CSRF exempt. */\n static csrfExempt = false\n /** Mark every view produced by `asView()` as exempt from `XFrameOptionsMiddleware`. */\n static xframeOptionsExempt = false\n\n /** The Hono context of the current request. */\n c!: Context\n /** The Hono request (Django's `self.request`). */\n request!: HonoRequest\n /** URL parameters (converted), see `kwargs(c)`. */\n kwargs: Record<string, any> = {}\n\n get?(c: Context): Response | Promise<Response>\n post?(c: Context): Response | Promise<Response>\n put?(c: Context): Response | Promise<Response>\n patch?(c: Context): Response | Promise<Response>\n delete?(c: Context): Response | Promise<Response>\n head?(c: Context): Response | Promise<Response>\n trace?(c: Context): Response | Promise<Response>\n\n /** Build a view function. `initkwargs` override instance attributes (like Django). */\n static asView<V extends View>(this: new () => V, initkwargs: Partial<V> = {}): AsViewFunction<V> {\n const cls = this as unknown as (new () => V) & {\n httpMethodNames: HttpMethodName[]\n csrfExempt?: boolean\n xframeOptionsExempt?: boolean\n name: string\n }\n for (const key of Object.keys(initkwargs)) {\n if ((cls.httpMethodNames as string[]).includes(key)) {\n throw new ImproperlyConfigured(\n `The method name ${key} is not accepted as a keyword argument to ${cls.name}.asView().`,\n )\n }\n }\n const view = (async (c: Context) => {\n const self = new cls()\n Object.assign(self, initkwargs)\n self.setup(c)\n return self.dispatch(c)\n }) as AsViewFunction<V>\n view.viewClass = cls\n view.viewInitkwargs = initkwargs\n Object.defineProperty(view, 'name', { value: cls.name })\n if (cls.csrfExempt) (view as any)[CSRF_EXEMPT_MARKER] = true\n if (cls.xframeOptionsExempt) (view as any)[XFRAME_OPTIONS_EXEMPT_MARKER] = true\n return view\n }\n\n /** Initialize attributes shared by all handlers (Django's `setup()`). */\n setup(c: Context): void {\n this.c = c\n this.request = c.req\n this.kwargs = { ...getKwargs(c), ...this.kwargs }\n }\n\n /** Route to the handler for the request method, or `httpMethodNotAllowed`. */\n async dispatch(c: Context): Promise<Response> {\n const method = c.req.method.toLowerCase()\n const names = (this.constructor as typeof View).httpMethodNames as string[]\n let handler: Handler | undefined\n if (names.includes(method)) handler = (this as any)[method]\n if (!handler && method === 'head' && typeof this.get === 'function') handler = this.get\n if (typeof handler !== 'function') return this.httpMethodNotAllowed(c)\n return handler.call(this, c)\n }\n\n /** Allowed HTTP methods (upper case), used for the `Allow` header. */\n allowedMethods(): string[] {\n const names = (this.constructor as typeof View).httpMethodNames as string[]\n const out = names.filter((m) => typeof (this as any)[m] === 'function').map((m) => m.toUpperCase())\n if (out.includes('GET') && !out.includes('HEAD')) out.splice(out.indexOf('GET') + 1, 0, 'HEAD')\n return out\n }\n\n httpMethodNotAllowed(c: Context): Response | Promise<Response> {\n return handleException(new MethodNotAllowed(c.req.method, this.allowedMethods()), c)\n }\n\n /** Default OPTIONS handler: 200 with an `Allow` header. */\n options(_c: Context): Response | Promise<Response> {\n return new Response(null, {\n status: 200,\n headers: { Allow: this.allowedMethods().join(', '), 'Content-Length': '0' },\n })\n }\n}\n\n/** Something renderable by `render()`: a Hono JSX node, a string, or a promise of either. */\nexport type Renderable = unknown\n\nexport interface RenderOptions {\n status?: number\n headers?: Record<string, string>\n /** Prepend `<!DOCTYPE html>` when the output starts with `<html` (default true). */\n doctype?: boolean\n}\n\n/** Render Hono JSX (or an HTML string) to an HTML response. */\nexport async function render(c: Context, node: Renderable, opts: RenderOptions = {}): Promise<Response> {\n let html: string\n const resolved = await node\n if (resolved === null || resolved === undefined || resolved === false) html = ''\n else html = String(await (typeof resolved === 'string' ? resolved : (resolved as any).toString()))\n if (opts.doctype !== false && /^\\s*<html[\\s>]/i.test(html)) html = `<!DOCTYPE html>${html}`\n return c.html(html, (opts.status ?? 200) as any, opts.headers)\n}\n\n/** Template: a Hono JSX component (sync or async) receiving the context data as props. */\nexport type Template<P = any> = (props: P) => unknown\n\n/**\n * Render a JSX `template` with `getContextData()` (Django's TemplateView).\n *\n * ```tsx\n * class About extends TemplateView {\n * template = (p: { title: string }) => <h1>{p.title}</h1>\n * async getContextData() { return { ...(await super.getContextData()), title: 'About us' } }\n * }\n * ```\n */\nexport class TemplateView extends View {\n template?: Template\n /** Extra context merged into every render (Django's `extra_context`). */\n extraContext?: Record<string, unknown>\n status = 200\n\n async getContextData(extra: Record<string, unknown> = {}): Promise<Record<string, any>> {\n return { view: this, ...this.kwargs, ...this.extraContext, ...extra }\n }\n\n getTemplate(): Template {\n if (!this.template) {\n throw new ImproperlyConfigured(\n `${this.constructor.name} requires either a definition of 'template' or an implementation of 'getTemplate()'.`,\n )\n }\n return this.template\n }\n\n async renderToResponse(context: Record<string, any>, opts: RenderOptions = {}): Promise<Response> {\n return render(this.c, jsx(this.getTemplate() as any, context), { status: this.status, ...opts })\n }\n\n override async get(_c: Context): Promise<Response> {\n return this.renderToResponse(await this.getContextData())\n }\n}\n\n/**\n * Redirect to `url` (with `{param}` placeholders filled from the URL kwargs) or to the named `patternName`.\n * Returns 410 Gone when neither is set. Like Django, every method is redirected.\n */\nexport class RedirectView extends View {\n url?: string\n patternName?: string\n permanent = false\n queryString = false\n\n getRedirectUrl(): string | null {\n let url: string\n if (this.url) {\n url = this.url.replace(/\\{(\\w+)\\}|%\\((\\w+)\\)s/g, (m, a, b) => {\n const k = a ?? b\n return k in this.kwargs ? encodeURIComponent(String(this.kwargs[k])) : m\n })\n } else if (this.patternName) {\n url = reverse(this.patternName, this.kwargs)\n } else {\n return null\n }\n const search = new URL(this.c.req.url).search\n if (this.queryString && search) url += url.includes('?') ? `&${search.slice(1)}` : search\n return url\n }\n\n override async get(_c: Context): Promise<Response> {\n const url = this.getRedirectUrl()\n if (url === null) return new Response(null, { status: 410 })\n return new Response(null, { status: this.permanent ? 301 : 302, headers: { Location: url } })\n }\n override head(c: Context) {\n return this.get(c)\n }\n override post(c: Context) {\n return this.get(c)\n }\n override options(c: Context) {\n return this.get(c)\n }\n override delete(c: Context) {\n return this.get(c)\n }\n override put(c: Context) {\n return this.get(c)\n }\n override patch(c: Context) {\n return this.get(c)\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Shortcuts\n// ---------------------------------------------------------------------------------------------\n\nfunction jsonReplacer(_key: string, value: unknown): unknown {\n if (typeof value === 'bigint') return Number.isSafeInteger(Number(value)) ? Number(value) : value.toString()\n if (value instanceof Map) return Object.fromEntries(value)\n if (value instanceof Set) return [...value]\n return value\n}\n\n/** JSON-encode a value the way `json()` does (bigint → number/string, Map → object, Set → array). */\nexport function toJson(data: unknown, space?: number): string {\n return JSON.stringify(data, jsonReplacer, space)\n}\n\n/** JSON response: `return json(c, { ok: true }, 201)`. */\nexport function json(c: Context, data: unknown, status = 200, headers?: Record<string, string>): Response {\n return c.body(toJson(data), status as any, {\n 'Content-Type': 'application/json; charset=UTF-8',\n ...headers,\n })\n}\n\n/**\n * Django's `resolve_url`: a URL name (reversed with `params`), an object with `getAbsoluteUrl()`, or a URL.\n */\nexport function resolveUrl(\n to: string | { getAbsoluteUrl(): string },\n params?: Record<string, unknown> | unknown[],\n): string {\n if (typeof to === 'object' && to && typeof to.getAbsoluteUrl === 'function') return to.getAbsoluteUrl()\n const target = String(to)\n if (/^(\\.\\.?\\/|\\/|[a-z][a-z0-9+.-]*:\\/\\/)/i.test(target)) return target\n try {\n return reverse(target, params)\n } catch (err) {\n if (err instanceof NoReverseMatch && (target.includes('/') || target.includes('.'))) return target\n throw err\n }\n}\n\n/** Redirect to a URL name (`redirect(c, 'blog:detail', { id })`), a model with `getAbsoluteUrl()`, or a URL. */\nexport function redirect(\n c: Context,\n to: string | { getAbsoluteUrl(): string },\n params?: Record<string, unknown> | unknown[],\n opts: { permanent?: boolean; status?: number } = {},\n): Response {\n const status = opts.status ?? (opts.permanent ? 301 : 302)\n return c.redirect(resolveUrl(to, params), status as any)\n}\n"],"mappings":"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","names":["KEY","KEY","settings","redirect","cache","receiver","KEY","settings","caches","KEY"]}
1
+ {"version":3,"sources":["../src/app.ts","../src/commands.ts","../src/apps.ts","../src/checks.ts","../src/middleware.ts","../src/clickjacking.ts","../src/settings.ts","../src/signals.ts","../src/cache.ts","../src/carriers.ts","../src/user.ts","../src/views.ts"],"sourcesContent":["import type { Context } from 'hono'\nimport { Hono } from 'hono'\nimport { apps } from './apps'\nimport { runChecks } from './checks'\nimport {\n createContext,\n type Env,\n type ExecutionContextLike,\n type GhuriContext,\n runWithContext,\n setGlobalContext,\n} from './context'\nimport { ImproperlyConfigured } from './errors'\nimport { type ExceptionHandler, handleException, notFoundHandler } from './exceptions'\nimport { type MiddlewareEntry, toHonoMiddleware, validateHost } from './middleware'\nimport { defineSettings, type GhuriSettings, isSettingsFactory, type SettingsFactory } from './settings'\nimport { requestFinished, requestStarted } from './signals'\nimport { type MessageBatchLike, type ScheduledEventLike, taskHandlers } from './tasks'\nimport { getResolver, type UrlPatterns, type UrlResolver } from './urls'\n\nexport interface CreateAppOptions {\n /** Customize the Hono app. Called after MIDDLEWARE is installed and before the URL patterns. */\n hono?: (app: Hono) => void\n /** Custom error handling. Return a Response to override the default mapping, or undefined to fall through. */\n onError?: ExceptionHandler\n /** Run system checks when the app starts with DEBUG on (default true). */\n checks?: boolean\n}\n\n/** The object a Worker exports (`export default createApp(settings)`). */\nexport interface GhuriApp {\n fetch(request: Request, env?: Env, ctx?: ExecutionContextLike): Promise<Response>\n /** Cron Triggers: dispatches to handlers registered with `onSchedule()`. */\n scheduled(event: ScheduledEventLike, env?: Env, ctx?: ExecutionContextLike): Promise<void>\n /** Queue consumer: dispatches to handlers registered with `onQueue()`. */\n queue(batch: MessageBatchLike, env?: Env, ctx?: ExecutionContextLike): Promise<void>\n /** Populate apps without a request and install a global context (CLI, scripts, tests). */\n setup(env?: Env): Promise<GhuriContext>\n /**\n * Run `fn` inside a fresh Ghuri context (apps populated, settings resolved), like a request without\n * HTTP. Used for work that does not arrive through `fetch`: Durable Object events, WebSocket messages,\n * scripts. Unlike `setup()`, it installs no global context.\n */\n run<T>(\n env: Env | undefined,\n ctx: ExecutionContextLike | undefined,\n fn: (ctx: GhuriContext) => Promise<T>,\n ): Promise<T>\n /** The built Hono router (for testing / composition). Requests through it still get a Ghuri context. */\n hono(env?: Env): Promise<Hono>\n}\n\ninterface Built {\n hono: Hono\n urlconf: UrlResolver\n}\n\nconst EMPTY_ENV: Env = Object.freeze({}) as Env\n\nfunction toFactory(\n settings: SettingsFactory | ((env: Env) => GhuriSettings) | GhuriSettings,\n): SettingsFactory {\n if (isSettingsFactory(settings)) return settings\n if (typeof settings === 'function') return defineSettings(settings)\n if (settings && typeof settings === 'object') return defineSettings(() => settings)\n throw new ImproperlyConfigured('createApp() expects settings created with defineSettings().')\n}\n\nfunction safeExecutionCtx(c: Context): ExecutionContextLike | undefined {\n try {\n return c.executionCtx\n } catch {\n return undefined\n }\n}\n\nfunction reportChecks(messages: Awaited<ReturnType<typeof runChecks>>): void {\n if (!messages.length) return\n const serious = messages.filter((m) => m.isSerious())\n for (const m of messages) (m.isSerious() ? console.error : console.warn)(`System check: ${m.toString()}`)\n if (serious.length) {\n throw new ImproperlyConfigured(\n `System check identified ${serious.length} error(s):\\n${serious.map((m) => m.toString()).join('\\n')}`,\n )\n }\n}\n\n/**\n * Create the application (Django's `wsgi.py`). The returned object is a Workers module handler\n * (`fetch` / `scheduled` / `queue`) and also works with `serve()` from `@ghuri/core/node`.\n */\nexport function createApp(\n settingsInput: SettingsFactory | ((env: Env) => GhuriSettings) | GhuriSettings,\n options: CreateAppOptions = {},\n): GhuriApp {\n const factory = toFactory(settingsInput)\n const builds = new WeakMap<GhuriSettings, Promise<Built>>()\n let app: GhuriApp\n\n const resolveSettings = (env: Env | undefined): GhuriSettings => factory(env ?? EMPTY_ENV)\n\n async function prepare(settings: GhuriSettings, env: Env): Promise<void> {\n const ctx = createContext({ env, settings })\n await runWithContext(ctx, async () => {\n await apps.populate(settings.INSTALLED_APPS)\n if (settings.DEBUG && options.checks !== false) reportChecks(await runChecks({ settings }))\n })\n }\n\n function buildHono(settings: GhuriSettings): Built {\n const urlconf = getResolver(settings.ROOT_URLCONF as UrlPatterns)\n const hono = new Hono()\n\n // 1. Per-request Ghuri context + request signals.\n hono.use('*', async (c, next) => {\n const ctx = createContext({\n env: c.env ?? EMPTY_ENV,\n settings,\n executionCtx: safeExecutionCtx(c),\n request: c.req.raw,\n hono: c,\n })\n c.set('ghuri', ctx)\n await runWithContext(ctx, async () => {\n await requestStarted.send(app, { request: c.req.raw })\n try {\n await next()\n } finally {\n try {\n await requestFinished.send(app, { request: c.req.raw, response: c.res })\n } catch (err) {\n console.error('requestFinished receiver failed:', err)\n }\n }\n })\n })\n // 2. ALLOWED_HOSTS.\n hono.use('*', async (_c, next) => {\n validateHost(_c)\n await next()\n })\n // 3. MIDDLEWARE, in order.\n for (const entry of settings.MIDDLEWARE ?? []) hono.use('*', toHonoMiddleware(entry as MiddlewareEntry))\n // 4. User customization, then URL patterns.\n options.hono?.(hono)\n urlconf.mount(hono)\n // 5. Error handling.\n hono.notFound(notFoundHandler(urlconf))\n hono.onError(async (err, c) => {\n if (options.onError) {\n const res = await options.onError(err, c)\n if (res instanceof Response) return res\n }\n return handleException(err, c)\n })\n return { hono, urlconf }\n }\n\n function getBuilt(settings: GhuriSettings, env: Env): Promise<Built> {\n let p = builds.get(settings)\n if (!p) {\n p = prepare(settings, env).then(() => buildHono(settings))\n p.catch(() => builds.delete(settings))\n builds.set(settings, p)\n }\n return p\n }\n\n function startupFailure(err: unknown, settings: GhuriSettings | undefined): Response {\n console.error('Ghuri failed to start:', err)\n const debug = settings?.DEBUG\n const body = debug\n ? `Ghuri failed to start.\\n\\n${(err as Error)?.stack ?? String(err)}`\n : 'Internal Server Error'\n return new Response(body, { status: 500, headers: { 'content-type': 'text/plain; charset=UTF-8' } })\n }\n\n async function withTaskContext<T>(\n env: Env | undefined,\n execCtx: ExecutionContextLike | undefined,\n fn: (ctx: GhuriContext) => Promise<T>,\n ): Promise<T> {\n const e = env ?? EMPTY_ENV\n const settings = resolveSettings(e)\n await getBuilt(settings, e)\n const ctx = createContext({ env: e, settings, executionCtx: execCtx })\n return runWithContext(ctx, () => fn(ctx))\n }\n\n app = {\n async fetch(request, env, ctx) {\n const e = env ?? EMPTY_ENV\n let settings: GhuriSettings | undefined\n let built: Built\n try {\n settings = resolveSettings(e)\n built = await getBuilt(settings, e)\n } catch (err) {\n return startupFailure(err, settings)\n }\n return built.hono.fetch(request, e, ctx as any)\n },\n\n async scheduled(event, env, ctx) {\n await withTaskContext(env, ctx, async (gctx) => {\n const handlers = taskHandlers.schedulesFor(event.cron)\n if (!handlers.length) console.warn(`No onSchedule() handler registered for cron '${event.cron}'.`)\n const errors: unknown[] = []\n for (const h of handlers) {\n try {\n await h(event, gctx)\n } catch (err) {\n console.error(`Scheduled handler for '${event.cron}' failed:`, err)\n errors.push(err)\n }\n }\n if (errors.length === 1) throw errors[0]\n if (errors.length > 1) throw new AggregateError(errors, `${errors.length} scheduled handlers failed.`)\n })\n },\n\n async queue(batch, env, ctx) {\n await withTaskContext(env, ctx, async (gctx) => {\n const handlers = taskHandlers.queuesFor(batch.queue)\n if (!handlers.length) {\n throw new ImproperlyConfigured(`No onQueue() handler registered for queue '${batch.queue}'.`)\n }\n for (const h of handlers) await h(batch, gctx)\n })\n },\n\n async setup(env) {\n const e = env ?? EMPTY_ENV\n const settings = resolveSettings(e)\n await getBuilt(settings, e)\n const ctx = createContext({ env: e, settings })\n setGlobalContext(ctx)\n return ctx\n },\n\n run(env, ctx, fn) {\n return withTaskContext(env, ctx, fn)\n },\n\n async hono(env) {\n const e = env ?? EMPTY_ENV\n return (await getBuilt(resolveSettings(e), e)).hono\n },\n }\n return app\n}\n","import { GhuriError } from './errors'\n\nexport class CommandError extends GhuriError {\n constructor(\n message: string,\n readonly returncode = 1,\n ) {\n super(message)\n }\n}\n\nexport interface ArgumentSpec {\n name: string\n help?: string\n required?: boolean\n variadic?: boolean\n default?: unknown\n}\n\nexport interface OptionSpec {\n /** e.g. '--remote', '-n, --name <value>', '--no-input' */\n flags: string\n help?: string\n default?: unknown\n}\n\n/** Minimal parser description; the CLI turns it into real argv parsing. */\nexport class ArgumentParser {\n readonly arguments: ArgumentSpec[] = []\n readonly options: OptionSpec[] = []\n\n argument(name: string, opts: Omit<ArgumentSpec, 'name'> = {}): this {\n this.arguments.push({ name, ...opts })\n return this\n }\n\n option(flags: string, opts: Omit<OptionSpec, 'flags'> = {}): this {\n this.options.push({ flags, ...opts })\n return this\n }\n}\n\nexport interface CommandStyle {\n success(s: string): string\n warning(s: string): string\n error(s: string): string\n notice(s: string): string\n bold(s: string): string\n}\n\nexport interface CommandIO {\n stdout(msg: string): void\n stderr(msg: string): void\n style: CommandStyle\n /** Interactive prompt. Undefined when running non-interactively. */\n prompt?(question: string, opts?: { password?: boolean; default?: string }): Promise<string>\n confirm?(question: string, opts?: { default?: boolean }): Promise<boolean>\n}\n\n/** Django's BaseCommand. */\nexport abstract class BaseCommand {\n static help = ''\n addArguments?(parser: ArgumentParser): void\n abstract handle(args: Record<string, unknown>, io: CommandIO): Promise<void | number>\n}\n\nexport type CommandClass = (new () => BaseCommand) & { help?: string }\n\nexport class CommandRegistry {\n private commands = new Map<string, CommandClass>()\n\n register(name: string, cls: CommandClass): void {\n this.commands.set(name, cls)\n }\n\n get(name: string): CommandClass | undefined {\n return this.commands.get(name)\n }\n\n all(): Map<string, CommandClass> {\n return new Map(this.commands)\n }\n}\n\nconst KEY = Symbol.for('ghuri.core.commands')\nexport const commandRegistry: CommandRegistry = ((globalThis as any)[KEY] ??= new CommandRegistry())\n\nconst identity = (s: string) => s\nexport const plainStyle: CommandStyle = {\n success: identity,\n warning: identity,\n error: identity,\n notice: identity,\n bold: identity,\n}\n\n/** IO that collects output — handy for tests (`callCommand`). */\nexport function bufferIO(): CommandIO & { out: string[]; err: string[] } {\n const out: string[] = []\n const err: string[] = []\n return { out, err, stdout: (m) => out.push(m), stderr: (m) => err.push(m), style: plainStyle }\n}\n\n/** Run a command programmatically (Django's call_command). */\nexport async function callCommand(\n nameOrClass: string | CommandClass,\n args: Record<string, unknown> = {},\n io: CommandIO = bufferIO(),\n): Promise<void | number> {\n const cls = typeof nameOrClass === 'string' ? commandRegistry.get(nameOrClass) : nameOrClass\n if (!cls) throw new CommandError(`Unknown command: '${String(nameOrClass)}'`)\n return new cls().handle(args, io)\n}\n","import { type CommandClass, commandRegistry } from './commands'\nimport { AppRegistryNotReady, ImproperlyConfigured } from './errors'\n\nexport type CommandClassLike = new () => {\n handle(args: Record<string, unknown>, io: any): Promise<void | number>\n}\n\n/** Django's AppConfig. Subclass it in `src/<app>/app.ts`. */\nexport abstract class AppConfig {\n abstract name: string\n label?: string\n verboseName?: string\n /** Directory of the app (`import.meta.dirname`). Only used by the CLI (migrations). */\n path?: string\n /** `import * as models from './models'` — every Model class found is registered to this app. */\n models?: Record<string, unknown> | unknown[]\n /** `import * as migrations from './migrations'` (index generated by makemigrations). */\n migrations?: Record<string, unknown>\n /** `import * as admin from './admin'` — importing the module registers ModelAdmins. */\n admin?: unknown\n /** `import * as tasks from './tasks'` — background tasks (`@ghuri/tasks`), named `<app label>.<export name>`. */\n tasks?: Record<string, unknown>\n /** Agents, signals or any other module the app wants loaded at startup. */\n modules?: Record<string, unknown>\n commands?: Record<string, CommandClassLike>\n ready?(): void | Promise<void>\n\n get appLabel(): string {\n return this.label ?? this.name.split(/[./]/).pop()!\n }\n\n get displayName(): string {\n return this.verboseName ?? this.appLabel.charAt(0).toUpperCase() + this.appLabel.slice(1)\n }\n}\n\nexport type AppConfigClass = new () => AppConfig\n\ntype PopulateHook = (registry: AppRegistry) => void | Promise<void>\n\nexport class AppRegistry {\n private configs = new Map<string, AppConfig>()\n private models = new Map<string, Map<string, unknown>>() // appLabel → lower model name → model\n private hooks: PopulateHook[] = []\n private populating: Promise<void> | null = null\n private _ready = false\n private installedKey: unknown = null\n\n get ready(): boolean {\n return this._ready\n }\n\n /** Packages (the ORM) register hooks that run after configs are created and before `ready()`. */\n onPopulate(hook: PopulateHook): void {\n this.hooks.push(hook)\n }\n\n /** Idempotent for the same INSTALLED_APPS array. Re-populates if a different list is passed (tests). */\n populate(installed: Array<AppConfigClass | AppConfig>): Promise<void> {\n if (this.populating && sameApps(this.installedKey, installed)) return this.populating\n if (this.installedKey !== null && !sameApps(this.installedKey, installed)) this.reset()\n this.installedKey = installed\n this.populating = this.doPopulate(installed).catch((err) => {\n this.reset()\n throw err\n })\n return this.populating\n }\n\n private async doPopulate(installed: Array<AppConfigClass | AppConfig>): Promise<void> {\n for (const entry of installed) {\n const config = typeof entry === 'function' ? new (entry as AppConfigClass)() : entry\n if (!(config instanceof AppConfig) && typeof (config as any)?.name !== 'string') {\n throw new ImproperlyConfigured(`INSTALLED_APPS entry ${String(entry)} is not an AppConfig.`)\n }\n const label = (config as AppConfig).appLabel\n if (this.configs.has(label)) {\n throw new ImproperlyConfigured(`Application labels aren't unique, duplicates: ${label}`)\n }\n this.configs.set(label, config as AppConfig)\n if (!this.models.has(label)) this.models.set(label, new Map())\n for (const [name, cls] of Object.entries((config as AppConfig).commands ?? {})) {\n commandRegistry.register(name, cls as unknown as CommandClass)\n }\n }\n for (const hook of this.hooks) await hook(this)\n for (const config of this.configs.values()) await config.ready?.()\n this._ready = true\n }\n\n /** Clear everything (tests). Hooks stay registered. */\n reset(): void {\n this.configs.clear()\n this.models.clear()\n this.populating = null\n this.installedKey = null\n this._ready = false\n }\n\n getAppConfigs(): AppConfig[] {\n return [...this.configs.values()]\n }\n\n getAppConfig(label: string): AppConfig {\n const c = this.configs.get(label)\n if (!c) throw new LookupError(`No installed app with label '${label}'.`)\n return c\n }\n\n isInstalled(label: string): boolean {\n return this.configs.has(label)\n }\n\n registerModel(appLabel: string, model: unknown): void {\n const name = modelName(model)\n let bucket = this.models.get(appLabel)\n if (!bucket) {\n bucket = new Map()\n this.models.set(appLabel, bucket)\n }\n const existing = bucket.get(name)\n if (existing && existing !== model) {\n throw new ImproperlyConfigured(`Conflicting '${name}' models in application '${appLabel}'.`)\n }\n bucket.set(name, model)\n }\n\n getModels(appLabel?: string): unknown[] {\n if (appLabel) return [...(this.models.get(appLabel)?.values() ?? [])]\n return [...this.models.values()].flatMap((m) => [...m.values()])\n }\n\n /** `getModel('blog.Post')` or `getModel('blog', 'post')` (case-insensitive model name). */\n getModel(appLabelOrDotted: string, name?: string): unknown {\n let app = appLabelOrDotted\n let model = name\n if (model === undefined) {\n const idx = appLabelOrDotted.lastIndexOf('.')\n if (idx < 0)\n throw new LookupError(`Model label must be 'app_label.ModelName', got '${appLabelOrDotted}'.`)\n app = appLabelOrDotted.slice(0, idx)\n model = appLabelOrDotted.slice(idx + 1)\n }\n const found = this.models.get(app)?.get(model.toLowerCase())\n if (!found) {\n if (!this._ready && !this.populating) throw new AppRegistryNotReady(\"Models aren't loaded yet.\")\n throw new LookupError(`App '${app}' doesn't have a '${model}' model.`)\n }\n return found\n }\n}\n\nexport class LookupError extends ImproperlyConfigured {}\n\n/** Same INSTALLED_APPS (identical array, or same entries in the same order — settings resolved per env). */\nfunction sameApps(a: unknown, b: unknown[]): boolean {\n if (a === b) return true\n if (!Array.isArray(a) || a.length !== b.length) return false\n return a.every((x, i) => x === b[i])\n}\n\nfunction modelName(model: unknown): string {\n const m = model as any\n return String(m?._meta?.modelName ?? m?.name ?? '').toLowerCase()\n}\n\n// Singleton shared across duplicate module instances.\nconst KEY = Symbol.for('ghuri.core.apps')\nexport const apps: AppRegistry = ((globalThis as any)[KEY] ??= new AppRegistry())\n\nexport function ensureAppsReady(): void {\n if (!apps.ready) throw new AppRegistryNotReady(\"Apps aren't loaded yet.\")\n}\n","import { type AppConfig, apps } from './apps'\nimport { tryGetContext } from './context'\nimport { ImproperlyConfigured } from './errors'\nimport type { GhuriSettings } from './settings'\nimport { getResolver, type UrlPatterns } from './urls'\n\n/** Check levels (same numbers as Django). */\nexport const CheckLevel = { DEBUG: 10, INFO: 20, WARNING: 30, ERROR: 40, CRITICAL: 50 } as const\nconst { DEBUG, INFO, WARNING, ERROR, CRITICAL } = CheckLevel\n\nconst LEVEL_NAMES: Record<number, string> = {\n 10: 'DEBUG',\n 20: 'INFO',\n 30: 'WARNING',\n 40: 'ERROR',\n 50: 'CRITICAL',\n}\n\n/** One system-check result (Django's CheckMessage). */\nexport class CheckMessage {\n constructor(\n readonly level: number,\n readonly msg: string,\n readonly opts: { hint?: string; id?: string; obj?: unknown } = {},\n ) {}\n\n get hint(): string | undefined {\n return this.opts.hint\n }\n get id(): string | undefined {\n return this.opts.id\n }\n get obj(): unknown {\n return this.opts.obj\n }\n get levelName(): string {\n return LEVEL_NAMES[this.level] ?? String(this.level)\n }\n /** ERROR or worse. */\n isSerious(level = ERROR): boolean {\n return this.level >= level\n }\n toString(): string {\n const obj =\n this.obj === undefined\n ? '?'\n : typeof this.obj === 'function'\n ? (this.obj as any).name\n : String(this.obj)\n return `${obj}: (${this.id ?? this.levelName}) ${this.msg}${this.hint ? `\\n\\tHINT: ${this.hint}` : ''}`\n }\n}\n\nexport interface CheckContext {\n settings: GhuriSettings\n appConfigs: AppConfig[]\n /** True for `ghuri check --deploy`. */\n deploy: boolean\n}\n\nexport type CheckFunction = (\n ctx: CheckContext,\n) => CheckMessage[] | undefined | Promise<CheckMessage[] | undefined>\n\ninterface RegisteredCheck {\n fn: CheckFunction\n tags: string[]\n deployOnly: boolean\n}\n\nclass CheckRegistry {\n private registered: RegisteredCheck[] = []\n\n /** Register a check: `checks.register(fn, { tags: ['models'] })`. Deploy-only checks run with `deploy: true`. */\n register(fn: CheckFunction, opts: { tags?: string[]; deploy?: boolean } = {}): CheckFunction {\n if (!this.registered.some((r) => r.fn === fn)) {\n this.registered.push({ fn, tags: opts.tags ?? [], deployOnly: !!opts.deploy })\n }\n return fn\n }\n\n unregister(fn: CheckFunction): void {\n this.registered = this.registered.filter((r) => r.fn !== fn)\n }\n\n get tags(): string[] {\n return [...new Set(this.registered.flatMap((r) => r.tags))]\n }\n\n all(): RegisteredCheck[] {\n return [...this.registered]\n }\n\n debug = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(DEBUG, msg, opts)\n info = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(INFO, msg, opts)\n warning = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(WARNING, msg, opts)\n error = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(ERROR, msg, opts)\n critical = (msg: string, opts?: CheckMessage['opts']) => new CheckMessage(CRITICAL, msg, opts)\n}\n\nconst KEY = Symbol.for('ghuri.core.checks')\n/** The system check registry. */\nexport const checks: CheckRegistry = ((globalThis as any)[KEY] ??= new CheckRegistry())\n\nexport interface RunChecksOptions {\n tags?: string[]\n deploy?: boolean\n settings?: GhuriSettings\n /** Silence messages by id (Django's SILENCED_SYSTEM_CHECKS; also read from settings). */\n silenced?: string[]\n}\n\n/** Run registered checks. Uses the current context's settings unless given. */\nexport async function runChecks(opts: RunChecksOptions = {}): Promise<CheckMessage[]> {\n const settings = opts.settings ?? tryGetContext()?.settings\n if (!settings)\n throw new ImproperlyConfigured('runChecks() needs settings (run inside a Ghuri context or pass them).')\n const silenced = new Set([\n ...(opts.silenced ?? []),\n ...((settings.SILENCED_SYSTEM_CHECKS as string[]) ?? []),\n ])\n const ctx: CheckContext = {\n settings,\n appConfigs: apps.ready ? apps.getAppConfigs() : [],\n deploy: !!opts.deploy,\n }\n const out: CheckMessage[] = []\n for (const r of checks.all()) {\n if (r.deployOnly && !opts.deploy) continue\n if (opts.tags?.length && !r.tags.some((t) => opts.tags!.includes(t))) continue\n let msgs: CheckMessage[] | undefined\n try {\n msgs = await r.fn(ctx)\n } catch (err) {\n msgs = [\n new CheckMessage(ERROR, `Check ${r.fn.name || '(anonymous)'} raised: ${(err as Error).message}`, {\n id: 'core.E000',\n }),\n ]\n }\n for (const m of msgs ?? []) if (!m.id || !silenced.has(m.id)) out.push(m)\n }\n return out\n}\n\n// ---------------------------------------------------------------------------------------------\n// Built-in checks\n// ---------------------------------------------------------------------------------------------\n\nfunction checkUrls({ settings }: CheckContext): CheckMessage[] {\n const out: CheckMessage[] = []\n const walk = (patterns: UrlPatterns) => {\n for (const p of patterns) {\n if (!p.regex && p.route.startsWith('/') && p.route !== '/') {\n out.push(\n checks.warning(\n `Your URL pattern '${p.route}' has a route beginning with a '/'. Remove this slash as it is unnecessary.`,\n { id: 'urls.W002' },\n ),\n )\n }\n if (p.name?.includes(':')) {\n out.push(\n checks.warning(`Your URL pattern '${p.route}' has a name including a ':'.`, {\n id: 'urls.W003',\n hint: 'Use namespaces instead.',\n }),\n )\n }\n if (p.children) walk(p.children)\n }\n }\n try {\n walk(settings.ROOT_URLCONF as UrlPatterns)\n getResolver(settings.ROOT_URLCONF as UrlPatterns)\n } catch (err) {\n out.push(checks.error((err as Error).message, { id: 'urls.E004' }))\n }\n return out\n}\n\nfunction checkMiddleware({ settings }: CheckContext): CheckMessage[] {\n const out: CheckMessage[] = []\n for (const m of settings.MIDDLEWARE ?? []) {\n if (typeof m !== 'function' && !(m && typeof (m as any).handle === 'function')) {\n out.push(\n checks.error(`MIDDLEWARE entry ${String(m)} is neither a Middleware nor a Hono middleware.`, {\n id: 'core.E001',\n }),\n )\n }\n }\n return out\n}\n\nfunction checkSecurity({ settings }: CheckContext): CheckMessage[] {\n const out: CheckMessage[] = []\n const names = (settings.MIDDLEWARE ?? []).map((m: any) => m?.name ?? m?.constructor?.name)\n if (settings.DEBUG) {\n out.push(checks.warning('You should not have DEBUG set to true in deployment.', { id: 'security.W018' }))\n }\n const key = String(settings.SECRET_KEY ?? '')\n if (\n key.length < 50 ||\n new Set(key).size < 5 ||\n key.startsWith('django-insecure-') ||\n key.startsWith('ghuri-insecure-')\n ) {\n out.push(\n checks.warning(\n 'Your SECRET_KEY has less than 50 characters, less than 5 unique characters, or is prefixed with \"ghuri-insecure-\".',\n {\n id: 'security.W009',\n hint: 'Generate a long random value and store it as a secret (wrangler secret put SECRET_KEY).',\n },\n ),\n )\n }\n if (!names.includes('SecurityMiddleware')) {\n out.push(\n checks.warning(\"You do not have 'SecurityMiddleware' in your MIDDLEWARE.\", { id: 'security.W001' }),\n )\n }\n if (!names.includes('CsrfMiddleware')) {\n out.push(\n checks.warning(\"You don't appear to be using Ghuri's CSRF protection middleware.\", {\n id: 'security.W003',\n }),\n )\n }\n if (!settings.SECURE_HSTS_SECONDS) {\n out.push(\n checks.warning('You have not set a value for the SECURE_HSTS_SECONDS setting.', {\n id: 'security.W004',\n }),\n )\n }\n if (!settings.CSRF_COOKIE_SECURE) {\n out.push(checks.warning('You have not set CSRF_COOKIE_SECURE to true.', { id: 'security.W016' }))\n }\n if ((settings.ALLOWED_HOSTS ?? ['*']).length === 0) {\n out.push(checks.warning('ALLOWED_HOSTS must not be empty in deployment.', { id: 'security.W020' }))\n }\n return out\n}\n\nchecks.register(checkUrls, { tags: ['urls'] })\nchecks.register(checkMiddleware, { tags: ['middleware'] })\nchecks.register(checkSecurity, { tags: ['security'], deploy: true })\n","import type { Context, MiddlewareHandler, Next } from 'hono'\nimport { compress } from 'hono/compress'\nimport { cors } from 'hono/cors'\nimport { isXFrameOptionsExempt } from './clickjacking'\nimport {\n CSRF_SAFE_METHODS,\n CsrfFailure,\n checkCsrf,\n getHost,\n hostMatches,\n isCsrfExempt,\n isSecure,\n setCsrfCookieIfNeeded,\n} from './csrf'\nimport { DisallowedHost } from './errors'\nimport { appendSlashRedirect, settingsFor } from './exceptions'\nimport type { GhuriSettings } from './settings'\n\n/**\n * Django-style middleware: wraps the rest of the chain.\n *\n * ```ts\n * class TimingMiddleware extends Middleware {\n * async handle(c: Context, next: Next) {\n * const t = Date.now()\n * await next()\n * c.header('Server-Timing', `app;dur=${Date.now() - t}`)\n * }\n * }\n * ```\n * Return a Response (before or after `next()`) to replace the response.\n */\nexport abstract class Middleware {\n abstract handle(c: Context, next: Next): Promise<Response | void>\n}\n\nexport type MiddlewareClass = new () => Middleware\n\n/** What `MIDDLEWARE` accepts: a Middleware class, an instance (for options), or a plain Hono middleware. */\nexport type MiddlewareEntry = MiddlewareClass | Middleware | MiddlewareHandler\n\nfunction isMiddlewareClass(v: unknown): v is MiddlewareClass {\n return typeof v === 'function' && typeof (v as any).prototype?.handle === 'function'\n}\n\n/** Convert a `MIDDLEWARE` entry into a Hono middleware handler. */\nexport function toHonoMiddleware(entry: MiddlewareEntry): MiddlewareHandler {\n let instance: Middleware | undefined\n if (isMiddlewareClass(entry)) instance = new entry()\n else if (entry && typeof entry === 'object' && typeof (entry as Middleware).handle === 'function')\n instance = entry as Middleware\n else if (typeof entry === 'function') return entry as MiddlewareHandler\n if (!instance) throw new TypeError(`Invalid MIDDLEWARE entry: ${String(entry)}`)\n const mw = instance\n const handler: MiddlewareHandler = async (c, next) => {\n let called = false\n const res = await mw.handle(c, async () => {\n called = true\n await next()\n })\n if (res instanceof Response && res !== c.res) {\n // Replace cleanly instead of merging the previous response's headers.\n if (called) c.res = undefined as any\n c.res = res\n }\n }\n Object.defineProperty(handler, 'name', { value: mw.constructor.name })\n return handler\n}\n\nfunction settings(c: Context): GhuriSettings {\n return (settingsFor(c) ?? {}) as GhuriSettings\n}\n\nfunction setIfMissing(c: Context, name: string, value: string): void {\n if (!c.res.headers.has(name)) c.header(name, value)\n}\n\n// ---------------------------------------------------------------------------------------------\n// Host validation (ALLOWED_HOSTS)\n// ---------------------------------------------------------------------------------------------\n\n/** Django's ALLOWED_HOSTS matching: `'*'`, exact hosts, or `'.example.com'` (domain + subdomains). */\nexport function isAllowedHost(host: string, allowed: string[]): boolean {\n const domain = host.startsWith('[') ? host.slice(0, host.indexOf(']') + 1) : host.replace(/:\\d+$/, '')\n return allowed.some((p) => p === '*' || hostMatches(domain.replace(/\\.$/, ''), p))\n}\n\n/** Throws `DisallowedHost` (400) when the Host header is not in ALLOWED_HOSTS. */\nexport function validateHost(c: Context): void {\n const s = settings(c)\n let allowed = s.ALLOWED_HOSTS ?? ['*']\n if (allowed.length === 0 && s.DEBUG) allowed = ['.localhost', '127.0.0.1', '[::1]']\n if (allowed.includes('*')) return\n const host = getHost(c)\n if (!isAllowedHost(host, allowed)) {\n const domain = host.replace(/:\\d+$/, '')\n throw new DisallowedHost(\n `Invalid HTTP_HOST header: '${host}'. You may need to add '${domain}' to ALLOWED_HOSTS.`,\n )\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Built-ins\n// ---------------------------------------------------------------------------------------------\n\n/**\n * Security headers (Django's SecurityMiddleware). Settings: `SECURE_SSL_REDIRECT`, `SECURE_SSL_HOST`,\n * `SECURE_REDIRECT_EXEMPT`, `SECURE_HSTS_SECONDS` (HSTS is sent on https only, when > 0),\n * `SECURE_HSTS_INCLUDE_SUBDOMAINS`, `SECURE_HSTS_PRELOAD`, `SECURE_CONTENT_TYPE_NOSNIFF` (default true),\n * `SECURE_REFERRER_POLICY` (default 'same-origin'), `SECURE_CROSS_ORIGIN_OPENER_POLICY` (default 'same-origin').\n */\nexport class SecurityMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<Response | void> {\n const s = settings(c)\n const secure = isSecure(c)\n if (s.SECURE_SSL_REDIRECT && !secure) {\n const exempt = ((s.SECURE_REDIRECT_EXEMPT as string[] | undefined) ?? []).some((re) =>\n new RegExp(re).test(c.req.path.replace(/^\\//, '')),\n )\n if (!exempt) {\n const url = new URL(c.req.url)\n const host = (s.SECURE_SSL_HOST as string | undefined) ?? getHost(c)\n return new Response(null, {\n status: 301,\n headers: { Location: `https://${host}${url.pathname}${url.search}` },\n })\n }\n }\n await next()\n const hsts = Number(s.SECURE_HSTS_SECONDS ?? 0)\n if (secure && hsts > 0) {\n let v = `max-age=${hsts}`\n if (s.SECURE_HSTS_INCLUDE_SUBDOMAINS) v += '; includeSubDomains'\n if (s.SECURE_HSTS_PRELOAD) v += '; preload'\n setIfMissing(c, 'Strict-Transport-Security', v)\n }\n if (s.SECURE_CONTENT_TYPE_NOSNIFF !== false) setIfMissing(c, 'X-Content-Type-Options', 'nosniff')\n const referrer = s.SECURE_REFERRER_POLICY === undefined ? 'same-origin' : s.SECURE_REFERRER_POLICY\n if (referrer)\n setIfMissing(c, 'Referrer-Policy', Array.isArray(referrer) ? referrer.join(',') : String(referrer))\n const coop =\n s.SECURE_CROSS_ORIGIN_OPENER_POLICY === undefined ? 'same-origin' : s.SECURE_CROSS_ORIGIN_OPENER_POLICY\n if (coop) setIfMissing(c, 'Cross-Origin-Opener-Policy', String(coop))\n }\n}\n\n/**\n * `X-Frame-Options` header (setting `X_FRAME_OPTIONS`, default 'DENY'). Responses that set it keep theirs;\n * views wrapped in `xframeOptionsExempt()` (or class views with `static xframeOptionsExempt = true`) get none.\n */\nexport class XFrameOptionsMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<void> {\n await next()\n if (isXFrameOptionsExempt(c)) return\n const v = (settings(c).X_FRAME_OPTIONS as string | undefined) ?? 'DENY'\n if (v) setIfMissing(c, 'X-Frame-Options', v.toUpperCase())\n }\n}\n\n/**\n * Django's CommonMiddleware: rejects hosts not in `ALLOWED_HOSTS`, `PREPEND_WWW` redirects, and\n * `APPEND_SLASH` (301 from `/x` to `/x/` for GET/HEAD when only the slashed path matches).\n */\nexport class CommonMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<Response | void> {\n validateHost(c)\n const s = settings(c)\n const host = getHost(c)\n if (s.PREPEND_WWW && host && !host.startsWith('www.')) {\n const url = new URL(c.req.url)\n return new Response(null, {\n status: 301,\n headers: { Location: `${url.protocol}//www.${host}${url.pathname}${url.search}` },\n })\n }\n await next()\n if (c.res.status === 404 && s.APPEND_SLASH !== false) {\n const redirect = appendSlashRedirect(c)\n if (redirect) return redirect\n }\n }\n}\n\nexport interface CorsOptions {\n allowOrigins: string[] | '*'\n allowCredentials?: boolean\n allowMethods?: string[]\n allowHeaders?: string[]\n exposeHeaders?: string[]\n maxAge?: number\n}\n\n/**\n * CORS headers and preflight handling. Configure with the `CORS` setting\n * (`{ allowOrigins: ['https://app.example.com'], allowCredentials: true }`) or `new CorsMiddleware({...})`.\n */\nexport class CorsMiddleware extends Middleware {\n private cache = new WeakMap<object, MiddlewareHandler>()\n\n constructor(private readonly options?: CorsOptions) {\n super()\n }\n\n private handlerFor(opts: CorsOptions): MiddlewareHandler {\n let h = this.cache.get(opts)\n if (!h) {\n const all = opts.allowOrigins === '*'\n const list = all ? [] : (opts.allowOrigins as string[])\n h = cors({\n origin:\n all && !opts.allowCredentials\n ? '*'\n : (origin) => (all || list.includes(origin) || list.includes('*') ? origin : null),\n credentials: opts.allowCredentials,\n allowMethods: opts.allowMethods ?? ['GET', 'HEAD', 'PUT', 'POST', 'DELETE', 'PATCH', 'OPTIONS'],\n allowHeaders: opts.allowHeaders ?? [],\n exposeHeaders: opts.exposeHeaders ?? [],\n maxAge: opts.maxAge ?? 86400,\n })\n this.cache.set(opts, h)\n }\n return h\n }\n\n async handle(c: Context, next: Next): Promise<Response | void> {\n const opts = this.options ?? (settings(c).CORS as CorsOptions | false | undefined)\n if (!opts) return next()\n const res = await this.handlerFor(opts)(c, next)\n return res instanceof Response ? res : undefined\n }\n}\n\n/**\n * Cross-site request forgery protection (Django's CsrfViewMiddleware). Unsafe requests (POST, PUT, PATCH,\n * DELETE) must send the `csrftoken` cookie's token in the `X-CSRFToken` header or the `csrfmiddlewaretoken`\n * form field, and pass Origin/Referer checks against the host and `CSRF_TRUSTED_ORIGINS`.\n * Exempt views with `csrfExempt(view)`; read the token with `getCsrfToken(c)`.\n */\nexport class CsrfMiddleware extends Middleware {\n async handle(c: Context, next: Next): Promise<void> {\n if (!CSRF_SAFE_METHODS.has(c.req.method) && !isCsrfExempt(c)) {\n const reason = await checkCsrf(c)\n if (reason) throw new CsrfFailure(reason)\n }\n await next()\n setCsrfCookieIfNeeded(c)\n }\n}\n\nconst isWorkers = () => (globalThis as any).navigator?.userAgent === 'Cloudflare-Workers'\n\n/**\n * Compress responses (gzip/deflate). A no-op on Cloudflare Workers, where the edge compresses for you.\n */\nexport class GZipMiddleware extends Middleware {\n private compressor: MiddlewareHandler | undefined\n\n async handle(c: Context, next: Next): Promise<void> {\n if (isWorkers() || typeof (globalThis as any).CompressionStream === 'undefined') return next()\n this.compressor ??= compress()\n await this.compressor(c, next)\n }\n}\n","import type { Context } from 'hono'\nimport { viewHasMarker } from './markers'\nimport { XFRAME_OPTIONS_EXEMPT_MARKER } from './urls'\n\n/**\n * Mark a view (or a mounted Hono app) as exempt from `XFrameOptionsMiddleware` (Django's\n * `xframe_options_exempt`): its responses get no `X-Frame-Options` header from the middleware, so other\n * sites can frame it. A header the view sets itself is always kept. For class views, set\n * `static xframeOptionsExempt = true`.\n *\n * ```ts\n * path('embed/', xframeOptionsExempt(embedView))\n * ```\n */\nexport function xframeOptionsExempt<T extends object>(view: T): T {\n ;(view as any)[XFRAME_OPTIONS_EXEMPT_MARKER] = true\n return view\n}\n\n/** Is the request's view exempt from `XFrameOptionsMiddleware`? */\nexport function isXFrameOptionsExempt(c: Context): boolean {\n return viewHasMarker(c, XFRAME_OPTIONS_EXEMPT_MARKER)\n}\n","import type { Context, MiddlewareHandler } from 'hono'\nimport type { AppConfig, AppConfigClass } from './apps'\nimport type { CacheConfig } from './cache'\nimport { type Env, getContext } from './context'\nimport { type Http404, ImproperlyConfigured, type ObjectDoesNotExist } from './errors'\nimport type { CorsOptions, Middleware } from './middleware'\nimport type { UrlPatterns } from './urls'\n\n/** What `ROOT_URLCONF` accepts (see `path()` / `include()` in urls.ts). */\nexport type UrlPatternsLike = UrlPatterns\n/** What `MIDDLEWARE` accepts: a Middleware class, a configured Middleware instance, or a plain Hono middleware. */\nexport type MiddlewareLike =\n | (new () => { handle(c: any, next: () => Promise<void>): Promise<Response | void> })\n | Middleware\n | MiddlewareHandler\n\n/**\n * A custom error view (Django's `handler404` / `handler500`): receives the request context and the\n * exception, returns the response.\n */\nexport type ErrorView<E = unknown> = (c: Context<any, any, any>, exception: E) => Response | Promise<Response>\n\n/**\n * Project settings. Other packages add keys with declaration merging:\n *\n * ```ts\n * declare module '@ghuri/core' { interface GhuriSettings { DATABASES: Record<string, DatabaseConfig> } }\n * ```\n */\nexport interface GhuriSettings {\n SECRET_KEY: string\n DEBUG?: boolean\n ALLOWED_HOSTS?: string[]\n INSTALLED_APPS: Array<AppConfigClass | AppConfig>\n MIDDLEWARE?: MiddlewareLike[]\n ROOT_URLCONF: UrlPatternsLike\n APPEND_SLASH?: boolean\n /**\n * Custom 404 view (Django's `handler404`). Called with `DEBUG` off for unmatched paths (after the\n * `APPEND_SLASH` redirect and 405 checks) and for `Http404` / `ObjectDoesNotExist` raised by views\n * or middleware. If it throws, the default 404 page is used.\n */\n HANDLER_404?: ErrorView<Http404 | ObjectDoesNotExist>\n /**\n * Custom 500 view (Django's `handler500`). Called with `DEBUG` off for uncaught exceptions (errors\n * not mapped to an HTTP status). If it throws, the default 500 page is used.\n */\n HANDLER_500?: ErrorView<unknown>\n TIME_ZONE?: string\n USE_TZ?: boolean\n CACHES?: Record<string, CacheConfig>\n CSRF_TRUSTED_ORIGINS?: string[]\n CORS?: CorsOptions | false\n /** Paths whose errors are always rendered as JSON (default `['/api']`). */\n API_PATH_PREFIXES?: string[]\n // CSRF (Django names and defaults)\n CSRF_COOKIE_NAME?: string\n CSRF_HEADER_NAME?: string\n CSRF_COOKIE_AGE?: number | null\n CSRF_COOKIE_DOMAIN?: string\n CSRF_COOKIE_PATH?: string\n CSRF_COOKIE_SECURE?: boolean\n CSRF_COOKIE_HTTPONLY?: boolean\n CSRF_COOKIE_SAMESITE?: 'Lax' | 'Strict' | 'None' | false\n // Security (SecurityMiddleware / XFrameOptionsMiddleware / CommonMiddleware)\n SECURE_PROXY_SSL_HEADER?: [string, string]\n USE_X_FORWARDED_HOST?: boolean\n SECURE_SSL_REDIRECT?: boolean\n SECURE_SSL_HOST?: string\n SECURE_REDIRECT_EXEMPT?: string[]\n SECURE_HSTS_SECONDS?: number\n SECURE_HSTS_INCLUDE_SUBDOMAINS?: boolean\n SECURE_HSTS_PRELOAD?: boolean\n SECURE_CONTENT_TYPE_NOSNIFF?: boolean\n SECURE_REFERRER_POLICY?: string | string[] | false\n SECURE_CROSS_ORIGIN_OPENER_POLICY?: string | false\n X_FRAME_OPTIONS?: string | false\n PREPEND_WWW?: boolean\n [key: string]: unknown\n}\n\nexport interface SettingsFactory {\n (env: Env): GhuriSettings\n readonly __ghuriSettings: true\n}\n\nconst DEFAULTS: Partial<GhuriSettings> = {\n DEBUG: false,\n ALLOWED_HOSTS: ['*'],\n MIDDLEWARE: [],\n APPEND_SLASH: true,\n TIME_ZONE: 'UTC',\n USE_TZ: true,\n CSRF_TRUSTED_ORIGINS: [],\n CORS: false,\n}\n\n/** Define project settings as a function of the runtime environment (Worker bindings / process.env). */\nexport function defineSettings(fn: (env: Env) => GhuriSettings): SettingsFactory {\n const cache = new WeakMap<object, GhuriSettings>()\n const factory = ((env: Env) => {\n const key = env ?? {}\n let resolved = cache.get(key)\n if (!resolved) {\n resolved = { ...DEFAULTS, ...fn(env ?? {}) } as GhuriSettings\n validateSettings(resolved)\n cache.set(key, resolved)\n }\n return resolved\n }) as SettingsFactory\n Object.defineProperty(factory, '__ghuriSettings', { value: true })\n return factory\n}\n\nexport function isSettingsFactory(v: unknown): v is SettingsFactory {\n return typeof v === 'function' && (v as any).__ghuriSettings === true\n}\n\nfunction validateSettings(s: GhuriSettings): void {\n if (!s.SECRET_KEY && !s.DEBUG) {\n throw new ImproperlyConfigured(\n 'The SECRET_KEY setting must not be empty (set it in .dev.vars / wrangler secrets).',\n )\n }\n if (!Array.isArray(s.INSTALLED_APPS)) throw new ImproperlyConfigured('INSTALLED_APPS must be an array.')\n if (!Array.isArray(s.ROOT_URLCONF))\n throw new ImproperlyConfigured('ROOT_URLCONF must be an array of url patterns.')\n for (const key of ['HANDLER_404', 'HANDLER_500'] as const) {\n if (s[key] !== undefined && s[key] !== null && typeof s[key] !== 'function') {\n throw new ImproperlyConfigured(`${key} must be a view function (c, exception) => Response.`)\n }\n }\n}\n\n/** Settings for the current request / run. */\nexport function getSettings(): GhuriSettings {\n return getContext().settings\n}\n\n/** Read one setting with a default, e.g. `setting('REST_FRAMEWORK', {})`. */\nexport function setting<T>(name: string, fallback: T): T {\n const v = getSettings()[name]\n return (v === undefined ? fallback : v) as T\n}\n","export type Receiver<A> = (args: A & { sender: unknown }) => void | Promise<void>\n\ninterface Connection<A> {\n receiver: Receiver<A>\n sender?: unknown\n uid?: string\n}\n\n/** Django-style signal. Receivers run sequentially and are awaited. */\nexport class Signal<A extends object = Record<string, unknown>> {\n private receivers: Connection<A>[] = []\n\n constructor(readonly name = 'signal') {}\n\n connect(receiver: Receiver<A>, opts: { sender?: unknown; uid?: string } = {}): void {\n if (opts.uid && this.receivers.some((r) => r.uid === opts.uid)) return\n if (this.receivers.some((r) => r.receiver === receiver && r.sender === opts.sender)) return\n this.receivers.push({ receiver, sender: opts.sender, uid: opts.uid })\n }\n\n disconnect(receiverOrUid: Receiver<A> | string, sender?: unknown): boolean {\n const before = this.receivers.length\n this.receivers = this.receivers.filter((r) =>\n typeof receiverOrUid === 'string'\n ? r.uid !== receiverOrUid\n : !(r.receiver === receiverOrUid && (sender === undefined || r.sender === sender)),\n )\n return this.receivers.length !== before\n }\n\n hasListeners(sender?: unknown): boolean {\n return this.receivers.some((r) => r.sender === undefined || r.sender === sender)\n }\n\n async send(sender: unknown, args: A): Promise<void> {\n for (const r of [...this.receivers]) {\n if (r.sender !== undefined && r.sender !== sender) continue\n await r.receiver({ ...args, sender })\n }\n }\n}\n\n/** Decorator-free helper: `receiver(postSave, { sender: Post })(fn)`. */\nexport function receiver<A extends object>(signal: Signal<A>, opts: { sender?: unknown; uid?: string } = {}) {\n return (fn: Receiver<A>): Receiver<A> => {\n signal.connect(fn, opts)\n return fn\n }\n}\n\nexport const requestStarted = new Signal<{ request: Request }>('requestStarted')\nexport const requestFinished = new Signal<{ request: Request; response?: Response }>('requestFinished')\n","import { type Env, tryGetContext } from './context'\nimport { GhuriError, ImproperlyConfigured } from './errors'\n\n/**\n * Storage backend for the cache. Values are already JSON strings; `ttlSeconds` is `null` for \"never expire\".\n */\nexport interface CacheBackend {\n get(key: string): Promise<string | null | undefined>\n set(key: string, value: string, ttlSeconds: number | null): Promise<void>\n delete(key: string): Promise<void>\n has?(key: string): Promise<boolean>\n /** Remove every key starting with `prefix` (all keys when prefix is ''). */\n clear?(prefix: string): Promise<void>\n}\n\n/** Entry of the `CACHES` setting. Same pattern as database / storage configs. */\nexport interface CacheConfig {\n backend: string\n create(env: Env): CacheBackend\n /** Prepended to every key (Django's KEY_PREFIX). */\n keyPrefix?: string\n /** Default TTL in seconds when `set()` gets none (Django's TIMEOUT, default 300). `null` = forever. */\n timeout?: number | null\n}\n\nexport interface CacheOptions {\n keyPrefix?: string\n timeout?: number | null\n}\n\n/** High-level cache API (Django's `cache`). Values are JSON-serialized. */\nexport class Cache {\n constructor(\n readonly backend: CacheBackend,\n private readonly keyPrefix = '',\n private readonly defaultTimeout: number | null = 300,\n ) {}\n\n makeKey(key: string): string {\n return this.keyPrefix ? `${this.keyPrefix}:${key}` : key\n }\n\n private ttl(ttl: number | null | undefined): number | null {\n return ttl === undefined ? this.defaultTimeout : ttl\n }\n\n async get<T = unknown>(key: string): Promise<T | undefined>\n async get<T = unknown>(key: string, fallback: T): Promise<T>\n async get<T = unknown>(key: string, fallback?: T): Promise<T | undefined> {\n const raw = await this.backend.get(this.makeKey(key))\n if (raw === null || raw === undefined) return fallback\n try {\n return JSON.parse(raw) as T\n } catch {\n return fallback\n }\n }\n\n /** Store `value` for `ttlSeconds` (default: the configured timeout; `null` = forever; `<= 0` deletes). */\n async set(key: string, value: unknown, ttlSeconds?: number | null): Promise<void> {\n const ttl = this.ttl(ttlSeconds)\n if (ttl !== null && ttl <= 0) return this.delete(key)\n if (value === undefined) throw new TypeError('Cannot cache undefined; use null or delete the key.')\n await this.backend.set(this.makeKey(key), JSON.stringify(value), ttl)\n }\n\n /** Set only if the key is missing. Returns true when stored. (Not atomic on KV / Cache API.) */\n async add(key: string, value: unknown, ttlSeconds?: number | null): Promise<boolean> {\n if (await this.has(key)) return false\n await this.set(key, value, ttlSeconds)\n return true\n }\n\n async delete(key: string): Promise<void> {\n await this.backend.delete(this.makeKey(key))\n }\n\n async has(key: string): Promise<boolean> {\n if (this.backend.has) return this.backend.has(this.makeKey(key))\n const raw = await this.backend.get(this.makeKey(key))\n return raw !== null && raw !== undefined\n }\n\n /** Return the cached value, or compute it (`fn` may be async), store and return it. */\n async getOrSet<T>(\n key: string,\n valueOrFn: T | (() => T | Promise<T>),\n ttlSeconds?: number | null,\n ): Promise<T> {\n const raw = await this.backend.get(this.makeKey(key))\n if (raw !== null && raw !== undefined) return JSON.parse(raw) as T\n const value = typeof valueOrFn === 'function' ? await (valueOrFn as () => T | Promise<T>)() : valueOrFn\n if (value !== undefined) await this.set(key, value, ttlSeconds)\n return value\n }\n\n async getMany<T = unknown>(keys: string[]): Promise<Record<string, T>> {\n const out: Record<string, T> = {}\n await Promise.all(\n keys.map(async (k) => {\n const v = await this.get<T>(k)\n if (v !== undefined) out[k] = v\n }),\n )\n return out\n }\n\n async setMany(values: Record<string, unknown>, ttlSeconds?: number | null): Promise<void> {\n await Promise.all(Object.entries(values).map(([k, v]) => this.set(k, v, ttlSeconds)))\n }\n\n async deleteMany(keys: string[]): Promise<void> {\n await Promise.all(keys.map((k) => this.delete(k)))\n }\n\n /** Add `delta` to a numeric value. Throws if the key is missing. (Not atomic on KV / Cache API.) */\n async incr(key: string, delta = 1): Promise<number> {\n const current = await this.get<number>(key)\n if (current === undefined) throw new GhuriError(`Key '${key}' not found.`)\n const next = Number(current) + delta\n await this.set(key, next, null)\n return next\n }\n\n async decr(key: string, delta = 1): Promise<number> {\n return this.incr(key, -delta)\n }\n\n /** Remove every key of this cache (with its key prefix). */\n async clear(): Promise<void> {\n if (!this.backend.clear) throw new GhuriError('This cache backend does not support clear().')\n await this.backend.clear(this.keyPrefix ? `${this.keyPrefix}:` : '')\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Backends\n// ---------------------------------------------------------------------------------------------\n\n/** In-process cache (Django's LocMemCache). Per isolate on Workers; per process on Node. */\nexport function memoryCache(opts: CacheOptions & { maxEntries?: number } = {}): CacheConfig {\n let store: CacheBackend | undefined\n const max = opts.maxEntries ?? 10_000\n return {\n backend: 'memory',\n keyPrefix: opts.keyPrefix,\n timeout: opts.timeout,\n create() {\n if (store) return store\n const map = new Map<string, { value: string; expires: number | null }>()\n const live = (key: string) => {\n const e = map.get(key)\n if (!e) return undefined\n if (e.expires !== null && e.expires <= Date.now()) {\n map.delete(key)\n return undefined\n }\n return e\n }\n store = {\n async get(key) {\n return live(key)?.value\n },\n async set(key, value, ttl) {\n map.delete(key)\n if (map.size >= max) map.delete(map.keys().next().value as string)\n map.set(key, { value, expires: ttl === null ? null : Date.now() + ttl * 1000 })\n },\n async delete(key) {\n map.delete(key)\n },\n async has(key) {\n return live(key) !== undefined\n },\n async clear(prefix) {\n if (!prefix) return map.clear()\n for (const k of [...map.keys()]) if (k.startsWith(prefix)) map.delete(k)\n },\n }\n return store\n },\n }\n}\n\ninterface KVNamespaceLike {\n get(key: string, type?: 'text'): Promise<string | null>\n put(key: string, value: string, opts?: { expirationTtl?: number }): Promise<void>\n delete(key: string): Promise<void>\n list(opts?: {\n prefix?: string\n cursor?: string\n }): Promise<{ keys: Array<{ name: string }>; list_complete: boolean; cursor?: string }>\n}\n\n/**\n * Workers KV cache. `binding` is the KV namespace binding name (or the namespace itself).\n * KV is eventually consistent and its minimum TTL is 60 seconds (shorter TTLs are rounded up).\n */\nexport function kvCache(binding: string | KVNamespaceLike, opts: CacheOptions = {}): CacheConfig {\n return {\n backend: 'kv',\n keyPrefix: opts.keyPrefix,\n timeout: opts.timeout,\n create(env) {\n const kv = (typeof binding === 'string' ? env[binding] : binding) as KVNamespaceLike | undefined\n if (!kv || typeof kv.get !== 'function') {\n throw new ImproperlyConfigured(`KV namespace binding '${String(binding)}' was not found in env.`)\n }\n return {\n async get(key) {\n return kv.get(key, 'text')\n },\n async set(key, value, ttl) {\n await kv.put(key, value, ttl === null ? undefined : { expirationTtl: Math.max(60, Math.ceil(ttl)) })\n },\n async delete(key) {\n await kv.delete(key)\n },\n async clear(prefix) {\n let cursor: string | undefined\n do {\n const page = await kv.list({ prefix, cursor })\n await Promise.all(page.keys.map((k) => kv.delete(k.name)))\n cursor = page.list_complete ? undefined : page.cursor\n } while (cursor)\n },\n }\n },\n }\n}\n\n/**\n * Cloudflare Cache API cache (`caches.default`, or a named cache). Per data center, best effort;\n * `clear()` is not supported.\n */\nexport function cfCache(opts: CacheOptions & { name?: string; baseUrl?: string } = {}): CacheConfig {\n const base = opts.baseUrl ?? 'https://ghuri-cache.internal/'\n return {\n backend: 'cf-cache',\n keyPrefix: opts.keyPrefix,\n timeout: opts.timeout,\n create() {\n const storage = (globalThis as any).caches\n if (!storage) throw new ImproperlyConfigured('cfCache() needs the Cache API (Cloudflare Workers).')\n const open = async (): Promise<any> =>\n opts.name ? storage.open(opts.name) : (storage.default ?? storage.open('default'))\n const url = (key: string) => `${base}${encodeURIComponent(key)}`\n return {\n async get(key) {\n const res = await (await open()).match(url(key))\n return res ? res.text() : undefined\n },\n async set(key, value, ttl) {\n const maxAge = ttl === null ? 31536000 : Math.max(1, Math.ceil(ttl))\n await (await open()).put(\n url(key),\n new Response(value, {\n headers: { 'Content-Type': 'application/json', 'Cache-Control': `max-age=${maxAge}` },\n }),\n )\n },\n async delete(key) {\n await (await open()).delete(url(key))\n },\n }\n },\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Registry\n// ---------------------------------------------------------------------------------------------\n\nconst DEFAULT_KEY = Symbol.for('ghuri.core.defaultCache')\nconst defaultConfig: CacheConfig = ((globalThis as any)[DEFAULT_KEY] ??= memoryCache())\nconst instances = new WeakMap<CacheConfig, WeakMap<object, Cache>>()\nconst NO_ENV = {}\n\nfunction configFor(alias: string): CacheConfig {\n const caches = tryGetContext()?.settings.CACHES\n const cfg = caches?.[alias]\n if (cfg) return cfg\n if (alias === 'default') return defaultConfig\n throw new ImproperlyConfigured(`The cache alias '${alias}' is not configured in CACHES.`)\n}\n\n/** Access configured caches: `caches.get('sessions')`. */\nexport const caches = {\n get(alias = 'default'): Cache {\n const cfg = configFor(alias)\n const env = tryGetContext()?.env ?? NO_ENV\n let perEnv = instances.get(cfg)\n if (!perEnv) {\n perEnv = new WeakMap()\n instances.set(cfg, perEnv)\n }\n let c = perEnv.get(env)\n if (!c) {\n c = new Cache(cfg.create(env), cfg.keyPrefix ?? '', cfg.timeout === undefined ? 300 : cfg.timeout)\n perEnv.set(env, c)\n }\n return c\n },\n}\n\n/** The default cache (resolved per call from the current context's settings). */\nexport const cache = {\n get: <T = unknown>(key: string, fallback?: T): Promise<T | undefined> =>\n caches.get().get<T>(key, fallback as T),\n set: (key: string, value: unknown, ttlSeconds?: number | null) => caches.get().set(key, value, ttlSeconds),\n add: (key: string, value: unknown, ttlSeconds?: number | null) => caches.get().add(key, value, ttlSeconds),\n delete: (key: string) => caches.get().delete(key),\n has: (key: string) => caches.get().has(key),\n getOrSet: <T>(key: string, valueOrFn: T | (() => T | Promise<T>), ttlSeconds?: number | null) =>\n caches.get().getOrSet<T>(key, valueOrFn, ttlSeconds),\n getMany: <T = unknown>(keys: string[]) => caches.get().getMany<T>(keys),\n setMany: (values: Record<string, unknown>, ttlSeconds?: number | null) =>\n caches.get().setMany(values, ttlSeconds),\n deleteMany: (keys: string[]) => caches.get().deleteMany(keys),\n incr: (key: string, delta?: number) => caches.get().incr(key, delta),\n decr: (key: string, delta?: number) => caches.get().decr(key, delta),\n clear: () => caches.get().clear(),\n}\n","/**\n * Context carriers: request-scoped state (the current tenant, a locale…) that work leaving the request has to take\n * along. A package registers a carrier once; code that hands work to a queue, another service or a background\n * task calls `captureContext()` and later `restoreContext(captured, fn)`, without importing those packages.\n *\n * ```ts\n * const ctx = captureContext() // { tenant: '42' } inside a tenant's request, {} otherwise\n * await queue.send({ ...job, context: ctx })\n * // consumer\n * await restoreContext(job.context, () => runJob(job))\n * ```\n */\n\n/** Captured values, keyed by carrier name. JSON-safe, so they can go into a queue message or HTTP headers. */\nexport type CapturedContext = Record<string, string>\n\nexport interface ContextCarrier {\n /** Unique key in the captured object (`'tenant'`). */\n name: string\n /** The value of the current context as a string, or `undefined` when there is nothing to carry. */\n capture(): string | undefined\n /** Run `fn` with `value` (from `capture()`) active again. */\n restore<R>(value: string, fn: () => Promise<R>): Promise<R>\n}\n\nconst KEY = Symbol.for('ghuri.core.contextCarriers')\nconst g = globalThis as any\n// One registry per process, even if the module is loaded twice.\nconst carriers: Map<string, ContextCarrier> = (g[KEY] ??= new Map<string, ContextCarrier>())\n\n/** Register (or replace) a carrier. Packages call this at import time. */\nexport function registerContextCarrier(carrier: ContextCarrier): void {\n carriers.set(carrier.name, carrier)\n}\n\nexport function unregisterContextCarrier(name: string): boolean {\n return carriers.delete(name)\n}\n\n/** Names of the registered carriers. */\nexport function getContextCarriers(): string[] {\n return [...carriers.keys()]\n}\n\n/** The values every registered carrier has in the current context (carriers with nothing to carry are left out). */\nexport function captureContext(): CapturedContext {\n const out: CapturedContext = {}\n for (const c of carriers.values()) {\n const v = c.capture()\n if (typeof v === 'string' && v !== '') out[c.name] = v\n }\n return out\n}\n\n/**\n * Run `fn` with a captured context active again. Keys without a registered carrier are ignored, and an empty or\n * missing `captured` runs `fn` as is, so messages written before a carrier existed keep working.\n */\nexport async function restoreContext<R>(\n captured: CapturedContext | null | undefined,\n fn: () => Promise<R> | R,\n): Promise<R> {\n const entries = Object.entries(captured ?? {}).filter(\n ([name, v]) => carriers.has(name) && typeof v === 'string' && v !== '',\n )\n const run = entries.reduceRight<() => Promise<R>>(\n (next, [name, value]) =>\n () =>\n carriers.get(name)!.restore(value, next),\n async () => fn(),\n )\n return run()\n}\n","import type { Context } from 'hono'\nimport { tryGetContext } from './context'\n\n/** What rest/admin/agents need from a user, without depending on @ghuri/auth. */\nexport interface RequestUser {\n pk: unknown\n isAuthenticated: boolean\n isAnonymous: boolean\n isActive?: boolean\n isStaff?: boolean\n isSuperuser?: boolean\n username?: string\n hasPerm(perm: string, obj?: unknown): Promise<boolean>\n hasPerms?(perms: string[], obj?: unknown): Promise<boolean>\n hasModulePerms?(appLabel: string): Promise<boolean>\n}\n\nexport class AnonymousUser implements RequestUser {\n readonly pk = null\n readonly id = null\n readonly username = ''\n readonly isAuthenticated = false\n readonly isAnonymous = true\n readonly isActive = false\n readonly isStaff = false\n readonly isSuperuser = false\n async hasPerm(): Promise<boolean> {\n return false\n }\n async hasPerms(): Promise<boolean> {\n return false\n }\n async hasModulePerms(): Promise<boolean> {\n return false\n }\n toString(): string {\n return 'AnonymousUser'\n }\n}\n\nexport const anonymousUser: RequestUser = new AnonymousUser()\n\nconst USER_KEY = Symbol.for('ghuri.core.user')\n\n/** The user of the current request (AnonymousUser if no authentication ran). */\nexport function getUser(c?: Context): RequestUser {\n const fromHono = c?.get?.('user' as never) as RequestUser | undefined\n if (fromHono) return fromHono\n const ctx = tryGetContext()\n const fromCtx =\n (ctx?.state.get(USER_KEY) as RequestUser | undefined) ??\n (ctx?.hono?.get?.('user' as never) as RequestUser | undefined)\n return fromCtx ?? anonymousUser\n}\n\nexport function setUser(c: Context | undefined, user: RequestUser): void {\n c?.set?.('user' as never, user as never)\n tryGetContext()?.state.set(USER_KEY, user)\n}\n\nexport type UserLoader = (pk: unknown) => Promise<RequestUser | null>\n\nconst LOADER_KEY = Symbol.for('ghuri.core.userLoader')\n\n/**\n * Register how to load a user by primary key. `@ghuri/auth` registers one in `ready()`, so packages that\n * only keep a user's pk (WebSocket consumers, background jobs) can load it without importing auth.\n */\nexport function registerUserLoader(loader: UserLoader | undefined): void {\n ;(globalThis as any)[LOADER_KEY] = loader\n}\n\n/** Load a user by pk with the registered loader. Returns null when no loader is registered or no user matches. */\nexport async function loadUser(pk: unknown): Promise<RequestUser | null> {\n const loader = (globalThis as any)[LOADER_KEY] as UserLoader | undefined\n if (!loader || pk === null || pk === undefined) return null\n return loader(pk)\n}\n\ndeclare module 'hono' {\n interface ContextVariableMap {\n user: RequestUser\n ghuri: import('./context').GhuriContext\n }\n}\n","import type { Context, HonoRequest } from 'hono'\nimport { jsx } from 'hono/jsx'\nimport { ImproperlyConfigured, MethodNotAllowed } from './errors'\nimport { handleException } from './exceptions'\nimport {\n CSRF_EXEMPT_MARKER,\n kwargs as getKwargs,\n NoReverseMatch,\n reverse,\n type ViewFunction,\n XFRAME_OPTIONS_EXEMPT_MARKER,\n} from './urls'\n\nexport type { ViewFunction } from './urls'\n\n/** Function returned by `View.asView()`. */\nexport interface AsViewFunction<V extends View = View> extends ViewFunction {\n viewClass: new () => V\n viewInitkwargs: Partial<V>\n}\n\nexport type HttpMethodName = 'get' | 'post' | 'put' | 'patch' | 'delete' | 'head' | 'options' | 'trace'\n\ntype Handler = (c: Context) => Response | Promise<Response>\n\n/**\n * Django's class-based `View`. Subclass it and implement `get` / `post` / … handlers; mount it with\n * `path('x/', MyView.asView())`. A new instance is created for every request.\n *\n * ```ts\n * class Hello extends View {\n * greeting = 'Hello'\n * async get(c: Context) { return c.text(`${this.greeting}, ${this.kwargs.name}`) }\n * }\n * path('hello/<name>/', Hello.asView({ greeting: 'Hi' }))\n * ```\n */\nexport abstract class View {\n static httpMethodNames: HttpMethodName[] = [\n 'get',\n 'post',\n 'put',\n 'patch',\n 'delete',\n 'head',\n 'options',\n 'trace',\n ]\n /** Mark every view produced by `asView()` as CSRF exempt. */\n static csrfExempt = false\n /** Mark every view produced by `asView()` as exempt from `XFrameOptionsMiddleware`. */\n static xframeOptionsExempt = false\n\n /** The Hono context of the current request. */\n c!: Context\n /** The Hono request (Django's `self.request`). */\n request!: HonoRequest\n /** URL parameters (converted), see `kwargs(c)`. */\n kwargs: Record<string, any> = {}\n\n get?(c: Context): Response | Promise<Response>\n post?(c: Context): Response | Promise<Response>\n put?(c: Context): Response | Promise<Response>\n patch?(c: Context): Response | Promise<Response>\n delete?(c: Context): Response | Promise<Response>\n head?(c: Context): Response | Promise<Response>\n trace?(c: Context): Response | Promise<Response>\n\n /** Build a view function. `initkwargs` override instance attributes (like Django). */\n static asView<V extends View>(this: new () => V, initkwargs: Partial<V> = {}): AsViewFunction<V> {\n const cls = this as unknown as (new () => V) & {\n httpMethodNames: HttpMethodName[]\n csrfExempt?: boolean\n xframeOptionsExempt?: boolean\n name: string\n }\n for (const key of Object.keys(initkwargs)) {\n if ((cls.httpMethodNames as string[]).includes(key)) {\n throw new ImproperlyConfigured(\n `The method name ${key} is not accepted as a keyword argument to ${cls.name}.asView().`,\n )\n }\n }\n const view = (async (c: Context) => {\n const self = new cls()\n Object.assign(self, initkwargs)\n self.setup(c)\n return self.dispatch(c)\n }) as AsViewFunction<V>\n view.viewClass = cls\n view.viewInitkwargs = initkwargs\n Object.defineProperty(view, 'name', { value: cls.name })\n if (cls.csrfExempt) (view as any)[CSRF_EXEMPT_MARKER] = true\n if (cls.xframeOptionsExempt) (view as any)[XFRAME_OPTIONS_EXEMPT_MARKER] = true\n return view\n }\n\n /** Initialize attributes shared by all handlers (Django's `setup()`). */\n setup(c: Context): void {\n this.c = c\n this.request = c.req\n this.kwargs = { ...getKwargs(c), ...this.kwargs }\n }\n\n /** Route to the handler for the request method, or `httpMethodNotAllowed`. */\n async dispatch(c: Context): Promise<Response> {\n const method = c.req.method.toLowerCase()\n const names = (this.constructor as typeof View).httpMethodNames as string[]\n let handler: Handler | undefined\n if (names.includes(method)) handler = (this as any)[method]\n if (!handler && method === 'head' && typeof this.get === 'function') handler = this.get\n if (typeof handler !== 'function') return this.httpMethodNotAllowed(c)\n return handler.call(this, c)\n }\n\n /** Allowed HTTP methods (upper case), used for the `Allow` header. */\n allowedMethods(): string[] {\n const names = (this.constructor as typeof View).httpMethodNames as string[]\n const out = names.filter((m) => typeof (this as any)[m] === 'function').map((m) => m.toUpperCase())\n if (out.includes('GET') && !out.includes('HEAD')) out.splice(out.indexOf('GET') + 1, 0, 'HEAD')\n return out\n }\n\n httpMethodNotAllowed(c: Context): Response | Promise<Response> {\n return handleException(new MethodNotAllowed(c.req.method, this.allowedMethods()), c)\n }\n\n /** Default OPTIONS handler: 200 with an `Allow` header. */\n options(_c: Context): Response | Promise<Response> {\n return new Response(null, {\n status: 200,\n headers: { Allow: this.allowedMethods().join(', '), 'Content-Length': '0' },\n })\n }\n}\n\n/** Something renderable by `render()`: a Hono JSX node, a string, or a promise of either. */\nexport type Renderable = unknown\n\nexport interface RenderOptions {\n status?: number\n headers?: Record<string, string>\n /** Prepend `<!DOCTYPE html>` when the output starts with `<html` (default true). */\n doctype?: boolean\n}\n\n/** Render Hono JSX (or an HTML string) to an HTML response. */\nexport async function render(c: Context, node: Renderable, opts: RenderOptions = {}): Promise<Response> {\n let html: string\n const resolved = await node\n if (resolved === null || resolved === undefined || resolved === false) html = ''\n else html = String(await (typeof resolved === 'string' ? resolved : (resolved as any).toString()))\n if (opts.doctype !== false && /^\\s*<html[\\s>]/i.test(html)) html = `<!DOCTYPE html>${html}`\n return c.html(html, (opts.status ?? 200) as any, opts.headers)\n}\n\n/** Template: a Hono JSX component (sync or async) receiving the context data as props. */\nexport type Template<P = any> = (props: P) => unknown\n\n/**\n * Render a JSX `template` with `getContextData()` (Django's TemplateView).\n *\n * ```tsx\n * class About extends TemplateView {\n * template = (p: { title: string }) => <h1>{p.title}</h1>\n * async getContextData() { return { ...(await super.getContextData()), title: 'About us' } }\n * }\n * ```\n */\nexport class TemplateView extends View {\n template?: Template\n /** Extra context merged into every render (Django's `extra_context`). */\n extraContext?: Record<string, unknown>\n status = 200\n\n async getContextData(extra: Record<string, unknown> = {}): Promise<Record<string, any>> {\n return { view: this, ...this.kwargs, ...this.extraContext, ...extra }\n }\n\n getTemplate(): Template {\n if (!this.template) {\n throw new ImproperlyConfigured(\n `${this.constructor.name} requires either a definition of 'template' or an implementation of 'getTemplate()'.`,\n )\n }\n return this.template\n }\n\n async renderToResponse(context: Record<string, any>, opts: RenderOptions = {}): Promise<Response> {\n return render(this.c, jsx(this.getTemplate() as any, context), { status: this.status, ...opts })\n }\n\n override async get(_c: Context): Promise<Response> {\n return this.renderToResponse(await this.getContextData())\n }\n}\n\n/**\n * Redirect to `url` (with `{param}` placeholders filled from the URL kwargs) or to the named `patternName`.\n * Returns 410 Gone when neither is set. Like Django, every method is redirected.\n */\nexport class RedirectView extends View {\n url?: string\n patternName?: string\n permanent = false\n queryString = false\n\n getRedirectUrl(): string | null {\n let url: string\n if (this.url) {\n url = this.url.replace(/\\{(\\w+)\\}|%\\((\\w+)\\)s/g, (m, a, b) => {\n const k = a ?? b\n return k in this.kwargs ? encodeURIComponent(String(this.kwargs[k])) : m\n })\n } else if (this.patternName) {\n url = reverse(this.patternName, this.kwargs)\n } else {\n return null\n }\n const search = new URL(this.c.req.url).search\n if (this.queryString && search) url += url.includes('?') ? `&${search.slice(1)}` : search\n return url\n }\n\n override async get(_c: Context): Promise<Response> {\n const url = this.getRedirectUrl()\n if (url === null) return new Response(null, { status: 410 })\n return new Response(null, { status: this.permanent ? 301 : 302, headers: { Location: url } })\n }\n override head(c: Context) {\n return this.get(c)\n }\n override post(c: Context) {\n return this.get(c)\n }\n override options(c: Context) {\n return this.get(c)\n }\n override delete(c: Context) {\n return this.get(c)\n }\n override put(c: Context) {\n return this.get(c)\n }\n override patch(c: Context) {\n return this.get(c)\n }\n}\n\n// ---------------------------------------------------------------------------------------------\n// Shortcuts\n// ---------------------------------------------------------------------------------------------\n\nfunction jsonReplacer(_key: string, value: unknown): unknown {\n if (typeof value === 'bigint') return Number.isSafeInteger(Number(value)) ? Number(value) : value.toString()\n if (value instanceof Map) return Object.fromEntries(value)\n if (value instanceof Set) return [...value]\n return value\n}\n\n/** JSON-encode a value the way `json()` does (bigint → number/string, Map → object, Set → array). */\nexport function toJson(data: unknown, space?: number): string {\n return JSON.stringify(data, jsonReplacer, space)\n}\n\n/** JSON response: `return json(c, { ok: true }, 201)`. */\nexport function json(c: Context, data: unknown, status = 200, headers?: Record<string, string>): Response {\n return c.body(toJson(data), status as any, {\n 'Content-Type': 'application/json; charset=UTF-8',\n ...headers,\n })\n}\n\n/**\n * Django's `resolve_url`: a URL name (reversed with `params`), an object with `getAbsoluteUrl()`, or a URL.\n */\nexport function resolveUrl(\n to: string | { getAbsoluteUrl(): string },\n params?: Record<string, unknown> | unknown[],\n): string {\n if (typeof to === 'object' && to && typeof to.getAbsoluteUrl === 'function') return to.getAbsoluteUrl()\n const target = String(to)\n if (/^(\\.\\.?\\/|\\/|[a-z][a-z0-9+.-]*:\\/\\/)/i.test(target)) return target\n try {\n return reverse(target, params)\n } catch (err) {\n if (err instanceof NoReverseMatch && (target.includes('/') || target.includes('.'))) return target\n throw err\n }\n}\n\n/** Redirect to a URL name (`redirect(c, 'blog:detail', { id })`), a model with `getAbsoluteUrl()`, or a URL. */\nexport function redirect(\n c: Context,\n to: string | { getAbsoluteUrl(): string },\n params?: Record<string, unknown> | unknown[],\n opts: { permanent?: boolean; status?: number } = {},\n): Response {\n const status = opts.status ?? (opts.permanent ? 301 : 302)\n return c.redirect(resolveUrl(to, params), status as any)\n}\n"],"mappings":"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","names":["KEY","KEY","settings","redirect","cache","receiver","settings","caches","KEY"]}
package/dist/node.d.ts CHANGED
@@ -1,5 +1,6 @@
1
1
  import * as _hono_node_server from '@hono/node-server';
2
- import { E as Env, b as ExecutionContextLike } from './context-mL1PriMt.js';
2
+ import { E as Env, a as ExecutionContextLike } from './context-BM17cFwp.js';
3
+ import { S as ScheduledEventLike } from './tasks-BEaLcIUR.js';
3
4
  import 'hono';
4
5
 
5
6
  /** Anything with a Workers-style `fetch(request, env, ctx)` — a GhuriApp or a Hono app. */
@@ -21,6 +22,11 @@ interface ServeOptions {
21
22
  }): void;
22
23
  /** Close the server gracefully on SIGINT/SIGTERM (default true). */
23
24
  handleSignals?: boolean;
25
+ /**
26
+ * Also fire the app's Cron Triggers in this process (`startScheduler()`), like `wrangler dev` does with
27
+ * `--test-scheduled` and Cloudflare does in production. Run the scheduler in exactly one process.
28
+ */
29
+ scheduler?: boolean | Omit<SchedulerOptions, 'env'>;
24
30
  }
25
31
  /** A Workers-like ExecutionContext for Node: `waitUntil` promises are tracked and their errors logged. */
26
32
  declare function createExecutionContext(): ExecutionContextLike & {
@@ -36,5 +42,32 @@ declare function createExecutionContext(): ExecutionContextLike & {
36
42
  * ```
37
43
  */
38
44
  declare function serve(app: FetchApp, opts?: ServeOptions): Promise<_hono_node_server.ServerType>;
45
+ /** An app with Workers' `scheduled()` handler (a `GhuriApp`). */
46
+ interface SchedulableApp {
47
+ scheduled(event: ScheduledEventLike, env?: Env, ctx?: ExecutionContextLike): Promise<void>;
48
+ /** Populates the app registry so `onSchedule()` handlers registered in `ready()` are known. */
49
+ run?<T>(env: Env | undefined, ctx: ExecutionContextLike | undefined, fn: (ctx: any) => Promise<T>): Promise<T>;
50
+ }
51
+ interface SchedulerOptions {
52
+ /** Cron expressions to fire (default: every cron registered with `onSchedule()`, read after the apps load). */
53
+ crons?: string[];
54
+ /** Passed to `app.scheduled()` as `env`. Default: `process.env`. */
55
+ env?: Env;
56
+ /** Called when a scheduled handler throws (default: logs it). The scheduler keeps running. */
57
+ onError?(error: unknown, cron: string): void;
58
+ /** Called once with the crons being fired (default: logs them). */
59
+ onStart?(crons: string[]): void;
60
+ }
61
+ interface Scheduler {
62
+ readonly crons: string[];
63
+ /** Stop firing and wait for running handlers. */
64
+ stop(): Promise<void>;
65
+ }
66
+ /**
67
+ * Fire a Ghuri app's Cron Triggers on Node with Cloudflare's semantics (UTC, 1 = Sunday; see `parseCron`): at
68
+ * each matching minute, `app.scheduled({ cron, scheduledTime })` runs, so `onSchedule()` handlers and
69
+ * `@ghuri/tasks` periodic tasks work outside Workers. Like Celery beat, run it in exactly one process.
70
+ */
71
+ declare function startScheduler(app: SchedulableApp, opts?: SchedulerOptions): Promise<Scheduler>;
39
72
 
40
- export { type FetchApp, type ServeOptions, createExecutionContext, serve };
73
+ export { type FetchApp, type SchedulableApp, type Scheduler, type SchedulerOptions, type ServeOptions, createExecutionContext, serve, startScheduler };