@beeblock/svelar 0.4.0

package/dist/routing/Controller.d.ts

@@ -0,0 +1,115 @@
+/**
+ * Svelar Controller
+ *
+ * Laravel-inspired base Controller class for SvelteKit route handlers.
+ *
+ * @example
+ * ```ts
+ * // src/lib/controllers/UserController.ts
+ * class UserController extends Controller {
+ *   async index(event: RequestEvent) {
+ *     const users = await User.all();
+ *     return this.json(users);
+ *   }
+ *
+ *   async show(event: RequestEvent) {
+ *     const user = await User.findOrFail(event.params.id);
+ *     return this.json(user);
+ *   }
+ *
+ *   async store(event: RequestEvent) {
+ *     const data = await this.validate(event, {
+ *       email: z.string().email(),
+ *       name: z.string().min(2),
+ *     });
+ *     const user = await User.create(data);
+ *     return this.json(user, 201);
+ *   }
+ * }
+ *
+ * // src/routes/api/users/+server.ts
+ * import { UserController } from '$lib/controllers/UserController';
+ * const ctrl = new UserController();
+ * export const GET = ctrl.handle('index');
+ * export const POST = ctrl.handle('store');
+ * ```
+ */
+import { z, type ZodObject, type ZodRawShape } from 'zod';
+import { type MiddlewareHandler, Middleware } from '../middleware/Middleware.js';
+export interface RequestEvent {
+    request: Request;
+    url: URL;
+    params: Record<string, string>;
+    locals: Record<string, any>;
+    getClientAddress: () => string;
+    cookies: any;
+    platform: any;
+}
+export declare abstract class Controller {
+    private controllerMiddleware;
+    /**
+     * Register middleware for this controller
+     */
+    protected middleware(middleware: Middleware | MiddlewareHandler | (new () => Middleware), options?: {
+        only?: string[];
+        except?: string[];
+    }): void;
+    /**
+     * Create a SvelteKit-compatible request handler bound to a controller method.
+     *
+     * @example
+     * ```ts
+     * export const GET = ctrl.handle('index');
+     * export const POST = ctrl.handle('store');
+     * ```
+     */
+    handle(method: string): (event: RequestEvent) => Promise<Response>;
+    protected json(data: any, status?: number, headers?: Record<string, string>): Response;
+    protected text(content: string, status?: number): Response;
+    protected html(content: string, status?: number): Response;
+    protected redirect(url: string, status?: number): Response;
+    protected noContent(): Response;
+    protected created(data?: any): Response;
+    protected validate<T extends ZodRawShape>(event: RequestEvent, schema: ZodObject<T> | T): Promise<z.infer<ZodObject<T>>>;
+    /**
+     * Validate query parameters
+     */
+    protected validateQuery<T extends ZodRawShape>(event: RequestEvent, schema: ZodObject<T> | T): z.infer<ZodObject<T>>;
+    /**
+     * Validate route parameters
+     */
+    protected validateParams<T extends ZodRawShape>(event: RequestEvent, schema: ZodObject<T> | T): z.infer<ZodObject<T>>;
+    protected handleError(error: any, event: RequestEvent): Response;
+    private callMethod;
+}
+/**
+ * Helper to bind all CRUD methods of a ResourceController to SvelteKit handlers.
+ *
+ * @example
+ * ```ts
+ * // src/routes/api/users/+server.ts
+ * import { resource } from 'svelar/routing';
+ * import { UserController } from '$lib/controllers/UserController';
+ *
+ * const { GET, POST } = resource(UserController);
+ * export { GET, POST };
+ *
+ * // src/routes/api/users/[id]/+server.ts
+ * const { GET, PUT, DELETE } = resource(UserController, true);
+ * export { GET, PUT, DELETE };
+ * ```
+ */
+export declare function resource<T extends Controller>(ControllerClass: new () => T, isSingleResource?: boolean): Record<string, (event: RequestEvent) => Promise<Response>>;
+export declare class ValidationError extends Error {
+    errors: Record<string, string[]>;
+    constructor(zodError: z.ZodError);
+}
+export declare class NotFoundError extends Error {
+    constructor(message?: string);
+}
+export declare class UnauthorizedError extends Error {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends Error {
+    constructor(message?: string);
+}

package/dist/routing/FormRequest.d.ts

@@ -0,0 +1,94 @@
+/**
+ * Svelar Form Request
+ *
+ * Dedicated validation classes for complex request validation.
+ * Inspired by Laravel's Form Request.
+ *
+ * @example
+ * ```ts
+ * import { FormRequest } from 'svelar/routing';
+ * import { z } from 'svelar/validation';
+ *
+ * class CreateUserRequest extends FormRequest {
+ *   rules() {
+ *     return z.object({
+ *       name: z.string().min(2).max(100),
+ *       email: z.string().email(),
+ *       password: z.string().min(8),
+ *       password_confirmation: z.string(),
+ *     }).refine(data => data.password === data.password_confirmation, {
+ *       message: 'Passwords do not match',
+ *       path: ['password_confirmation'],
+ *     });
+ *   }
+ *
+ *   authorize(event: RequestEvent): boolean {
+ *     return true; // Or check event.locals.user
+ *   }
+ *
+ *   messages() {
+ *     return {
+ *       'name.min': 'Name must be at least 2 characters',
+ *     };
+ *   }
+ * }
+ *
+ * // In a controller:
+ * const data = await CreateUserRequest.validate(event);
+ * ```
+ */
+import { z, type ZodTypeAny } from 'zod';
+import type { RequestEvent } from './Controller.js';
+export declare abstract class FormRequest {
+    /**
+     * Define the validation rules (return a Zod schema)
+     */
+    abstract rules(): ZodTypeAny;
+    /**
+     * Determine if the user is authorized to make this request.
+     * Override to add authorization logic.
+     */
+    authorize(event: RequestEvent): boolean | Promise<boolean>;
+    /**
+     * Custom error messages (optional override).
+     * Keys are 'field.rule' format.
+     */
+    messages(): Record<string, string>;
+    /**
+     * Custom attribute names for error messages (optional).
+     */
+    attributes(): Record<string, string>;
+    /**
+     * Transform data after validation (optional).
+     */
+    passedValidation(data: any): any;
+    /**
+     * Called when validation fails (optional override).
+     * By default throws a Response.
+     */
+    failedValidation(errors: Record<string, string[]>): never;
+    /**
+     * Called when authorization fails (optional override).
+     */
+    failedAuthorization(): never;
+    /**
+     * Parse request body based on content type
+     */
+    protected parseBody(event: RequestEvent): Promise<any>;
+    /**
+     * Validate a request using this FormRequest class.
+     * Static factory method for convenience.
+     */
+    static validate<T extends FormRequest>(this: new () => T, event: RequestEvent): Promise<z.infer<ReturnType<T['rules']>>>;
+}
+export declare class FormValidationError extends Error {
+    readonly errors: Record<string, string[]>;
+    readonly statusCode = 422;
+    constructor(errors: Record<string, string[]>);
+    toResponse(): Response;
+}
+export declare class FormAuthorizationError extends Error {
+    readonly statusCode = 403;
+    constructor(message?: string);
+    toResponse(): Response;
+}

package/dist/routing/Resource.d.ts

@@ -0,0 +1,213 @@
+/**
+ * Svelar Resource (API Response Transformer)
+ *
+ * Laravel-inspired JsonResource for shaping API responses.
+ * Controls exactly what data is exposed and how it's structured.
+ *
+ * The second generic `TShape` defines the API contract — the shape returned
+ * by `toJSON()`. Export this type from your resource file and import it on
+ * the frontend. Define once, use everywhere.
+ *
+ * @example
+ * ```ts
+ * // Define the contract once
+ * export interface UserData {
+ *   id: number;
+ *   name: string;
+ *   email: string;
+ * }
+ *
+ * export class UserResource extends Resource<User, UserData> {
+ *   toJSON(): UserData {
+ *     return {
+ *       id: this.data.id,
+ *       name: this.data.name,
+ *       email: this.data.email,
+ *     };
+ *   }
+ * }
+ *
+ * // Frontend — import the same type
+ * import type { UserData } from '$lib/modules/auth/UserResource';
+ * const { data } = await apiFetchJson<{ data: UserData }>('/api/users/1');
+ * ```
+ */
+/**
+ * Extract the output shape from a Resource class.
+ *
+ * @example
+ * ```ts
+ * type User = InferResource<UserResource>;
+ * // { id: number; name: string; email: string; }
+ * ```
+ */
+export type InferResource<R> = R extends Resource<any, infer TShape> ? TShape : never;
+/**
+ * Wrapped single resource response shape.
+ *
+ * @example
+ * ```ts
+ * type UserResponse = ResourceData<UserResource>;
+ * // { data: { id: number; name: string; email: string; } }
+ * ```
+ */
+export type ResourceData<R> = R extends Resource<any, infer TShape> ? {
+    data: TShape;
+    [key: string]: any;
+} : never;
+/**
+ * Wrapped collection response shape with pagination metadata.
+ *
+ * @example
+ * ```ts
+ * type UsersResponse = ResourceCollection<UserResource>;
+ * // { data: UserData[]; meta?: { total: number; page: number; ... } }
+ * ```
+ */
+export type ResourceCollection<R> = R extends Resource<any, infer TShape> ? {
+    data: TShape[];
+    meta?: Record<string, any>;
+    [key: string]: any;
+} : never;
+export declare abstract class Resource<TModel = any, TShape extends Record<string, any> = Record<string, any>> {
+    protected data: TModel;
+    constructor(data: TModel);
+    /**
+     * Define the response shape. Override this in your resource class.
+     * The return type should match TShape for full type safety.
+     */
+    abstract toJSON(): TShape;
+    /**
+     * Define top-level data included alongside the resource.
+     * Override this to add roles, permissions, related context, etc.
+     * Called automatically by make(), collection(), and paginate().
+     *
+     * Can be sync or async.
+     */
+    toWith(): Record<string, any> | Promise<Record<string, any>>;
+    /**
+     * Define metadata included under the "meta" key.
+     * Override this to add counts, flags, or computed summaries.
+     * Called automatically by make(), collection(), and paginate().
+     *
+     * Can be sync or async.
+     */
+    toAdditional(): Record<string, any> | Promise<Record<string, any>>;
+    /**
+     * Wrap a single item in a resource.
+     */
+    static make<TModel, TShape extends Record<string, any>, R extends Resource<TModel, TShape>>(this: new (data: TModel) => R, data: TModel): ResourceResponse;
+    /**
+     * Wrap an array of items in resources.
+     */
+    static collection<TModel, TShape extends Record<string, any>, R extends Resource<TModel, TShape>>(this: new (data: TModel) => R, items: TModel[]): ResourceCollectionResponse;
+    /**
+     * Wrap a PaginationResult — transforms items and auto-includes pagination metadata.
+     *
+     * Accepts the result of `Model.query().paginate()` or `Repository.paginate()`.
+     *
+     * @example
+     * ```ts
+     * const result = await User.query().paginate(page, 20);
+     * return UserResource.paginate(result).toResponse();
+     * // { data: [...], meta: { total, page, per_page, last_page, has_more } }
+     * ```
+     */
+    static paginate<TModel, TShape extends Record<string, any>, R extends Resource<TModel, TShape>>(this: new (data: TModel) => R, result: {
+        data: TModel[];
+        total: number;
+        page: number;
+        perPage: number;
+        lastPage: number;
+        hasMore: boolean;
+    }): ResourceCollectionResponse;
+}
+export declare class ResourceResponse {
+    private data;
+    private meta;
+    private extra;
+    private wrap;
+    private statusCode;
+    private extraHeaders;
+    private deferredWith;
+    private deferredAdditional;
+    constructor(data: Record<string, any>);
+    /** @internal — used by Resource.make() to attach toWith() */
+    _deferWith(result: Record<string, any> | Promise<Record<string, any>>): void;
+    /** @internal — used by Resource.make() to attach toAdditional() */
+    _deferAdditional(result: Record<string, any> | Promise<Record<string, any>>): void;
+    /**
+     * Add metadata to the response (nested under "meta").
+     */
+    additional(meta: Record<string, any>): this;
+    /**
+     * Add top-level data alongside the resource.
+     *
+     * For data that should always be included, override `toWith()` in
+     * the Resource class instead — then controllers don't need to repeat it.
+     */
+    with(data: Record<string, any>): this;
+    /**
+     * Change the wrapping key (default: "data"). Use null to unwrap.
+     */
+    wrapper(key: string | null): this;
+    /**
+     * Set the HTTP status code.
+     */
+    status(code: number): this;
+    /**
+     * Add response headers.
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Build the plain object (for serialization or testing).
+     */
+    toObject(): Promise<Record<string, any>>;
+    /**
+     * Convert to a Response object for SvelteKit handlers.
+     */
+    toResponse(): Promise<Response>;
+}
+export declare class ResourceCollectionResponse {
+    private items;
+    private meta;
+    private extra;
+    private wrap;
+    private statusCode;
+    private extraHeaders;
+    private deferredInstances;
+    constructor(items: Record<string, any>[]);
+    /** @internal — used by Resource.collection()/paginate() */
+    _deferCollectionExtras(instances: Resource[]): void;
+    /**
+     * Add metadata (pagination, totals, etc.) — nested under "meta".
+     */
+    additional(meta: Record<string, any>): this;
+    /**
+     * Add top-level data alongside the collection.
+     *
+     * For data that should always be included, override `toWith()` in
+     * the Resource class instead.
+     */
+    with(data: Record<string, any>): this;
+    /**
+     * Change the wrapping key.
+     */
+    wrapper(key: string | null): this;
+    /**
+     * Set HTTP status code.
+     */
+    status(code: number): this;
+    /**
+     * Add response headers.
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Build the plain object.
+     */
+    toObject(): Promise<Record<string, any>>;
+    /**
+     * Convert to a Response object.
+     */
+    toResponse(): Promise<Response>;
+}

package/dist/routing/Response.d.ts

@@ -0,0 +1,138 @@
+/**
+ * Svelar Response Classes
+ *
+ * Laravel-inspired dedicated response objects for SvelteKit route handlers.
+ * These provide a fluent, testable API for building HTTP responses outside
+ * of controllers.
+ *
+ * @example
+ * ```ts
+ * import { JsonResponse, RedirectResponse } from '@beeblock/svelar/routing';
+ *
+ * return new JsonResponse({ name: 'John' });
+ * return new JsonResponse({ message: 'Created' }, 201);
+ * return JsonResponse.success({ id: 1 });
+ * return JsonResponse.error('Not found', 404);
+ * return new RedirectResponse('/login');
+ * return new DownloadResponse(buffer, 'report.pdf');
+ * return new StreamedResponse(readableStream, 'text/event-stream');
+ * ```
+ */
+export declare class JsonResponse {
+    private statusCode;
+    private body;
+    private extraHeaders;
+    constructor(data?: any, status?: number, headers?: Record<string, string>);
+    /**
+     * Set response headers (fluent).
+     */
+    header(name: string, value: string): this;
+    /**
+     * Set multiple headers (fluent).
+     */
+    headers(headers: Record<string, string>): this;
+    /**
+     * Set the status code (fluent).
+     */
+    status(code: number): this;
+    /**
+     * Convert to a Response object.
+     */
+    toResponse(): Response;
+    /** 200 with data */
+    static success(data: any, headers?: Record<string, string>): Response;
+    /** 201 Created */
+    static created(data: any, headers?: Record<string, string>): Response;
+    /** Error response with message */
+    static error(message: string, status?: number, errors?: Record<string, string[]>): Response;
+    /** 422 Validation Error */
+    static validationError(errors: Record<string, string[]>, message?: string): Response;
+    /** 204 No Content */
+    static noContent(): Response;
+}
+export declare class RedirectResponse {
+    private statusCode;
+    private url;
+    private extraHeaders;
+    constructor(url: string, status?: number);
+    /**
+     * Set additional headers.
+     */
+    header(name: string, value: string): this;
+    /**
+     * Convert to a Response object.
+     */
+    toResponse(): Response;
+    /** 302 Temporary redirect */
+    static to(url: string): Response;
+    /** 301 Permanent redirect */
+    static permanent(url: string): Response;
+    /** 307 Temporary redirect (preserves method) */
+    static temporary(url: string): Response;
+    /** Redirect back using Referer header, with a fallback URL */
+    static back(request: Request, fallback?: string): Response;
+}
+export declare class DownloadResponse {
+    private statusCode;
+    private body;
+    private filename;
+    private contentType;
+    private extraHeaders;
+    constructor(body: BodyInit, filename: string, contentType?: string);
+    /**
+     * Set additional headers.
+     */
+    header(name: string, value: string): this;
+    /**
+     * Set the status code.
+     */
+    status(code: number): this;
+    /**
+     * Convert to a Response object with Content-Disposition: attachment.
+     */
+    toResponse(): Response;
+    /** Download from a string or buffer */
+    static make(body: BodyInit, filename: string, contentType?: string): Response;
+    /** Download JSON as a file */
+    static json(data: any, filename?: string): Response;
+    /** Download CSV */
+    static csv(content: string, filename?: string): Response;
+    private inferContentType;
+}
+export declare class StreamedResponse {
+    private statusCode;
+    private body;
+    private contentType;
+    private extraHeaders;
+    constructor(body: ReadableStream | BodyInit, contentType?: string);
+    /**
+     * Set additional headers.
+     */
+    header(name: string, value: string): this;
+    /**
+     * Set the status code.
+     */
+    status(code: number): this;
+    /**
+     * Convert to a Response object.
+     */
+    toResponse(): Response;
+    /**
+     * Create an SSE (Server-Sent Events) stream from a generator function.
+     *
+     * @example
+     * ```ts
+     * return StreamedResponse.sse(async function* () {
+     *   yield { event: 'update', data: { count: 1 } };
+     *   yield { data: 'plain text message' };
+     * });
+     * ```
+     */
+    static sse(generator: () => AsyncGenerator<{
+        event?: string;
+        data: any;
+        id?: string;
+    }, void, unknown>): Response;
+    /** Create a simple text stream */
+    static text(body: ReadableStream): Response;
+}

package/dist/routing/index.d.ts

@@ -0,0 +1,4 @@
+export { Controller, resource, ValidationError, NotFoundError, UnauthorizedError, ForbiddenError, type RequestEvent, } from './Controller.js';
+export { FormRequest, FormValidationError, FormAuthorizationError } from './FormRequest.js';
+export { Resource, ResourceResponse, ResourceCollectionResponse, type InferResource, type ResourceData, type ResourceCollection, } from './Resource.js';
+export { JsonResponse, RedirectResponse, DownloadResponse, StreamedResponse } from './Response.js';

package/dist/routing/index.js

@@ -0,0 +1,5 @@
+import{z as l}from"zod";var h=class{},g=class{middleware=[];namedMiddleware=new Map;use(e){return typeof e=="function"&&"prototype"in e&&typeof e.prototype?.handle=="function"?this.middleware.push(new e):this.middleware.push(e),this}register(e,t){return typeof t=="function"&&"prototype"in t&&typeof t.prototype?.handle=="function"?this.namedMiddleware.set(e,new t):this.namedMiddleware.set(e,t),this}get(e){return this.namedMiddleware.get(e)}async execute(e,t,s){let n=[...this.middleware];if(s)for(let o of s){let i=this.namedMiddleware.get(o);i&&n.push(i)}let a=t;for(let o=n.length-1;o>=0;o--){let i=n[o],d=a;typeof i.handle=="function"?a=()=>i.handle(e,d):a=()=>i(e,d)}return a()}count(){return this.middleware.length}};var T=class{controllerMiddleware=[];middleware(e,t){let s;typeof e=="function"&&e.prototype instanceof h?s=new e:s=e,this.controllerMiddleware.push({middleware:s,only:t?.only,except:t?.except})}handle(e){return async t=>{try{let s=this.controllerMiddleware.filter(n=>!(n.only&&!n.only.includes(e)||n.except&&n.except.includes(e)));if(s.length>0){let n=new g;for(let{middleware:i}of s)n.use(i);let a={event:t,params:t.params,locals:t.locals},o=await n.execute(a,async()=>this.callMethod(e,t));if(o instanceof Response)return o}return await this.callMethod(e,t)}catch(s){return this.handleError(s,t)}}}json(e,t=200,s={}){let n=JSON.stringify(e,null,2);return new Response(n,{status:t,headers:{"Content-Type":"application/json",...s}})}text(e,t=200){return new Response(e,{status:t,headers:{"Content-Type":"text/plain"}})}html(e,t=200){return new Response(e,{status:t,headers:{"Content-Type":"text/html"}})}redirect(e,t=302){return new Response(null,{status:t,headers:{Location:e}})}noContent(){return new Response(null,{status:204})}created(e){return e?this.json(e,201):new Response(null,{status:201})}async validate(e,t){let s=t instanceof l.ZodObject?t:l.object(t),n,a=e.request.headers.get("content-type")??"";if(a.includes("application/json"))n=await e.request.json();else if(a.includes("multipart/form-data")||a.includes("application/x-www-form-urlencoded")){let i=await e.request.formData();n=Object.fromEntries(i)}else n=Object.fromEntries(e.url.searchParams);let o=s.safeParse(n);if(!o.success)throw new c(o.error);return o.data}validateQuery(e,t){let s=t instanceof l.ZodObject?t:l.object(t),n=Object.fromEntries(e.url.searchParams),a=s.safeParse(n);if(!a.success)throw new c(a.error);return a.data}validateParams(e,t){let n=(t instanceof l.ZodObject?t:l.object(t)).safeParse(e.params);if(!n.success)throw new c(n.error);return n.data}handleError(e,t){return e instanceof c?this.json({message:"Validation failed",errors:e.errors},422):e instanceof m?this.json({message:e.message||"Not found"},404):e instanceof y?this.json({message:e.message||"Unauthorized"},401):e instanceof f?this.json({message:e.message||"Forbidden"},403):(console.error("[Svelar] Controller error:",e),this.json({message:process.env.NODE_ENV==="production"?"Internal server error":e.message},500))}async callMethod(e,t){let s=this[e];if(typeof s!="function")throw new Error(`Method "${e}" not found on controller "${this.constructor.name}".`);let n=await s.call(this,t);return n instanceof Response?n:this.json(n)}};function H(r,e=!1){let t=new r;return e?{GET:t.handle("show"),PUT:t.handle("update"),PATCH:t.handle("update"),DELETE:t.handle("destroy")}:{GET:t.handle("index"),POST:t.handle("store")}}var c=class extends Error{errors;constructor(e){super("Validation failed"),this.name="ValidationError",this.errors={};for(let t of e.issues){let s=t.path.join(".");this.errors[s]||(this.errors[s]=[]),this.errors[s].push(t.message)}}},m=class extends Error{constructor(e="Not found"){super(e),this.name="NotFoundError"}},y=class extends Error{constructor(e="Unauthorized"){super(e),this.name="UnauthorizedError"}},f=class extends Error{constructor(e="Forbidden"){super(e),this.name="ForbiddenError"}};var C=class{authorize(e){return!0}messages(){return{}}attributes(){return{}}passedValidation(e){return e}failedValidation(e){throw new R(e)}failedAuthorization(){throw new w}async parseBody(e){let t=e.request.headers.get("content-type")??"";if(t.includes("application/json"))return e.request.json();if(t.includes("multipart/form-data")||t.includes("application/x-www-form-urlencoded")){let s=await e.request.formData();return Object.fromEntries(s)}return Object.fromEntries(e.url.searchParams)}static async validate(e){let t=new this;await t.authorize(e)||t.failedAuthorization();let n=await t.parseBody(e),a={...Object.fromEntries(e.url.searchParams),...e.params,...n},i=t.rules().safeParse(a);if(!i.success){let d={},A=t.messages(),E=t.attributes();for(let b of i.error.issues){let p=b.path.join("."),v=E[p]??p;d[v]||(d[v]=[]);let N=`${p}.${b.code}`,q=A[N]??A[p];d[v].push(q??b.message)}t.failedValidation(d)}return t.passedValidation(i.data)}},R=class extends Error{constructor(t){super("The given data was invalid.");this.errors=t;this.name="FormValidationError"}statusCode=422;toResponse(){return new Response(JSON.stringify({message:this.message,errors:this.errors}),{status:422,headers:{"Content-Type":"application/json"}})}},w=class extends Error{statusCode=403;constructor(e="This action is unauthorized."){super(e),this.name="FormAuthorizationError"}toResponse(){return new Response(JSON.stringify({message:this.message}),{status:403,headers:{"Content-Type":"application/json"}})}};var M=class{constructor(e){this.data=e}toWith(){return{}}toAdditional(){return{}}static make(e){let t=new this(e),s=new x(t.toJSON());return s._deferWith(t.toWith()),s._deferAdditional(t.toAdditional()),s}static collection(e){let t=this,s=e.map(o=>new t(o)),n=s.map(o=>o.toJSON()),a=new u(n);return s.length>0&&a._deferCollectionExtras(s),a}static paginate(e){let t=this,s=e.data.map(o=>new t(o)),n=s.map(o=>o.toJSON()),a=new u(n).additional({total:e.total,page:e.page,per_page:e.perPage,last_page:e.lastPage,has_more:e.hasMore});return s.length>0&&a._deferCollectionExtras(s),a}},x=class{constructor(e){this.data=e}meta={};extra={};wrap="data";statusCode=200;extraHeaders={};deferredWith=null;deferredAdditional=null;_deferWith(e){this.deferredWith=e}_deferAdditional(e){this.deferredAdditional=e}additional(e){return this.meta={...this.meta,...e},this}with(e){return this.extra={...this.extra,...e},this}wrapper(e){return this.wrap=e??"",this}status(e){return this.statusCode=e,this}headers(e){return this.extraHeaders={...this.extraHeaders,...e},this}async toObject(){if(this.deferredWith){let t=await this.deferredWith;t&&Object.keys(t).length>0&&(this.extra={...t,...this.extra})}if(this.deferredAdditional){let t=await this.deferredAdditional;t&&Object.keys(t).length>0&&(this.meta={...t,...this.meta})}let e={};return this.wrap?e[this.wrap]=this.data:Object.assign(e,this.data),Object.keys(this.meta).length>0&&(e.meta=this.meta),Object.assign(e,this.extra),e}async toResponse(){let e=await this.toObject();return new Response(JSON.stringify(e,null,2),{status:this.statusCode,headers:{"Content-Type":"application/json",...this.extraHeaders}})}},u=class{constructor(e){this.items=e}meta={};extra={};wrap="data";statusCode=200;extraHeaders={};deferredInstances=null;_deferCollectionExtras(e){this.deferredInstances=e}additional(e){return this.meta={...this.meta,...e},this}with(e){return this.extra={...this.extra,...e},this}wrapper(e){return this.wrap=e??"",this}status(e){return this.statusCode=e,this}headers(e){return this.extraHeaders={...this.extraHeaders,...e},this}async toObject(){if(this.deferredInstances&&this.deferredInstances.length>0){let t=this.deferredInstances[0],s=await t.toWith();s&&Object.keys(s).length>0&&(this.extra={...s,...this.extra});let n=await t.toAdditional();n&&Object.keys(n).length>0&&(this.meta={...n,...this.meta})}let e={};if(this.wrap)e[this.wrap]=this.items;else return{items:this.items,...this.meta,...this.extra};return Object.keys(this.meta).length>0&&(e.meta=this.meta),Object.assign(e,this.extra),e}async toResponse(){let e=await this.toObject();return new Response(JSON.stringify(e,null,2),{status:this.statusCode,headers:{"Content-Type":"application/json",...this.extraHeaders}})}};var j=class r{statusCode;body;extraHeaders={};constructor(e=null,t=200,s={}){this.body=e,this.statusCode=t,this.extraHeaders=s}header(e,t){return this.extraHeaders[e]=t,this}headers(e){return Object.assign(this.extraHeaders,e),this}status(e){return this.statusCode=e,this}toResponse(){return new Response(JSON.stringify(this.body,null,2),{status:this.statusCode,headers:{"Content-Type":"application/json",...this.extraHeaders}})}static success(e,t){return new r(e,200,t).toResponse()}static created(e,t){return new r(e,201,t).toResponse()}static error(e,t=500,s){let n={message:e};return s&&(n.errors=s),new r(n,t).toResponse()}static validationError(e,t="Validation failed"){return new r({message:t,errors:e},422).toResponse()}static noContent(){return new Response(null,{status:204})}},P=class r{statusCode;url;extraHeaders={};constructor(e,t=302){this.url=e,this.statusCode=t}header(e,t){return this.extraHeaders[e]=t,this}toResponse(){return new Response(null,{status:this.statusCode,headers:{Location:this.url,...this.extraHeaders}})}static to(e){return new r(e,302).toResponse()}static permanent(e){return new r(e,301).toResponse()}static temporary(e){return new r(e,307).toResponse()}static back(e,t="/"){let s=e.headers.get("referer")??t;return new r(s,302).toResponse()}},S=class r{statusCode=200;body;filename;contentType;extraHeaders={};constructor(e,t,s){this.body=e,this.filename=t,this.contentType=s??this.inferContentType(t)}header(e,t){return this.extraHeaders[e]=t,this}status(e){return this.statusCode=e,this}toResponse(){return new Response(this.body,{status:this.statusCode,headers:{"Content-Type":this.contentType,"Content-Disposition":`attachment; filename="${this.filename}"`,...this.extraHeaders}})}static make(e,t,s){return new r(e,t,s).toResponse()}static json(e,t="data.json"){let s=JSON.stringify(e,null,2);return new r(s,t,"application/json").toResponse()}static csv(e,t="export.csv"){return new r(e,t,"text/csv; charset=utf-8").toResponse()}inferContentType(e){let t=e.split(".").pop()?.toLowerCase();return{json:"application/json",csv:"text/csv",txt:"text/plain",pdf:"application/pdf",zip:"application/zip",xml:"application/xml",html:"text/html",png:"image/png",jpg:"image/jpeg",jpeg:"image/jpeg",gif:"image/gif",svg:"image/svg+xml",xlsx:"application/vnd.openxmlformats-officedocument.spreadsheetml.sheet",docx:"application/vnd.openxmlformats-officedocument.wordprocessingml.document"}[t??""]??"application/octet-stream"}},O=class r{statusCode=200;body;contentType;extraHeaders={};constructor(e,t="text/event-stream"){this.body=e,this.contentType=t}header(e,t){return this.extraHeaders[e]=t,this}status(e){return this.statusCode=e,this}toResponse(){return new Response(this.body,{status:this.statusCode,headers:{"Content-Type":this.contentType,"Cache-Control":"no-cache",Connection:"keep-alive",...this.extraHeaders}})}static sse(e){let t=new ReadableStream({async start(s){let n=new TextEncoder;try{for await(let a of e()){let o="";a.id&&(o+=`id: ${a.id}
+`),a.event&&(o+=`event: ${a.event}
+`);let i=typeof a.data=="string"?a.data:JSON.stringify(a.data);o+=`data: ${i}
+
+`,s.enqueue(n.encode(o))}}catch{}finally{s.close()}}});return new r(t,"text/event-stream").toResponse()}static text(e){return new r(e,"text/plain").toResponse()}};export{T as Controller,S as DownloadResponse,f as ForbiddenError,w as FormAuthorizationError,C as FormRequest,R as FormValidationError,j as JsonResponse,m as NotFoundError,P as RedirectResponse,M as Resource,u as ResourceCollectionResponse,x as ResourceResponse,O as StreamedResponse,y as UnauthorizedError,c as ValidationError,H as resource};