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

package/dist/{jsx-runtime-B8J6xq-7.d.ts → jsx-runtime-CZ6JqBQo.d.ts}

@@ -1,12 +1,14 @@
+import { Token as Token$1 } from './contracts.js';
+
 /** A typed, runtime-unique key for container bindings. */
-interface Token$1<T> {
+interface Token<T> {
     readonly id: symbol;
     readonly description: string;
     /** Phantom field: only carries T at the type level. Never set at runtime. */
     readonly __type?: T;
 }
 type Class<T> = abstract new (...args: any[]) => T;
-type Abstract<T> = Token$1<T> | Class<T>;
+type Abstract<T> = Token<T> | Class<T>;
 type Factory$1<T> = (container: Container) => T;
 type Concrete<T> = Factory$1<T> | (new () => T);
 interface Container {
@@ -32,7 +34,7 @@ interface Container {
     /** Run fn with this container as the "current" one for inject(), helpers and facades (AsyncLocalStorage). */
     run<R>(fn: () => R): R;
 }
-declare const Container: Token$1<Container>;
+declare const Container: Token<Container>;
 
 interface ServiceProvider$1 {
     /** Bind things into the container. Synchronous. Don't resolve other services here. */
@@ -94,13 +96,6 @@ interface ClassRegistry {
 }
 declare const ClassRegistry: Token$1<ClassRegistry>;
 
-/** A typed, runtime-unique key for container bindings. */
-interface Token<T> {
-    readonly id: symbol;
-    readonly description: string;
-    /** Phantom field: only carries T at the type level. Never set at runtime. */
-    readonly __type?: T;
-}
 interface Htmlable {
     toHtml(): string;
 }
@@ -117,7 +112,7 @@ interface ViewFactory {
     share(key: string | Record<string, unknown>, value?: unknown): void;
     composer(views: string | string[], composer: (view: View$1) => void | Promise<void>): void;
 }
-declare const ViewFactory: Token<ViewFactory>;
+declare const ViewFactory: Token$1<ViewFactory>;
 
 type ErrorKind = 'Http' | 'Server' | 'ModelNotFound' | 'Validation' | 'Authentication' | 'Authorization' | 'TokenMismatch' | 'BindingResolution' | 'CircularDependency' | 'ContainerNotAvailable';
 /** Every error thrown by the framework implements this. The exception handler switches on `kind`. */

package/dist/jsx-runtime.d.ts

@@ -1 +1,2 @@
-export { f as Fragment, H as HtmlAttributes, J as JSX, z as jsx, B as jsxs } from './jsx-runtime-B8J6xq-7.js';
+export { f as Fragment, H as HtmlAttributes, J as JSX, z as jsx, B as jsxs } from './jsx-runtime-CZ6JqBQo.js';
+import './contracts.js';

package/dist/jsx-runtime.js

@@ -2,9 +2,9 @@ import {
   Fragment,
   jsx,
   jsxs
-} from "./chunk-WI7E7Q46.js";
-import "./chunk-AI2RFMBT.js";
-import "./chunk-K6MAA3RM.js";
+} from "./chunk-TIE5OAMF.js";
+import "./chunk-IRHK7GH7.js";
+import "./chunk-3ZRPBRAE.js";
 export {
   Fragment,
   jsx,

package/dist/testing.d.ts

@@ -1,3 +1,5 @@
+import { Token as Token$1 } from './contracts.js';
+
 /** A typed, runtime-unique key for container bindings. */
 interface Token<T> {
     readonly id: symbol;
@@ -73,14 +75,14 @@ interface Application extends Container {
     terminating(callback: () => void | Promise<void>): void;
     terminate(): Promise<void>;
 }
-declare const Application: Token<Application>;
+declare const Application: Token$1<Application>;
 interface ExceptionHandler {
     report(error: unknown): Promise<void>;
     shouldReport(error: unknown): boolean;
     /** `request` is the scoped HttpRequest (Contracts/Http) when available, else the raw Request. */
     render(request: unknown, error: unknown): Promise<Response>;
 }
-declare const ExceptionHandler: Token<ExceptionHandler>;
+declare const ExceptionHandler: Token$1<ExceptionHandler>;
 
 interface Arrayable<T = unknown> {
     toArray(): T;
@@ -121,7 +123,7 @@ interface Session {
     previousUrl(): string | undefined;
     setPreviousUrl(url: string): void;
 }
-declare const Session: Token<Session>;
+declare const Session: Token$1<Session>;
 interface UploadedFile {
     readonly clientName: string;
     readonly mimeType: string;
@@ -141,7 +143,7 @@ interface Encrypter {
     decryptString(payload: string): string;
     getKey(): Uint8Array;
 }
-declare const Encrypter: Token<Encrypter>;
+declare const Encrypter: Token$1<Encrypter>;
 
 interface View extends Htmlable {
     readonly name: string;
@@ -155,7 +157,7 @@ interface ViewFactory {
     share(key: string | Record<string, unknown>, value?: unknown): void;
     composer(views: string | string[], composer: (view: View) => void | Promise<void>): void;
 }
-declare const ViewFactory: Token<ViewFactory>;
+declare const ViewFactory: Token$1<ViewFactory>;
 
 type Operator = '=' | '!=' | '<>' | '<' | '<=' | '>' | '>=' | 'like' | 'not like' | 'ilike' | 'in' | 'not in';
 type Row = Record<string, unknown>;
@@ -219,7 +221,7 @@ interface DatabaseManager extends DatabaseConnection {
     connection(name?: string): DatabaseConnection;
     disconnect(name?: string): Promise<void>;
 }
-declare const DatabaseManager: Token<DatabaseManager>;
+declare const DatabaseManager: Token$1<DatabaseManager>;
 /** What non-Database components may rely on from a model instance. */
 interface ModelInstance {
     exists: boolean;
@@ -276,7 +278,7 @@ interface AuthFactory {
     extend(driver: string, factory: (name: string, config: Record<string, unknown>) => Guard): void;
     provider(driver: string, factory: (config: Record<string, unknown>) => UserProvider): void;
 }
-declare const AuthFactory: Token<AuthFactory>;
+declare const AuthFactory: Token$1<AuthFactory>;
 
 /** Options a job class may declare as public fields. Their presence (or implementing ShouldQueue) makes things queueable. */
 interface ShouldQueue {
@@ -339,7 +341,7 @@ interface QueueManager extends Queue {
     connection(name?: string): Queue;
     extend(driver: string, factory: (config: Record<string, unknown>) => Queue): void;
 }
-declare const QueueManager: Token<QueueManager>;
+declare const QueueManager: Token$1<QueueManager>;
 
 interface Batch {
     readonly id: string;
@@ -379,7 +381,7 @@ interface BusDispatcher {
     batch(jobs: Job[]): PendingBatch;
     findBatch(id: string): Promise<Batch | undefined>;
 }
-declare const BusDispatcher: Token<BusDispatcher>;
+declare const BusDispatcher: Token$1<BusDispatcher>;
 /** What PendingBatch hands to the repository. Callbacks are jobs, because closures can't be serialized. */
 interface PendingBatchOptions {
     name: string;
@@ -470,7 +472,7 @@ interface MailManager extends Mailer {
     mailer(name?: string): Mailer;
     extend(transport: string, factory: (config: Record<string, unknown>) => MailTransport): void;
 }
-declare const MailManager: Token<MailManager>;
+declare const MailManager: Token$1<MailManager>;
 
 interface Notifiable {
     /** e.g. 'mail' → email address, 'database' → the model itself. */
@@ -498,7 +500,7 @@ interface NotificationDispatcher {
     };
     extend(channel: string, factory: () => NotificationChannel): void;
 }
-declare const NotificationDispatcher: Token<NotificationDispatcher>;
+declare const NotificationDispatcher: Token$1<NotificationDispatcher>;
 
 type ListenerClass<E> = Class<{
     handle(event: E): unknown;
@@ -517,7 +519,7 @@ interface EventDispatcher {
     }>): void;
     forget(event: Class<unknown> | string): void;
 }
-declare const EventDispatcher: Token<EventDispatcher>;
+declare const EventDispatcher: Token$1<EventDispatcher>;
 
 interface PutOptions {
     visibility?: 'public' | 'private';
@@ -553,7 +555,48 @@ interface FilesystemManager extends Filesystem {
     disk(name?: string): Filesystem;
     extend(driver: string, factory: (config: Record<string, unknown>) => Filesystem): void;
 }
-declare const FilesystemManager: Token<FilesystemManager>;
+declare const FilesystemManager: Token$1<FilesystemManager>;
+
+/** Infinite-scroll metadata for one prop (page.scrollProps[path]). */
+interface InertiaScrollProp {
+    pageName: string;
+    previousPage: string | number | null;
+    nextPage: string | number | null;
+    currentPage: string | number | null;
+    reset: boolean;
+}
+/** A once prop the client keeps between visits (page.onceProps[key]). `expiresAt` is epoch milliseconds. */
+interface InertiaOnceProp {
+    prop: string;
+    expiresAt: number | null;
+}
+/**
+ * The Inertia page object (protocol v3, @inertiajs/core 3.x). Only component, props, url and version are always
+ * present; the other fields are left out when empty or false.
+ */
+interface InertiaPage {
+    component: string;
+    props: Record<string, unknown>;
+    /** Path and query, never absolute: '/posts?page=2'. */
+    url: string;
+    /** '' when the app has no asset version. */
+    version: string;
+    sharedProps?: string[];
+    mergeProps?: string[];
+    prependProps?: string[];
+    deepMergeProps?: string[];
+    /** '<prop path>.<key field>', e.g. 'posts.data.id'. */
+    matchPropsOn?: string[];
+    /** Group name → prop paths loaded after the first render. */
+    deferredProps?: Record<string, string[]>;
+    rescuedProps?: string[];
+    scrollProps?: Record<string, InertiaScrollProp>;
+    onceProps?: Record<string, InertiaOnceProp>;
+    clearHistory?: true;
+    encryptHistory?: true;
+    flash?: Record<string, unknown>;
+    preserveFragment?: true;
+}
 
 /**
  * Laravel's PendingCommand: `await t.artisan('inspire').expectsOutput('…').assertExitCode(0)`.
@@ -598,6 +641,90 @@ type JsonStructure = Array<string | {
     [key: string]: JsonStructure;
 };
 
+type Json = unknown;
+type Scope<T extends AssertableJson> = (json: T) => unknown;
+/**
+ * Laravel's Illuminate\Testing\Fluent\AssertableJson: fluent, scoped assertions over decoded JSON. Inside a scope
+ * (has(key, callback), first(), each()) every property must be interacted with, or etc() must be called.
+ */
+declare class AssertableJson {
+    protected readonly props: Json;
+    protected readonly path: string | undefined;
+    protected interactedKeys: string[];
+    constructor(props: Json, path?: string | undefined);
+    static fromJson(json: Json): AssertableJson;
+    /** A child scope of the same class (subclasses override to keep their extra state out of scopes). */
+    protected newScope(props: Json, path: string): AssertableJson;
+    protected dotPath(key?: string): string;
+    /** The value at `key` in this scope, or the whole scope. */
+    protected prop(key?: string): Json;
+    /** A literal key of this scope wins over a dot path, like Laravel's Arr::get (keys such as 'items.0.name'). */
+    private hasOwnKey;
+    private exists;
+    protected interactsWith(key: string | number): void;
+    /** Every property of the scope was checked (called when a scope ends). */
+    interacted(): void;
+    /** Allow the properties this scope didn't check. */
+    etc(): this;
+    /** has('key'), has('key', 3), has('key', json => …), has('key', 3, first => …), or has(3) for the root size. */
+    has(key: string | number, length?: number | Scope<this>, callback?: Scope<this>): this;
+    /** hasAll(['a', 'b']) or hasAll({ items: 3 }). */
+    hasAll(keys: string | string[] | Record<string, number>): this;
+    hasAny(keys: string | string[]): this;
+    missing(key: string): this;
+    missingAll(keys: string | string[]): this;
+    /** count(3) checks this scope's size; count('items', 3) a property's. */
+    count(key: string | number, length?: number): this;
+    countBetween(key: string, min: number, max: number): this;
+    /** where('name', 'Ann'), or where('name', value => value.startsWith('A')). Objects compare ignoring key order. */
+    where(key: string, expected: unknown): this;
+    whereNot(key: string, expected: unknown): this;
+    whereNull(key: string): this;
+    whereNotNull(key: string): this;
+    whereAll(bindings: Record<string, unknown>): this;
+    /** whereType('id', 'integer'), whereType('name', 'string|null'), whereType('tags', ['array', 'null']). */
+    whereType(key: string, expected: string | string[]): this;
+    whereAllType(bindings: Record<string, string | string[]>): this;
+    /** The list contains every expected value (or one passing the callback); a string contains the substring. */
+    whereContains(key: string, expected: unknown): this;
+    protected scope(key: string, callback: Scope<this>): this;
+    first(callback: Scope<this>): this;
+    each(callback: Scope<this>): this;
+    when(condition: unknown, callback: (json: this) => unknown, otherwise?: (json: this) => unknown): this;
+    dump(key?: string): this;
+    toArray(): Json;
+}
+
+/** The page object of a response: the JSON body of an Inertia visit, or the page script of a first visit. */
+declare function inertiaPageOf(response: TestResponse): InertiaPage;
+/** Inertia's AssertableInertia: AssertableJson over the page props, plus the page component, url, version and flash. */
+declare class AssertableInertia extends AssertableJson {
+    #private;
+    static fromTestResponse(response: TestResponse): AssertableInertia;
+    /** Scopes are plain AssertableJson: the page-level methods only make sense at the root. */
+    protected newScope(props: unknown, path: string): AssertableJson;
+    get page(): InertiaPage;
+    /** The component name; the page file must exist unless `shouldExist` is false (inertia.testing.ensure_pages_exist). */
+    component(value?: string, shouldExist?: boolean): this;
+    url(value: string): this;
+    version(value: string): this;
+    /** The flash data has `key` (dot paths allowed), equal to `expected` when given. */
+    hasFlash(key: string, ...expected: [] | [unknown]): this;
+    missingFlash(key: string): this;
+    static assertFlashHas(flash: Record<string, unknown>, key: string, ...expected: [] | [unknown]): void;
+    static assertFlashMissing(flash: Record<string, unknown>, key: string): void;
+    /**
+     * Requests the page again as a partial reload (only/except) and checks it is the same page. Uses the test's
+     * HTTP client, so the session and cookies carry over.
+     */
+    reload(callback?: (page: AssertableInertia) => unknown, only?: string | string[], except?: string | string[]): Promise<this>;
+    reloadOnly(only: string | string[], callback?: (page: AssertableInertia) => unknown): Promise<this>;
+    reloadExcept(except: string | string[], callback?: (page: AssertableInertia) => unknown): Promise<this>;
+    /** Loads the deferred props of every group (or the given groups) in one partial reload. */
+    loadDeferredProps(groupsOrCallback: string | string[] | ((page: AssertableInertia) => unknown), callback?: (page: AssertableInertia) => unknown): Promise<this>;
+    toArray(): Record<string, unknown>;
+}
+
 /** Laravel's CookieValuePrefix: hmac_sha1(name + 'v2', key) + '|' (41 characters), as Auth's EncryptCookies writes it. */
 declare function cookiePrefix(name: string, key: Uint8Array): string;
 /** What EncryptCookies puts in a browser cookie: encrypt(prefix + value, serialize: false). */
@@ -637,6 +764,8 @@ interface ResponseContext {
     views?: View[];
     /** The last error the exception handler rendered. */
     exception?: unknown;
+    /** The client that sent the request (Inertia reloads reuse it, keeping the session and cookies). */
+    client?: HttpClient;
 }
 /** Laravel's TestResponse: a Response with its body already read, plus fluent assertions. */
 declare class TestResponse {
@@ -700,8 +829,24 @@ declare class TestResponse {
     assertSeeText(value: string | string[], escape?: boolean): this;
     assertDontSeeText(value: string | string[], escape?: boolean): this;
     assertSeeTextInOrder(values: string[], escape?: boolean): this;
-    /** The response JSON contains `data` (a subset match: extra keys in the response are fine). */
-    assertJson(data: Record<string, unknown> | unknown[]): this;
+    /**
+     * The response JSON contains `data` (a subset match: extra keys in the response are fine), or fluent
+     * assertions: assertJson(json => json.has('data', 3).etc()).
+     */
+    assertJson(data: Record<string, unknown> | unknown[] | ((json: AssertableJson) => unknown)): this;
+    /**
+     * An Inertia page response, with optional fluent assertions over its props. An async callback (reload(),
+     * loadDeferredProps()) makes this return a promise: await it.
+     */
+    assertInertia(callback: (page: AssertableInertia) => Promise<unknown>): Promise<this>;
+    assertInertia(callback?: (page: AssertableInertia) => unknown): this;
+    /** The Inertia page object of this response. */
+    inertiaPage(): InertiaPage;
+    /** The page props, or one prop by dot path. */
+    inertiaProps<T = unknown>(key?: string): T;
+    /** Inertia flash data waiting in the session for the next page (after a redirect). */
+    assertInertiaFlash(key: string, ...expected: [] | [unknown]): this;
+    assertInertiaFlashMissing(key: string): this;
     /** The response JSON equals `data` exactly (object key order is ignored). */
     assertExactJson(data: unknown): this;
     /** The value at `path` equals `expected` (strictly), or passes the predicate. */
@@ -1405,4 +1550,4 @@ declare const FakeFile: {
     image(name: string, width?: number, height?: number): File;
 };
 
-export { AnonymousNotifiable, type BatchRecord, type BootOptions, BusFake, type CountOrFilter, DatabaseMigrations, type DatabaseTestOptions, DatabaseTransactions, type DispatchedEvent, EventFake, type ExpectedErrors, FakeDisk, FakeFile, HttpClient, InteractsWithApplication, InteractsWithConsole, InteractsWithDatabase, type JsonStructure, MailFake, MailRecord, MakesHttpRequests, NotificationFake, PendingCommand, type PushedJob, QueueFake, RefreshDatabase, RefreshDatabaseState, type RequestData, type RequestOptions, type ResponseContext, type ResponseCookie, type SentNotification, StorageFake, TESTING_ENVIRONMENT, type TableOrModel, type Target, TestCase, type TestHooks, TestResponse, type TestTrait, actingAsAuthFactory, addresses, applyEnvironment, cookieHeader, cookiePrefix, decryptCookie, encryptCookie, flatten, guessMimeType, install, isExpired, matches, nameOf, recordingExceptionHandler, recordingViewFactory, responseCookies, runCommand, usingInMemoryDatabase };
+export { AnonymousNotifiable, AssertableInertia, AssertableJson, type BatchRecord, type BootOptions, BusFake, type CountOrFilter, DatabaseMigrations, type DatabaseTestOptions, DatabaseTransactions, type DispatchedEvent, EventFake, type ExpectedErrors, FakeDisk, FakeFile, HttpClient, InteractsWithApplication, InteractsWithConsole, InteractsWithDatabase, type JsonStructure, MailFake, MailRecord, MakesHttpRequests, NotificationFake, PendingCommand, type PushedJob, QueueFake, RefreshDatabase, RefreshDatabaseState, type RequestData, type RequestOptions, type ResponseContext, type ResponseCookie, type SentNotification, StorageFake, TESTING_ENVIRONMENT, type TableOrModel, type Target, TestCase, type TestHooks, TestResponse, type TestTrait, actingAsAuthFactory, addresses, applyEnvironment, cookieHeader, cookiePrefix, decryptCookie, encryptCookie, flatten, guessMimeType, inertiaPageOf, install, isExpired, matches, nameOf, recordingExceptionHandler, recordingViewFactory, responseCookies, runCommand, usingInMemoryDatabase };

package/dist/testing.js

@@ -1,5 +1,7 @@
 import {
   AnonymousNotifiable,
+  AssertableInertia,
+  AssertableJson,
   BusFake,
   DatabaseMigrations,
   DatabaseTransactions,
@@ -31,6 +33,7 @@ import {
   encryptCookie,
   flatten,
   guessMimeType,
+  inertiaPageOf,
   install,
   isExpired,
   matches,
@@ -40,11 +43,13 @@ import {
   responseCookies,
   runCommand,
   usingInMemoryDatabase
-} from "./chunk-BZPCRKFQ.js";
-import "./chunk-AI2RFMBT.js";
-import "./chunk-K6MAA3RM.js";
+} from "./chunk-UPZAML2Q.js";
+import "./chunk-IRHK7GH7.js";
+import "./chunk-3ZRPBRAE.js";
 export {
   AnonymousNotifiable,
+  AssertableInertia,
+  AssertableJson,
   BusFake,
   DatabaseMigrations,
   DatabaseTransactions,
@@ -76,6 +81,7 @@ export {
   encryptCookie,
   flatten,
   guessMimeType,
+  inertiaPageOf,
   install,
   isExpired,
   matches,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@orieljs/framework",
-  "version": "0.1.0-alpha.1",
+  "version": "0.1.0-alpha.2",
   "description": "Oriel: a Laravel-style, full-stack TypeScript framework for Node.js and Bun.",
   "type": "module",
   "license": "Apache-2.0",
@@ -55,33 +55,34 @@
     "pluralize": "8.0.0"
   },
   "devDependencies": {
-    "@orieljs/auth": "0.1.0-alpha.1",
-    "@orieljs/bus": "0.1.0-alpha.1",
-    "@orieljs/cache": "0.1.0-alpha.1",
-    "@orieljs/collections": "0.1.0-alpha.1",
-    "@orieljs/config": "0.1.0-alpha.1",
-    "@orieljs/console": "0.1.0-alpha.1",
-    "@orieljs/container": "0.1.0-alpha.1",
-    "@orieljs/contracts": "0.1.0-alpha.1",
-    "@orieljs/cookie": "0.1.0-alpha.1",
-    "@orieljs/database": "0.1.0-alpha.1",
-    "@orieljs/encryption": "0.1.0-alpha.1",
-    "@orieljs/events": "0.1.0-alpha.1",
-    "@orieljs/filesystem": "0.1.0-alpha.1",
-    "@orieljs/foundation": "0.1.0-alpha.1",
-    "@orieljs/hashing": "0.1.0-alpha.1",
-    "@orieljs/http": "0.1.0-alpha.1",
-    "@orieljs/log": "0.1.0-alpha.1",
-    "@orieljs/mail": "0.1.0-alpha.1",
-    "@orieljs/notifications": "0.1.0-alpha.1",
-    "@orieljs/pipeline": "0.1.0-alpha.1",
-    "@orieljs/queue": "0.1.0-alpha.1",
-    "@orieljs/routing": "0.1.0-alpha.1",
-    "@orieljs/session": "0.1.0-alpha.1",
-    "@orieljs/support": "0.1.0-alpha.1",
-    "@orieljs/testing": "0.1.0-alpha.1",
-    "@orieljs/validation": "0.1.0-alpha.1",
-    "@orieljs/view": "0.1.0-alpha.1"
+    "@orieljs/auth": "0.1.0-alpha.2",
+    "@orieljs/bus": "0.1.0-alpha.2",
+    "@orieljs/cache": "0.1.0-alpha.2",
+    "@orieljs/collections": "0.1.0-alpha.2",
+    "@orieljs/config": "0.1.0-alpha.2",
+    "@orieljs/console": "0.1.0-alpha.2",
+    "@orieljs/contracts": "0.1.0-alpha.2",
+    "@orieljs/container": "0.1.0-alpha.2",
+    "@orieljs/database": "0.1.0-alpha.2",
+    "@orieljs/cookie": "0.1.0-alpha.2",
+    "@orieljs/encryption": "0.1.0-alpha.2",
+    "@orieljs/events": "0.1.0-alpha.2",
+    "@orieljs/filesystem": "0.1.0-alpha.2",
+    "@orieljs/foundation": "0.1.0-alpha.2",
+    "@orieljs/hashing": "0.1.0-alpha.2",
+    "@orieljs/http": "0.1.0-alpha.2",
+    "@orieljs/log": "0.1.0-alpha.2",
+    "@orieljs/mail": "0.1.0-alpha.2",
+    "@orieljs/inertia": "0.1.0-alpha.2",
+    "@orieljs/notifications": "0.1.0-alpha.2",
+    "@orieljs/pipeline": "0.1.0-alpha.2",
+    "@orieljs/queue": "0.1.0-alpha.2",
+    "@orieljs/routing": "0.1.0-alpha.2",
+    "@orieljs/support": "0.1.0-alpha.2",
+    "@orieljs/testing": "0.1.0-alpha.2",
+    "@orieljs/session": "0.1.0-alpha.2",
+    "@orieljs/validation": "0.1.0-alpha.2",
+    "@orieljs/view": "0.1.0-alpha.2"
   },
   "peerDependencies": {
     "pg": "^8.23.0",