@orieljs/framework 0.1.0-alpha.0 → 0.1.0-alpha.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1 @@
1
+ {"version":3,"sources":["../../View/Element.ts","../../View/jsx-runtime.ts","../../View/Html.ts","../../View/errors.ts","../../View/attributes.ts","../../View/render.ts","../../View/FileViewFinder.ts","../../View/TsxView.ts","../../View/Factory.ts","../../View/helpers.ts","../../View/facade.ts","../../View/ViewServiceProvider.ts"],"sourcesContent":["import type { Htmlable } from '@orieljs/contracts'\n\n/** Marks the objects jsx() returns (Symbol.for, so two copies of the package agree). */\nexport const ELEMENT: unique symbol = Symbol.for('oriel:view.element')\n\nexport type Props = Record<string, unknown>\n\n/** Anything that can appear as a child: text is escaped, Htmlable is emitted as-is, promises are awaited. */\nexport type Renderable =\n | OrielElement\n | string\n | number\n | bigint\n | boolean\n | null\n | undefined\n | Htmlable\n | Promise<Renderable>\n | Iterable<Renderable>\n\n/** A function component. It may be async: the renderer awaits it. */\nexport type Component<P = Props> = (props: P) => Renderable | Promise<Renderable>\n\n/**\n * `<>…</>` and `<Fragment>`: renders its children only. A symbol at runtime; typed as a component so that\n * `<Fragment>` type-checks as a JSX tag.\n */\nexport const Fragment = Symbol.for('oriel:view.fragment') as unknown as (props: { children?: Renderable }) => Renderable\n\nexport type ElementType = string | Component<never>\n\n/** What `<div />` evaluates to: an inert description, rendered later by renderToString()/renderToStream(). */\nexport interface OrielElement {\n readonly [ELEMENT]: true\n readonly type: ElementType\n readonly props: Props\n readonly key: string | number | undefined\n}\n\nexport function createElement(type: ElementType, props: Props | null | undefined, key?: string | number): OrielElement {\n return { [ELEMENT]: true, type, props: props ?? {}, key }\n}\n\nexport function isElement(value: unknown): value is OrielElement {\n return typeof value === 'object' && value !== null && (value as Record<symbol, unknown>)[ELEMENT] === true\n}\n","/**\n * The automatic JSX runtime (`jsxImportSource: \"@orieljs/view\"`). jsx() only describes elements; rendering\n * (escaping, async components) happens in renderToString()/renderToStream().\n */\nimport type { ClassValue, StyleObject } from './attributes'\nimport { createElement, Fragment, type Component, type ElementType, type OrielElement, type Props, type Renderable } from './Element'\n\nexport { Fragment }\n\nexport function jsx(type: ElementType, props: Props | null, key?: string | number): OrielElement {\n return createElement(type, props, key)\n}\n\n/** Same as jsx(); the compiler uses it when there are several static children. */\nexport const jsxs = jsx\n\n/** Attributes every intrinsic element accepts. Unknown attributes (hx-*, x-*, o:click, …) are allowed. */\nexport interface HtmlAttributes {\n children?: Renderable\n class?: ClassValue\n className?: ClassValue\n style?: string | StyleObject\n dangerouslySetInnerHTML?: { __html: string }\n [attribute: string]: unknown\n}\n\nexport declare namespace JSX {\n type Element = OrielElement\n /** Lets components be async: `async function Posts() { … }` is a valid element type. */\n type ElementType = string | Component<never>\n interface ElementChildrenAttribute {\n children: unknown\n }\n interface IntrinsicAttributes {\n key?: string | number\n }\n interface IntrinsicElements {\n [element: string]: HtmlAttributes\n }\n}\n","import type { Htmlable } from '@orieljs/contracts'\n\nconst ESCAPES: Record<string, string> = { '&': '&amp;', '<': '&lt;', '>': '&gt;', '\"': '&quot;', \"'\": '&#039;' }\nconst UNSAFE = /[&<>\"']/g\n\n/** Markup that must not be escaped again (Laravel's Illuminate\\Support\\HtmlString). */\nexport class HtmlString implements Htmlable {\n constructor(private readonly html: string = '') {}\n\n toHtml(): string {\n return this.html\n }\n\n toString(): string {\n return this.html\n }\n\n isEmpty(): boolean {\n return this.html === ''\n }\n}\n\n/** Marks trusted markup so the renderer emits it unescaped: {raw(markdownHtml)}. Never pass user input. */\nexport function raw(html: string): HtmlString {\n return new HtmlString(html)\n}\n\nexport function isHtmlable(value: unknown): value is Htmlable {\n return typeof value === 'object' && value !== null && typeof (value as Htmlable).toHtml === 'function'\n}\n\n/** Laravel's e(): htmlspecialchars(ENT_QUOTES, double-encode). Htmlable values pass through; null is ''. */\nexport function e(value: unknown): string {\n if (value === null || value === undefined) return ''\n if (isHtmlable(value)) return value.toHtml()\n return String(value).replace(UNSAFE, (char) => ESCAPES[char]!)\n}\n","import type { ErrorKind, OrielError } from '@orieljs/contracts'\n\n/**\n * Programmer errors (Laravel throws InvalidArgumentException for these). Not an HTTP condition, so kind 'Server':\n * the exception handler reports them and renders a 500 whose message is hidden unless app.debug is on.\n */\nexport class ViewRenderError extends Error implements OrielError {\n override readonly name: string = 'ViewRenderError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n}\n\n/** Laravel's \"View [x] not found.\" (InvalidArgumentException). */\nexport class ViewNotFoundError extends Error implements OrielError {\n override readonly name: string = 'ViewNotFoundError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n constructor(readonly view: string, readonly searched: string[] = []) {\n super(`View [${view}] not found.`)\n }\n}\n\n/** A view file that doesn't default-export a component. */\nexport class InvalidViewError extends Error implements OrielError {\n override readonly name: string = 'InvalidViewError'\n readonly kind: ErrorKind = 'Server'\n readonly status = 500\n}\n","import { e, isHtmlable } from './Html'\nimport { ViewRenderError } from './errors'\n\n/** Props that are never attributes. */\nconst SKIPPED = new Set(['children', 'dangerouslySetInnerHTML', 'key', 'ref'])\n/** React-style prop names that map to a different HTML attribute. */\nconst RENAMED: Record<string, string> = { className: 'class', htmlFor: 'for' }\n/** HTML attribute names: no whitespace, quotes, `<`, `>`, `/`, `=` or control characters (WHATWG). */\nconst VALID_NAME = /^[^\\s\"'<>/=\\u0000-\\u001f\\u007f]+$/\n/** CSS properties whose numbers get no `px` (React's list, trimmed to what HTML pages use). */\nconst UNITLESS = new Set([\n 'animation-iteration-count', 'aspect-ratio', 'border-image-outset', 'border-image-slice', 'border-image-width',\n 'column-count', 'columns', 'fill-opacity', 'flex', 'flex-grow', 'flex-shrink', 'flex-order', 'font-weight',\n 'grid-area', 'grid-column', 'grid-column-end', 'grid-column-start', 'grid-row', 'grid-row-end', 'grid-row-start',\n 'line-clamp', 'line-height', 'opacity', 'order', 'orphans', 'scale', 'stop-opacity', 'stroke-dashoffset',\n 'stroke-opacity', 'stroke-width', 'tab-size', 'widows', 'z-index', 'zoom',\n])\n\nexport type ClassValue = string | number | null | undefined | false | ClassValue[] | Record<string, unknown>\nexport type StyleObject = Record<string, string | number | null | undefined | false>\n\n/** `class` accepts strings, arrays and `{ name: condition }` objects, like Blade's @class. */\nexport function classNames(value: ClassValue): string {\n if (value === null || value === undefined || value === false || value === '') return ''\n if (typeof value === 'string' || typeof value === 'number') return String(value).trim()\n if (Array.isArray(value)) return value.map(classNames).filter((name) => name !== '').join(' ')\n return Object.entries(value).filter(([, on]) => Boolean(on)).map(([name]) => name).join(' ')\n}\n\nconst kebab = (property: string) =>\n property.startsWith('--') ? property : property.replace(/^ms([A-Z])/, '-ms-$1').replace(/[A-Z]/g, (c) => `-${c.toLowerCase()}`)\n\n/** `{ marginTop: 4, '--gap': '1rem' }` → `margin-top:4px;--gap:1rem`. */\nexport function styleString(style: StyleObject): string {\n const parts: string[] = []\n for (const [property, value] of Object.entries(style)) {\n if (value === null || value === undefined || value === false || value === '') continue\n const name = kebab(property)\n const text = typeof value === 'number' && value !== 0 && !UNITLESS.has(name) && !name.startsWith('--') ? `${value}px` : String(value)\n parts.push(`${name}:${text}`)\n }\n return parts.join(';')\n}\n\nexport function assertValidName(name: string, what: 'attribute' | 'tag'): void {\n if (!VALID_NAME.test(name)) throw new ViewRenderError(`Invalid ${what} name [${name}].`)\n}\n\n/** Serializes props to ` name=\"value\"` pairs. Every value is escaped (HtmlString too); names are validated, never escaped. */\nexport function renderAttributes(props: Record<string, unknown>): string {\n let out = ''\n let classes = ''\n for (const [prop, value] of Object.entries(props)) {\n if (SKIPPED.has(prop)) continue\n if (value === undefined || value === null) continue\n if (typeof value === 'function' || typeof value === 'symbol') continue // event handlers do nothing on the server\n const name = RENAMED[prop] ?? prop\n assertValidName(name, 'attribute')\n // aria-*/data-* are string attributes: booleans are written out, like React.\n if (typeof value === 'boolean' && (name.startsWith('aria-') || name.startsWith('data-'))) {\n out += ` ${name}=\"${value}\"`\n continue\n }\n if (value === false) continue\n if (name === 'class') {\n const joined = classNames(value as ClassValue)\n classes = classes === '' ? joined : joined === '' ? classes : `${classes} ${joined}`\n continue\n }\n // Boolean attributes (disabled, checked, …) are present or absent.\n if (value === true) {\n out += ` ${name}`\n continue\n }\n const text = name === 'style' && typeof value === 'object' ? styleString(value as StyleObject) : attributeText(value)\n out += ` ${name}=\"${e(text)}\"`\n }\n return classes === '' ? out : ` class=\"${e(classes)}\"${out}`\n}\n\n/** Attribute values are text: objects become JSON (x-data, data-*), Htmlable its markup; the caller escapes all of it. */\nfunction attributeText(value: unknown): string {\n if (typeof value !== 'object' || value === null) return String(value)\n if (isHtmlable(value)) return value.toHtml()\n if (value instanceof Date) return value.toISOString()\n return JSON.stringify(value)\n}\n","import { Fragment, isElement, type OrielElement, type Renderable } from './Element'\nimport { e, isHtmlable } from './Html'\nimport { assertValidName, renderAttributes } from './attributes'\nimport { ViewRenderError } from './errors'\n\n/** Elements that never have children or a closing tag. */\nconst VOID = new Set(['area', 'base', 'br', 'col', 'embed', 'hr', 'img', 'input', 'link', 'meta', 'source', 'track', 'wbr'])\n\n/** Where rendered HTML goes. flush() is called before every await, so a stream sends what is ready. */\ninterface Sink {\n write(html: string): void\n flush(): void\n}\n\ninterface Renderer {\n render(): Promise<string>\n}\n\nconst isThenable = (value: unknown): value is PromiseLike<unknown> =>\n typeof value === 'object' && value !== null && typeof (value as PromiseLike<unknown>).then === 'function'\n\n/** A View (or anything with an async render() and toHtml()) used as a child, like Blade's @include. */\nconst isRenderer = (value: object): value is Renderer =>\n typeof (value as Partial<Renderer>).render === 'function' && isHtmlable(value)\n\nasync function write(node: Renderable, sink: Sink): Promise<void> {\n if (node === null || node === undefined || typeof node === 'boolean') return\n if (typeof node === 'string') return sink.write(e(node))\n if (typeof node === 'number' || typeof node === 'bigint') return sink.write(String(node))\n if (isElement(node)) return writeElement(node, sink)\n if (isThenable(node)) {\n sink.flush()\n const resolved: unknown = await (node as PromiseLike<unknown>)\n return write(resolved as Renderable, sink)\n }\n if (isRenderer(node)) {\n sink.flush()\n return sink.write(await node.render())\n }\n if (isHtmlable(node)) return sink.write(node.toHtml())\n if (typeof (node as Iterable<Renderable>)[Symbol.iterator] === 'function') {\n for (const child of node as Iterable<Renderable>) await write(child, sink)\n return\n }\n throw new ViewRenderError(`Objects are not valid as a child (found: object with keys {${Object.keys(node).join(', ')}}).`)\n}\n\nasync function writeElement(element: OrielElement, sink: Sink): Promise<void> {\n const { type, props } = element\n if (type === Fragment) return write(props.children as Renderable, sink)\n if (typeof type === 'function') {\n const result = (type as (props: unknown) => unknown)(props)\n if (isThenable(result)) sink.flush()\n const resolved: unknown = await result\n return write(resolved as Renderable, sink)\n }\n if (typeof type !== 'string') throw new ViewRenderError(`Invalid element type [${String(type)}].`)\n assertValidName(type, 'tag')\n\n const inner = props.dangerouslySetInnerHTML as { __html?: unknown } | undefined\n const hasChildren = props.children !== undefined && props.children !== null\n if (inner !== undefined && hasChildren) {\n throw new ViewRenderError(`<${type}> can't have both children and dangerouslySetInnerHTML.`)\n }\n // A document root gets its doctype: TSX has no syntax for <!DOCTYPE html>.\n if (type === 'html') sink.write('<!DOCTYPE html>')\n sink.write(`<${type}${renderAttributes(props)}>`)\n if (VOID.has(type.toLowerCase())) {\n if (hasChildren || inner !== undefined) throw new ViewRenderError(`<${type}> is a void element and can't have children.`)\n return\n }\n if (inner !== undefined) sink.write(String(inner.__html ?? ''))\n else await write(props.children as Renderable, sink)\n sink.write(`</${type}>`)\n}\n\n/** Renders JSX (or any Renderable) to an HTML string. Async components and promises are awaited in order. */\nexport async function renderToString(node: Renderable): Promise<string> {\n const parts: string[] = []\n await write(node, { write: (html) => void parts.push(html), flush: () => {} })\n return parts.join('')\n}\n\n/** Renders to a UTF-8 byte stream, sending everything rendered so far each time rendering waits on a promise. */\nexport function renderToStream(node: Renderable): ReadableStream<Uint8Array> {\n const encoder = new TextEncoder()\n return new ReadableStream<Uint8Array>({\n async start(controller) {\n let buffer = ''\n const sink: Sink = {\n write: (html) => void (buffer += html),\n flush: () => {\n if (buffer === '') return\n controller.enqueue(encoder.encode(buffer))\n buffer = ''\n },\n }\n try {\n await write(node, sink)\n sink.flush()\n controller.close()\n } catch (error) {\n controller.error(error)\n }\n },\n })\n}\n","import { existsSync } from 'node:fs'\nimport { isAbsolute, join, resolve } from 'node:path'\nimport { ViewNotFoundError } from './errors'\n\n/** `mail::message` → namespace `mail`, view `message` (Laravel's hint path delimiter). */\nconst HINT = '::'\n\n/**\n * Laravel's FileViewFinder: 'posts.index' → <location>/posts/index.<ext> for the first location and extension\n * that exist. Found paths are cached; misses are not, so a view created later is found.\n */\nexport class FileViewFinder {\n static readonly defaultExtensions = ['tsx', 'ts', 'jsx', 'js', 'mjs']\n\n private readonly locations: string[]\n private readonly hints = new Map<string, string[]>()\n private readonly views = new Map<string, string>()\n\n constructor(paths: string[], private readonly extensions: string[] = FileViewFinder.defaultExtensions) {\n this.locations = paths.map((path) => resolve(path))\n }\n\n /** The absolute path of the view file. Throws ViewNotFoundError. */\n find(name: string): string {\n const cached = this.views.get(name)\n if (cached !== undefined) return cached\n const [locations, view] = this.parse(name)\n const searched: string[] = []\n for (const location of locations) {\n for (const extension of this.extensions) {\n const file = join(location, `${view}.${extension}`)\n searched.push(file)\n if (existsSync(file)) {\n this.views.set(name, file)\n return file\n }\n }\n }\n throw new ViewNotFoundError(name, searched)\n }\n\n addLocation(path: string): void {\n this.locations.push(resolve(path))\n }\n\n prependLocation(path: string): void {\n this.locations.unshift(resolve(path))\n }\n\n /** Views under a namespace: addNamespace('mail', dir) makes 'mail::message' resolve to <dir>/message.tsx. */\n addNamespace(namespace: string, hints: string | string[]): void {\n const existing = this.hints.get(namespace) ?? []\n this.hints.set(namespace, [...existing, ...[hints].flat().map((path) => resolve(path))])\n }\n\n replaceNamespace(namespace: string, hints: string | string[]): void {\n this.hints.set(namespace, [hints].flat().map((path) => resolve(path)))\n this.flush()\n }\n\n getPaths(): string[] {\n return [...this.locations]\n }\n\n getHints(): Record<string, string[]> {\n return Object.fromEntries(this.hints)\n }\n\n /** Forget cached lookups. */\n flush(): void {\n this.views.clear()\n }\n\n /** [locations to search, relative file stem]. Dots become directories, so '..' can't climb out of a location. */\n private parse(name: string): [string[], string] {\n let locations = this.locations\n let view = name\n const at = name.indexOf(HINT)\n if (at !== -1) {\n const namespace = name.slice(0, at)\n view = name.slice(at + HINT.length)\n const hints = this.hints.get(namespace)\n if (hints === undefined) throw new ViewNotFoundError(name)\n locations = hints\n }\n const stem = view.replaceAll('.', '/')\n if (view === '' || stem.includes('\\0') || isAbsolute(stem) || stem.split(/[\\\\/]/).some((segment) => segment === '')) {\n throw new ViewNotFoundError(name)\n }\n return [locations, stem]\n }\n}\n","import type { View } from '@orieljs/contracts'\nimport { createElement, type Component } from './Element'\nimport { ViewRenderError } from './errors'\nimport { renderToString } from './render'\n\n/** What TsxView needs from its factory. */\nexport interface ViewEnvironment {\n getShared(): Record<string, unknown>\n callComposer(view: View): Promise<void>\n load(path: string, name: string): Promise<Component>\n}\n\n/**\n * One view: its name, file and data. render() runs the composers, imports the file and renders its default\n * export with { ...shared, ...data } as props. toHtml() returns the HTML of the last render().\n */\nexport class TsxView implements View {\n private data: Record<string, unknown>\n private html: string | undefined\n\n constructor(\n private readonly environment: ViewEnvironment,\n readonly name: string,\n readonly path: string,\n data: Record<string, unknown> = {},\n ) {\n this.data = { ...data }\n }\n\n with(key: string | Record<string, unknown>, value?: unknown): this {\n if (typeof key === 'string') this.data[key] = value\n else Object.assign(this.data, key)\n return this\n }\n\n /** The view's own data (Laravel's getData()). */\n getData(): Record<string, unknown> {\n return { ...this.data }\n }\n\n /** Shared data overlaid with the view's data: exactly the props the component receives. */\n gatherData(): Record<string, unknown> {\n return { ...this.environment.getShared(), ...this.data }\n }\n\n async render(): Promise<string> {\n await this.environment.callComposer(this)\n const component = await this.environment.load(this.path, this.name)\n this.html = await renderToString(createElement(component as Component<never>, this.gatherData()))\n return this.html\n }\n\n toHtml(): string {\n if (this.html === undefined) {\n throw new ViewRenderError(`View [${this.name}] has not been rendered: await view.render() before toHtml().`)\n }\n return this.html\n }\n}\n","import { pathToFileURL } from 'node:url'\nimport type { View, ViewFactory } from '@orieljs/contracts'\nimport { Str } from '@orieljs/support'\nimport type { Component } from './Element'\nimport { InvalidViewError, ViewNotFoundError } from './errors'\nimport type { FileViewFinder } from './FileViewFinder'\nimport { TsxView, type ViewEnvironment } from './TsxView'\n\ntype Composer = (view: View) => void | Promise<void>\n\n/** Laravel's view Factory: finds views by dotted name, shares data app-wide and runs view composers. */\nexport class Factory implements ViewFactory, ViewEnvironment {\n private readonly shared: Record<string, unknown> = {}\n private readonly composers: Array<{ patterns: string[]; composer: Composer }> = []\n\n constructor(private readonly finder: FileViewFinder) {}\n\n /** Throws ViewNotFoundError (\"View [x] not found.\") when no file matches. */\n make(name: string, data: Record<string, unknown> = {}): TsxView {\n return new TsxView(this, name, this.finder.find(name), data)\n }\n\n /** The first view that exists (Laravel's View::first()). */\n first(names: string[], data: Record<string, unknown> = {}): TsxView {\n const name = names.find((candidate) => this.exists(candidate))\n if (name === undefined) throw new ViewNotFoundError(names.join(', '))\n return this.make(name, data)\n }\n\n exists(name: string): boolean {\n try {\n this.finder.find(name)\n return true\n } catch (error) {\n if (error instanceof ViewNotFoundError) return false\n throw error\n }\n }\n\n /** App-wide data every view receives as props (view data wins on conflicts). */\n share(key: string | Record<string, unknown>, value?: unknown): void {\n if (typeof key === 'string') this.shared[key] = value\n else Object.assign(this.shared, key)\n }\n\n getShared(): Record<string, unknown> {\n return { ...this.shared }\n }\n\n /** Runs before matching views render. Patterns use `*` wildcards: 'posts.*', '*'. */\n composer(views: string | string[], composer: Composer): void {\n this.composers.push({ patterns: [views].flat(), composer })\n }\n\n async callComposer(view: View): Promise<void> {\n for (const { patterns, composer } of this.composers) {\n if (patterns.some((pattern) => Str.is(pattern, view.name))) await composer(view)\n }\n }\n\n /** Imports the view file (Node's module cache keeps it) and returns its default-export component. */\n async load(path: string, name: string): Promise<Component> {\n const module = (await import(pathToFileURL(path).href)) as { default?: unknown }\n if (typeof module.default !== 'function') {\n throw new InvalidViewError(`View [${name}] (${path}) must default-export a component function.`)\n }\n return module.default as Component\n }\n\n addLocation(path: string): void {\n this.finder.addLocation(path)\n }\n\n addNamespace(namespace: string, hints: string | string[]): this {\n this.finder.addNamespace(namespace, hints)\n return this\n }\n\n getFinder(): FileViewFinder {\n return this.finder\n }\n}\n","import { Session, ViewFactory, type View } from '@orieljs/contracts'\nimport { inject } from '@orieljs/container'\nimport { e, HtmlString } from './Html'\n\n/** view() → the ViewFactory; view('posts.index', data) → a View to return from a route or render. */\nexport function view(): ViewFactory\nexport function view(name: string, data?: Record<string, unknown>): View\nexport function view(name?: string, data: Record<string, unknown> = {}): ViewFactory | View {\n const factory = inject(ViewFactory)\n return name === undefined ? factory : factory.make(name, data)\n}\n\n/** Blade's @csrf / csrf_field(): the hidden _token input for the current request's session. */\nexport function csrfField(): HtmlString {\n return new HtmlString(`<input type=\"hidden\" name=\"_token\" value=\"${e(inject(Session).token())}\" autocomplete=\"off\">`)\n}\n\n/** Blade's @method('PUT') / method_field(): spoofs PUT/PATCH/DELETE from an HTML form. */\nexport function methodField(method: string): HtmlString {\n return new HtmlString(`<input type=\"hidden\" name=\"_method\" value=\"${e(method.toUpperCase())}\">`)\n}\n","import { ViewFactory, type Token } from '@orieljs/contracts'\nimport { facade } from '@orieljs/support'\nimport type { Factory } from './Factory'\n\n/** The View facade: View.make(), View.exists(), View.share(), View.composer(), View.first(), View.addNamespace(). */\nexport const View = facade(ViewFactory as unknown as Token<Factory>)\n","import { ConfigRepository, ViewFactory } from '@orieljs/contracts'\nimport { ServiceProvider } from '@orieljs/support'\nimport { Factory } from './Factory'\nimport { FileViewFinder } from './FileViewFinder'\n\n/** Binds the ViewFactory (resources/views by default) and merges the `view` config, like Laravel's config/view.php. */\nexport class ViewServiceProvider extends ServiceProvider {\n override register(): void {\n this.mergeConfigFrom({ paths: [this.app.resourcePath('views')] }, 'view')\n this.app.singleton(ViewFactory, () => {\n const paths = this.app.make(ConfigRepository).get<string[]>('view.paths', [this.app.resourcePath('views')])\n return new Factory(new FileViewFinder(paths))\n })\n }\n}\n"],"mappings":"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","names":["view","ViewFactory"]}
@@ -198,6 +198,38 @@ interface SessionHandler {
198
198
  gc(maxLifetimeSeconds: number): Promise<void>;
199
199
  }
200
200
 
201
+ /** A rule object (Laravel's ValidationRule). Call fail() to reject the value. */
202
+ interface ValidationRule {
203
+ validate(attribute: string, value: unknown, fail: (message: string) => void, data: Record<string, unknown>): void | Promise<void>;
204
+ }
205
+ /** 'required|string|max:255', or an array mixing strings and rule objects. Keys support dot + `*` wildcards. */
206
+ type Rules = Record<string, string | ReadonlyArray<string | ValidationRule>>;
207
+ interface MessageBag {
208
+ has(key: string): boolean;
209
+ first(key?: string): string | undefined;
210
+ get(key: string): string[];
211
+ all(): string[];
212
+ isEmpty(): boolean;
213
+ count(): number;
214
+ toObject(): Record<string, string[]>;
215
+ }
216
+ interface Validator {
217
+ passes(): Promise<boolean>;
218
+ fails(): Promise<boolean>;
219
+ /** Only the keys that have rules. Throws ValidationError (Exceptions.ts) on failure. */
220
+ validated<T = Record<string, unknown>>(): Promise<T>;
221
+ /** Valid only after passes()/fails()/validated() has run. */
222
+ errors(): MessageBag;
223
+ after(callback: (validator: Validator) => void | Promise<void>): this;
224
+ }
225
+ type RuleCallback = (attribute: string, value: unknown, parameters: string[], data: Record<string, unknown>) => boolean | Promise<boolean>;
226
+ interface ValidationFactory {
227
+ make(data: Record<string, unknown>, rules: Rules, messages?: Record<string, string>, attributes?: Record<string, string>): Validator;
228
+ /** Registers a string rule, e.g. extend('uppercase', fn, ':attribute must be uppercase'). */
229
+ extend(name: string, callback: RuleCallback, message?: string): void;
230
+ }
231
+ declare const ValidationFactory: Token<ValidationFactory>;
232
+
201
233
  /** Web-standard body/headers init types, derived from the runtime's global Response/Headers (no DOM lib needed). */
202
234
  type BodyInit = ConstructorParameters<typeof Response>[0];
203
235
  type HeadersInit = ConstructorParameters<typeof Headers>[0];
@@ -243,12 +275,16 @@ interface HttpRequest {
243
275
  merge(values: Record<string, unknown>): this;
244
276
  file(key: string): UploadedFile | undefined;
245
277
  cookie(name: string): string | undefined;
278
+ /** Replace the parsed request cookies (EncryptCookies calls this after decrypting). */
279
+ setCookies(cookies: Record<string, string>): void;
246
280
  /** Route parameter (after model binding), or every parameter when called with no key. */
247
281
  route<T = unknown>(key?: string): T;
248
282
  session(): Session;
249
283
  /** The user resolved earlier by auth middleware. Undefined for guests. Use `await Auth.user()` to resolve lazily. */
250
284
  user<T = unknown>(guard?: string): T | undefined;
251
285
  setUserResolver(resolver: (guard?: string) => unknown): void;
286
+ /** Validates this request's input via the ValidationFactory; throws a Validation OrielError (422) on failure. */
287
+ validate<T = Record<string, unknown>>(rules: Rules, messages?: Record<string, string>, attributes?: Record<string, string>): Promise<T>;
252
288
  }
253
289
  declare const HttpRequest: Token<HttpRequest>;
254
290
  type Next = (request: HttpRequest) => Promise<Response>;
@@ -323,15 +359,24 @@ interface ResourceOptions {
323
359
  parameters?: Record<string, string>;
324
360
  names?: Record<string, string>;
325
361
  }
362
+ /** The route matched for the current request (scope-local; set by the router before route middleware runs). */
363
+ interface CurrentRoute {
364
+ readonly route: Route;
365
+ /** Route parameters after model binding, in URI order. */
366
+ readonly parameters: Record<string, unknown>;
367
+ /** Resolved route middleware instances, for HttpKernel.terminate(). */
368
+ readonly middleware: Middleware[];
369
+ }
370
+ declare const CurrentRoute: Token<CurrentRoute>;
326
371
  interface Router {
327
- get<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
328
- post<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
329
- put<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
330
- patch<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
331
- delete<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
332
- options<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
333
- any<C>(uri: string, action: ControllerAction<C> | RouteClosure): Route;
334
- match<C>(methods: string[], uri: string, action: ControllerAction<C> | RouteClosure): Route;
372
+ get<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
373
+ post<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
374
+ put<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
375
+ patch<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
376
+ delete<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
377
+ options<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
378
+ any<C>(uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
379
+ match<C>(methods: string[], uri: string, action: ControllerAction<C> | RouteClosure | string): Route;
335
380
  redirect(from: string, to: string, status?: number): Route;
336
381
  view(uri: string, view: string, data?: Record<string, unknown>): Route;
337
382
  resource(name: string, controller: Class<unknown>, options?: ResourceOptions): void;
@@ -346,8 +391,17 @@ interface Router {
346
391
  /** Custom binding resolver. */
347
392
  bind(parameter: string, resolver: (value: string) => unknown | Promise<unknown>): void;
348
393
  pattern(parameter: string, pattern: string): void;
394
+ /** Name a middleware class, e.g. aliasMiddleware('auth', Authenticate). */
395
+ aliasMiddleware(name: string, middleware: MiddlewareClass): this;
396
+ /** Define (or replace) a middleware group such as 'web' or 'api'. */
397
+ middlewareGroup(name: string, middleware: MiddlewareReference[]): this;
398
+ /** Append to a group unless it is already present. */
399
+ pushMiddlewareToGroup(group: string, middleware: MiddlewareReference): this;
400
+ getMiddlewareGroups(): Record<string, MiddlewareReference[]>;
349
401
  getRoutes(): readonly Route[];
350
402
  current(): Route | undefined;
403
+ /** Match the request, bind parameters, run the route middleware and the action. Called by the Http kernel. */
404
+ dispatch(request: HttpRequest): Promise<Response>;
351
405
  }
352
406
  declare const Router: Token<Router>;
353
407
  /**
@@ -461,7 +515,7 @@ interface LogManager extends Logger {
461
515
  }
462
516
  declare const LogManager: Token<LogManager>;
463
517
 
464
- type ErrorKind = 'Http' | 'ModelNotFound' | 'Validation' | 'Authentication' | 'Authorization' | 'TokenMismatch' | 'BindingResolution' | 'CircularDependency' | 'ContainerNotAvailable';
518
+ type ErrorKind = 'Http' | 'Server' | 'ModelNotFound' | 'Validation' | 'Authentication' | 'Authorization' | 'TokenMismatch' | 'BindingResolution' | 'CircularDependency' | 'ContainerNotAvailable';
465
519
  /** Every error thrown by the framework implements this. The exception handler switches on `kind`. */
466
520
  interface OrielError extends Error {
467
521
  readonly kind: ErrorKind;
@@ -513,6 +567,11 @@ interface QueryBuilder<T = Row> {
513
567
  count(): Promise<number>;
514
568
  exists(): Promise<boolean>;
515
569
  insert(values: Row | Row[]): Promise<void>;
570
+ /**
571
+ * Inserts rows, skipping any that violate a unique key instead of failing (Laravel's insertOrIgnore). Returns the
572
+ * number of rows inserted. Nothing is thrown for a duplicate, so a caller's transaction stays usable on Postgres.
573
+ */
574
+ insertOrIgnore(values: Row | Row[]): Promise<number>;
516
575
  insertGetId(values: Row, keyName?: string): Promise<number | string>;
517
576
  update(values: Row): Promise<number>;
518
577
  upsert(values: Row | Row[], uniqueBy: string[], update?: string[]): Promise<number>;
@@ -529,6 +588,16 @@ interface DatabaseConnection {
529
588
  statement(sql: string, bindings?: readonly unknown[]): Promise<void>;
530
589
  /** Nested calls use savepoints. Rolls back if fn throws. */
531
590
  transaction<R>(fn: (connection: DatabaseConnection) => Promise<R>): Promise<R>;
591
+ /**
592
+ * Start a transaction that stays open, for every caller of this connection, until commit()/rollBack().
593
+ * Nested calls use savepoints. Meant for test isolation (RefreshDatabase); app code uses transaction(fn).
594
+ */
595
+ beginTransaction(): Promise<void>;
596
+ commit(): Promise<void>;
597
+ /** Rolls back the innermost level opened by beginTransaction(). Does nothing when none is open. */
598
+ rollBack(): Promise<void>;
599
+ /** 0 outside a transaction. */
600
+ transactionLevel(): number;
532
601
  }
533
602
  interface DatabaseManager extends DatabaseConnection {
534
603
  connection(name?: string): DatabaseConnection;
@@ -559,38 +628,6 @@ interface ModelStatic<M extends ModelInstance = ModelInstance> {
559
628
  findOrFail(id: unknown): Promise<M>;
560
629
  }
561
630
 
562
- /** A rule object (Laravel's ValidationRule). Call fail() to reject the value. */
563
- interface ValidationRule {
564
- validate(attribute: string, value: unknown, fail: (message: string) => void, data: Record<string, unknown>): void | Promise<void>;
565
- }
566
- /** 'required|string|max:255', or an array mixing strings and rule objects. Keys support dot + `*` wildcards. */
567
- type Rules = Record<string, string | ReadonlyArray<string | ValidationRule>>;
568
- interface MessageBag {
569
- has(key: string): boolean;
570
- first(key?: string): string | undefined;
571
- get(key: string): string[];
572
- all(): string[];
573
- isEmpty(): boolean;
574
- count(): number;
575
- toObject(): Record<string, string[]>;
576
- }
577
- interface Validator {
578
- passes(): Promise<boolean>;
579
- fails(): Promise<boolean>;
580
- /** Only the keys that have rules. Throws ValidationError (Exceptions.ts) on failure. */
581
- validated<T = Record<string, unknown>>(): Promise<T>;
582
- /** Valid only after passes()/fails()/validated() has run. */
583
- errors(): MessageBag;
584
- after(callback: (validator: Validator) => void | Promise<void>): this;
585
- }
586
- type RuleCallback = (attribute: string, value: unknown, parameters: string[], data: Record<string, unknown>) => boolean | Promise<boolean>;
587
- interface ValidationFactory {
588
- make(data: Record<string, unknown>, rules: Rules, messages?: Record<string, string>, attributes?: Record<string, string>): Validator;
589
- /** Registers a string rule, e.g. extend('uppercase', fn, ':attribute must be uppercase'). */
590
- extend(name: string, callback: RuleCallback, message?: string): void;
591
- }
592
- declare const ValidationFactory: Token<ValidationFactory>;
593
-
594
631
  interface Authenticatable {
595
632
  getAuthIdentifierName(): string;
596
633
  getAuthIdentifier(): unknown;
@@ -688,6 +725,10 @@ interface QueuePayload {
688
725
  pushedAt: number;
689
726
  batchId?: string;
690
727
  chain?: QueuePayload[];
728
+ /** Unix ms after which the job fails instead of retrying. */
729
+ retryUntil?: number;
730
+ /** Mark the job failed (instead of releasing it) when it times out. */
731
+ failOnTimeout?: boolean;
691
732
  }
692
733
  interface QueueJob {
693
734
  getJobId(): string;
@@ -770,6 +811,31 @@ interface BusDispatcher {
770
811
  findBatch(id: string): Promise<Batch | undefined>;
771
812
  }
772
813
  declare const BusDispatcher: Token<BusDispatcher>;
814
+ /** What PendingBatch hands to the repository. Callbacks are jobs, because closures can't be serialized. */
815
+ interface PendingBatchOptions {
816
+ name: string;
817
+ then: Job[];
818
+ catch: Job[];
819
+ finally: Job[];
820
+ allowFailures: boolean;
821
+ connection?: string;
822
+ queue?: string;
823
+ }
824
+ /** Stores batches and runs their bookkeeping (Laravel's BatchRepository). Bound by the Queue component. */
825
+ interface BatchRepository {
826
+ store(options: PendingBatchOptions): Promise<Batch>;
827
+ find(id: string): Promise<Batch | undefined>;
828
+ /** Adds `amount` to both total and pending jobs, before the jobs are pushed. */
829
+ incrementTotalJobs(id: string, amount: number): Promise<void>;
830
+ /** A batched job succeeded: decrement pending, then run then/finally callbacks when due. */
831
+ recordSuccessfulJob(id: string, jobUuid: string): Promise<void>;
832
+ /** A batched job failed for good: count it, cancel unless failures are allowed, run catch/finally when due. */
833
+ recordFailedJob(id: string, jobUuid: string, error: unknown): Promise<void>;
834
+ markAsFinished(id: string): Promise<void>;
835
+ cancel(id: string): Promise<void>;
836
+ delete(id: string): Promise<void>;
837
+ }
838
+ declare const BatchRepository: Token<BatchRepository>;
773
839
 
774
840
  /** A CLI command. Signature uses Laravel syntax: 'mail:send {user} {--queue=default}'. */
775
841
  interface Command {
@@ -777,6 +843,29 @@ interface Command {
777
843
  readonly description: string;
778
844
  handle(): number | void | Promise<number | void>;
779
845
  }
846
+ type OptionValue = string | boolean | string[] | undefined;
847
+ /** `this` inside a closure command (Laravel's Command API). */
848
+ interface CommandContext extends Command {
849
+ argument(name: string): string | string[] | undefined;
850
+ arguments(): Record<string, string | string[]>;
851
+ option(name: string): OptionValue;
852
+ options(): Record<string, OptionValue>;
853
+ info(message: string): void;
854
+ line(message?: string): void;
855
+ comment(message: string): void;
856
+ warn(message: string): void;
857
+ error(message: string): void;
858
+ newLine(count?: number): void;
859
+ table(headers: string[], rows: string[][]): void;
860
+ ask(question: string, defaultValue?: string): Promise<string>;
861
+ secret(question: string): Promise<string>;
862
+ confirm(question: string, defaultValue?: boolean): Promise<boolean>;
863
+ choice(question: string, choices: string[], defaultIndex?: number): Promise<string>;
864
+ }
865
+ /** What ConsoleKernel.command() returns. */
866
+ interface ClosureCommand extends CommandContext {
867
+ purpose(description: string): this;
868
+ }
780
869
  interface ConsoleKernel {
781
870
  /** Returns the exit code. */
782
871
  handle(argv: string[]): Promise<number>;
@@ -784,6 +873,10 @@ interface ConsoleKernel {
784
873
  /** Output buffered from the last call(). */
785
874
  output(): string;
786
875
  all(): Record<string, Command>;
876
+ /** Register command classes or instances (components call this from their provider's boot()). */
877
+ register(...commands: Array<Command | (new () => Command)>): void;
878
+ /** Closure command, like Artisan::command() in routes/console.ts. `this` is the command (argument(), info(), …). */
879
+ command(signature: string, handler: (this: CommandContext, ...args: unknown[]) => number | void | Promise<number | void>): ClosureCommand;
787
880
  }
788
881
  declare const ConsoleKernel: Token<ConsoleKernel>;
789
882
  interface ScheduledEvent {
@@ -854,6 +947,8 @@ interface Content {
854
947
  text?: string;
855
948
  /** Raw HTML (used when no view is given). */
856
949
  htmlString?: string;
950
+ /** Raw plain-text body (used when no text view is given). */
951
+ textString?: string;
857
952
  with?: Record<string, unknown>;
858
953
  }
859
954
  interface Attachment {
@@ -940,7 +1035,7 @@ interface Lock {
940
1035
  get(): Promise<boolean>;
941
1036
  /** Tries once. Runs the callback and releases if acquired, else returns false. */
942
1037
  get<T>(callback: () => T | Promise<T>): Promise<T | false>;
943
- /** Waits up to `seconds` to acquire. Throws LockTimeout (an OrielError, kind 'Http', status 423) on timeout. */
1038
+ /** Waits up to `seconds` to acquire. Throws LockTimeoutError (an OrielError, kind 'Server', status 500) on timeout. */
944
1039
  block<T>(seconds: number, callback?: () => T | Promise<T>): Promise<T | true>;
945
1040
  release(): Promise<boolean>;
946
1041
  forceRelease(): Promise<void>;
@@ -1114,4 +1209,4 @@ interface LiveManager {
1114
1209
  }
1115
1210
  declare const LiveManager: Token<LiveManager>;
1116
1211
 
1117
- export { type AbilityCallback, type Abstract, type ActionMethods, type Address, Application, type Arrayable, type Attachment, AuthFactory, type Authenticatable, type AuthenticationError, type Batch, type BodyInit, BusDispatcher, CacheManager, type CacheRepository, type Class, ClassRegistry, type Command, type Concrete, type ConfigCallbacks, ConfigRepository, ConsoleKernel, Container, type Content, type ControllerAction, type Cookie, CookieJar, type Credentials, type DatabaseConnection, DatabaseManager, type DriverName, Encrypter, type Enumerable, type Envelope, type ErrorKind, EventDispatcher, ExceptionCallbacks, ExceptionHandler, type ExceptionsConfigurator, type Factory, type FailedJob, FailedJobProvider, type Filesystem, FilesystemManager, Gate, type Guard, Hasher, type HeadersInit, type Htmlable, HttpKernel, HttpRequest, InertiaFactory, type InertiaPage, type InertiaResponse, type Job, type Jsonable, type Listener, type ListenerClass, type LiveEffects, LiveManager, type LiveSnapshot, type LiveUpdateRequest, type LiveUpdateResponse, type Lock, type LogLevel, LogManager, type Logger, MailManager, type MailRecipient, type MailTransport, type Mailable, type Mailer, type MessageBag, type Middleware, MiddlewareCallbacks, type MiddlewareClass, type MiddlewareConfigurator, type MiddlewareReference, type ModelInstance, type ModelNotFoundError, type ModelStatic, type MustVerifyEmail, type Next, type Notifiable, type Notification, type NotificationChannel, NotificationDispatcher, type Operator, type OrielError, type OutgoingMessage, PasswordBroker, type PasswordStatus, type PendingBatch, type PendingChain, type PendingMail, type Pipe, type PipeClosure, type PipeNext, type Pipeline, PipelineFactory, type PropCallback, type PutOptions, type QueryBuilder, type Queue, type QueueJob, QueueManager, type QueuePayload, type RedirectResponse, Redirector, type ResourceOptions, type Responsable, ResponseFactory, type Route, type RouteAction, type RouteClosure, RouteModelResolver, type RouteRegistrar, Router, RoutingPaths, type Row, type RuleCallback, type Rules, Schedule, type ScheduledEvent, type SentMessage, type ServiceProvider, type ServiceProviderClass, Session, type SessionHandler, type ShouldQueue, type StatefulGuard, type Token, type UploadedFile, UrlGenerator, type UserProvider, type ValidationError, ValidationFactory, type ValidationRule, type Validator, type View, ViewFactory, token };
1212
+ export { type AbilityCallback, type Abstract, type ActionMethods, type Address, Application, type Arrayable, type Attachment, AuthFactory, type Authenticatable, type AuthenticationError, type Batch, BatchRepository, type BodyInit, BusDispatcher, CacheManager, type CacheRepository, type Class, ClassRegistry, type ClosureCommand, type Command, type CommandContext, type Concrete, type ConfigCallbacks, ConfigRepository, ConsoleKernel, Container, type Content, type ControllerAction, type Cookie, CookieJar, type Credentials, CurrentRoute, type DatabaseConnection, DatabaseManager, type DriverName, Encrypter, type Enumerable, type Envelope, type ErrorKind, EventDispatcher, ExceptionCallbacks, ExceptionHandler, type ExceptionsConfigurator, type Factory, type FailedJob, FailedJobProvider, type Filesystem, FilesystemManager, Gate, type Guard, Hasher, type HeadersInit, type Htmlable, HttpKernel, HttpRequest, InertiaFactory, type InertiaPage, type InertiaResponse, type Job, type Jsonable, type Listener, type ListenerClass, type LiveEffects, LiveManager, type LiveSnapshot, type LiveUpdateRequest, type LiveUpdateResponse, type Lock, type LogLevel, LogManager, type Logger, MailManager, type MailRecipient, type MailTransport, type Mailable, type Mailer, type MessageBag, type Middleware, MiddlewareCallbacks, type MiddlewareClass, type MiddlewareConfigurator, type MiddlewareReference, type ModelInstance, type ModelNotFoundError, type ModelStatic, type MustVerifyEmail, type Next, type Notifiable, type Notification, type NotificationChannel, NotificationDispatcher, type Operator, type OptionValue, type OrielError, type OutgoingMessage, PasswordBroker, type PasswordStatus, type PendingBatch, type PendingBatchOptions, type PendingChain, type PendingMail, type Pipe, type PipeClosure, type PipeNext, type Pipeline, PipelineFactory, type PropCallback, type PutOptions, type QueryBuilder, type Queue, type QueueJob, QueueManager, type QueuePayload, type RedirectResponse, Redirector, type ResourceOptions, type Responsable, ResponseFactory, type Route, type RouteAction, type RouteClosure, RouteModelResolver, type RouteRegistrar, Router, RoutingPaths, type Row, type RuleCallback, type Rules, Schedule, type ScheduledEvent, type SentMessage, type ServiceProvider, type ServiceProviderClass, Session, type SessionHandler, type ShouldQueue, type StatefulGuard, type Token, type UploadedFile, UrlGenerator, type UserProvider, type ValidationError, ValidationFactory, type ValidationRule, type Validator, type View, ViewFactory, token };
package/dist/contracts.js CHANGED
@@ -1,6 +1,7 @@
1
1
  import {
2
2
  Application,
3
3
  AuthFactory,
4
+ BatchRepository,
4
5
  BusDispatcher,
5
6
  CacheManager,
6
7
  ClassRegistry,
@@ -8,6 +9,7 @@ import {
8
9
  ConsoleKernel,
9
10
  Container,
10
11
  CookieJar,
12
+ CurrentRoute,
11
13
  DatabaseManager,
12
14
  Encrypter,
13
15
  EventDispatcher,
@@ -39,10 +41,11 @@ import {
39
41
  ValidationFactory,
40
42
  ViewFactory,
41
43
  token
42
- } from "./chunk-P64C7IEP.js";
44
+ } from "./chunk-K6MAA3RM.js";
43
45
  export {
44
46
  Application,
45
47
  AuthFactory,
48
+ BatchRepository,
46
49
  BusDispatcher,
47
50
  CacheManager,
48
51
  ClassRegistry,
@@ -50,6 +53,7 @@ export {
50
53
  ConsoleKernel,
51
54
  Container,
52
55
  CookieJar,
56
+ CurrentRoute,
53
57
  DatabaseManager,
54
58
  Encrypter,
55
59
  EventDispatcher,