@h3ravel/http 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 h3ravel
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.cjs

@@ -0,0 +1,371 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  ApiResource: () => ApiResource,
+  HttpServiceProvider: () => HttpServiceProvider,
+  JsonResource: () => JsonResource,
+  LogRequests: () => LogRequests,
+  Middleware: () => Middleware,
+  Request: () => Request,
+  Response: () => Response
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/Middleware.ts
+var Middleware = class {
+  static {
+    __name(this, "Middleware");
+  }
+};
+
+// src/Request.ts
+var import_h3 = require("h3");
+var import_support = require("@h3ravel/support");
+var Request = class {
+  static {
+    __name(this, "Request");
+  }
+  event;
+  constructor(event) {
+    this.event = event;
+  }
+  /**
+   * Get all input data (query + body).
+   */
+  async all() {
+    let data = {
+      ...(0, import_h3.getRouterParams)(this.event),
+      ...(0, import_h3.getQuery)(this.event)
+    };
+    if (this.event.req.method === "POST") {
+      data = Object.assign({}, data, Object.fromEntries((await this.event.req.formData()).entries()));
+    } else if (this.event.req.method === "PUT") {
+      data = Object.fromEntries(Object.entries(await (0, import_h3.readBody)(this.event)));
+    }
+    return data;
+  }
+  /**
+   * Get a single input field from query or body.
+   */
+  async input(key, defaultValue) {
+    const data = await this.all();
+    return data[key] ?? defaultValue;
+  }
+  /**
+   * Get route parameters.
+   */
+  params() {
+    return (0, import_h3.getRouterParams)(this.event);
+  }
+  /**
+   * Get query parameters.
+   */
+  query() {
+    return (0, import_h3.getQuery)(this.event);
+  }
+  getEvent(key) {
+    return (0, import_support.safeDot)(this.event, key);
+  }
+};
+
+// src/Response.ts
+var import_support2 = require("@h3ravel/support");
+var import_h32 = require("h3");
+var Response = class {
+  static {
+    __name(this, "Response");
+  }
+  event;
+  statusCode = 200;
+  headers = {};
+  constructor(event) {
+    this.event = event;
+  }
+  /**
+   * Set HTTP status code.
+   */
+  setStatusCode(code) {
+    this.statusCode = code;
+    this.event.res.status = code;
+    return this;
+  }
+  /**
+   * Set a header.
+   */
+  setHeader(name, value) {
+    this.headers[name] = value;
+    return this;
+  }
+  html(content) {
+    this.applyHeaders();
+    return (0, import_h32.html)(this.event, content);
+  }
+  /**
+   * Send a JSON response.
+   */
+  json(data) {
+    this.setHeader("content-type", "application/json; charset=utf-8");
+    this.applyHeaders();
+    return data;
+  }
+  /**
+   * Send plain text.
+   */
+  text(data) {
+    this.setHeader("content-type", "text/plain; charset=utf-8");
+    this.applyHeaders();
+    return data;
+  }
+  /**
+   * Redirect to another URL.
+   */
+  redirect(url, status = 302) {
+    this.setStatusCode(status);
+    return (0, import_h32.redirect)(this.event, url, this.statusCode);
+  }
+  /**
+   * Apply headers before sending response.
+   */
+  applyHeaders() {
+    Object.entries(this.headers).forEach(([key, value]) => {
+      this.event.res.headers.set(key, value);
+    });
+  }
+  getEvent(key) {
+    return (0, import_support2.safeDot)(this.event, key);
+  }
+};
+
+// src/Middleware/LogRequests.ts
+var LogRequests = class extends Middleware {
+  static {
+    __name(this, "LogRequests");
+  }
+  async handle({ request }, next) {
+    const url = request.getEvent("url");
+    console.log(`[${request.getEvent("method")}] ${url.pathname + url.search}`);
+    return next();
+  }
+};
+
+// src/Providers/HttpServiceProvider.ts
+var import_h33 = require("h3");
+var import_core = require("@h3ravel/core");
+var HttpServiceProvider = class extends import_core.ServiceProvider {
+  static {
+    __name(this, "HttpServiceProvider");
+  }
+  register() {
+    this.app.singleton("http.app", () => {
+      return new import_h33.H3();
+    });
+    this.app.singleton("http.serve", () => import_h33.serve);
+  }
+};
+
+// src/Resources/JsonResource.ts
+var JsonResource = class {
+  static {
+    __name(this, "JsonResource");
+  }
+  event;
+  /**
+   * The request instance
+   */
+  request;
+  /**
+   * The response instance
+   */
+  response;
+  /**
+   * The data to send to the client
+   */
+  resource;
+  /**
+   * The final response data object
+   */
+  body = {
+    data: {}
+  };
+  /**
+   * Flag to track if response should be sent automatically
+   */
+  shouldSend = false;
+  /**
+   * Flag to track if response has been sent
+   */
+  responseSent = false;
+  /**
+   * @param req The request instance
+   * @param res The response instance
+   * @param rsc The data to send to the client
+   */
+  constructor(event, rsc) {
+    this.event = event;
+    this.request = event.req;
+    this.response = event.res;
+    this.resource = rsc;
+    for (const key of Object.keys(rsc)) {
+      if (!(key in this)) {
+        Object.defineProperty(this, key, {
+          enumerable: true,
+          configurable: true,
+          get: /* @__PURE__ */ __name(() => this.resource[key], "get"),
+          set: /* @__PURE__ */ __name((value) => {
+            this.resource[key] = value;
+          }, "set")
+        });
+      }
+    }
+  }
+  /**
+   * Return the data in the expected format
+   * 
+   * @returns 
+   */
+  data() {
+    return this.resource;
+  }
+  /**
+   * Build the response object
+   * @returns this
+   */
+  json() {
+    this.shouldSend = true;
+    this.response.status = 200;
+    const resource = this.data();
+    let data = Array.isArray(resource) ? [
+      ...resource
+    ] : {
+      ...resource
+    };
+    if (typeof data.data !== "undefined") {
+      data = data.data;
+    }
+    if (!Array.isArray(resource)) {
+      delete data.pagination;
+    }
+    this.body = {
+      data
+    };
+    if (!Array.isArray(resource) && resource.pagination) {
+      const meta = this.body.meta ?? {};
+      meta.pagination = resource.pagination;
+      this.body.meta = meta;
+    }
+    if (this.resource.pagination && !this.body.meta?.pagination) {
+      const meta = this.body.meta ?? {};
+      meta.pagination = this.resource.pagination;
+      this.body.meta = meta;
+    }
+    return this;
+  }
+  /**
+   * Add context data to the response object
+   * @param data Context data
+   * @returns this
+   */
+  additional(data) {
+    this.shouldSend = true;
+    delete data.data;
+    delete data.pagination;
+    this.body = {
+      ...this.body,
+      ...data
+    };
+    return this;
+  }
+  /**
+   * Send the output to the client
+   * @returns this
+   */
+  send() {
+    this.shouldSend = false;
+    if (!this.responseSent) {
+      this.#send();
+    }
+    return this;
+  }
+  /**
+   * Set the status code for this response
+   * @param code Status code
+   * @returns this
+   */
+  status(code) {
+    this.response.status = code;
+    return this;
+  }
+  /**
+   * Private method to send the response
+   */
+  #send() {
+    if (!this.responseSent) {
+      this.event.context.this.response.json(this.body);
+      this.responseSent = true;
+    }
+  }
+  /**
+   * Check if send should be triggered automatically
+   */
+  checkSend() {
+    if (this.shouldSend && !this.responseSent) {
+      this.#send();
+    }
+  }
+};
+
+// src/Resources/ApiResource.ts
+function ApiResource(instance) {
+  return new Proxy(instance, {
+    get(target, prop, receiver) {
+      const value = Reflect.get(target, prop, receiver);
+      if (typeof value === "function") {
+        if (prop === "json" || prop === "additional") {
+          return (...args) => {
+            const result = value.apply(target, args);
+            setImmediate(() => target["checkSend"]());
+            return result;
+          };
+        } else if (prop === "send") {
+          return (...args) => {
+            target["shouldSend"] = false;
+            return value.apply(target, args);
+          };
+        }
+      }
+      return value;
+    }
+  });
+}
+__name(ApiResource, "ApiResource");
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  ApiResource,
+  HttpServiceProvider,
+  JsonResource,
+  LogRequests,
+  Middleware,
+  Request,
+  Response
+});
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts","../src/Middleware.ts","../src/Request.ts","../src/Response.ts","../src/Middleware/LogRequests.ts","../src/Providers/HttpServiceProvider.ts","../src/Resources/JsonResource.ts","../src/Resources/ApiResource.ts"],"sourcesContent":["/**\n * @file Automatically generated by barrelsby.\n */\n\nexport * from './Middleware';\nexport * from './Request';\nexport * from './Response';\nexport * from './Contracts/ControllerContracts';\nexport * from './Contracts/HttpContract';\nexport * from './Middleware/LogRequests';\nexport * from './Providers/HttpServiceProvider';\nexport * from './Resources/ApiResource';\nexport * from './Resources/JsonResource';\n","import { HttpContext } from './Contracts/HttpContract';\n\nexport abstract class Middleware {\n    abstract handle (context: HttpContext, next: () => Promise<unknown>): Promise<unknown>\n}\n","import { getQuery, getRouterParams, readBody, type H3Event } from 'h3'\nimport { DotNestedKeys, DotNestedValue, safeDot } from '@h3ravel/support'\n\nexport class Request {\n    private readonly event: H3Event\n\n    constructor(event: H3Event) {\n        this.event = event\n    }\n\n    /**\n     * Get all input data (query + body).\n     */\n    async all<T = Record<string, unknown>> (): Promise<T> {\n        let data = {\n            ...getRouterParams(this.event),\n            ...getQuery(this.event),\n        } as T\n\n        if (this.event.req.method === 'POST') {\n            data = Object.assign({}, data, Object.fromEntries((await this.event.req.formData()).entries()))\n        } else if (this.event.req.method === 'PUT') {\n            data = <never>Object.fromEntries(Object.entries(<never>await readBody(this.event)))\n        }\n\n        return data\n    }\n\n    /**\n     * Get a single input field from query or body.\n     */\n    async input<T = unknown> (key: string, defaultValue?: T): Promise<T> {\n        const data = await this.all<Record<string, T>>()\n        return (data[key] ?? defaultValue) as T\n    }\n\n    /**\n     * Get route parameters.\n     */\n    params<T = Record<string, string>> (): T {\n        return getRouterParams(this.event) as T\n    }\n\n    /**\n     * Get query parameters.\n     */\n    query<T = Record<string, string>> (): T {\n        return getQuery(this.event) as T\n    }\n\n    /**\n     * Get the base event\n     */\n    getEvent (): H3Event\n    getEvent<K extends DotNestedKeys<H3Event>> (key: K): DotNestedValue<H3Event, K>\n    getEvent<K extends DotNestedKeys<H3Event>> (key?: K): any {\n        return safeDot(this.event, key)\n    }\n}\n","import { DotNestedKeys, DotNestedValue, safeDot } from '@h3ravel/support'\nimport { html, redirect, } from 'h3'\n\nimport type { H3Event } from 'h3'\n\nexport class Response {\n    private readonly event: H3Event\n    private statusCode: number = 200\n    private headers: Record<string, string> = {}\n\n    constructor(event: H3Event) {\n        this.event = event\n    }\n\n    /**\n     * Set HTTP status code.\n     */\n    setStatusCode (code: number): this {\n        this.statusCode = code\n        this.event.res.status = code\n        return this\n    }\n\n    /**\n     * Set a header.\n     */\n    setHeader (name: string, value: string): this {\n        this.headers[name] = value\n        return this\n    }\n\n    html (content: string): string {\n        this.applyHeaders()\n        return html(this.event, content)\n    }\n\n    /**\n     * Send a JSON response.\n     */\n    json<T = unknown> (data: T): T {\n        this.setHeader(\"content-type\", \"application/json; charset=utf-8\")\n        this.applyHeaders()\n        return data\n    }\n\n    /**\n     * Send plain text.\n     */\n    text (data: string): string {\n        this.setHeader(\"content-type\", \"text/plain; charset=utf-8\")\n        this.applyHeaders()\n        return data;\n    }\n\n    /**\n     * Redirect to another URL.\n     */\n    redirect (url: string, status = 302): string {\n        this.setStatusCode(status)\n        return redirect(this.event, url, this.statusCode)\n    }\n\n    /**\n     * Apply headers before sending response.\n     */\n    private applyHeaders (): void {\n        Object.entries(this.headers).forEach(([key, value]) => {\n            this.event.res.headers.set(key, value)\n        })\n    }\n\n    /**\n     * Get the base event\n     */\n    getEvent (): H3Event\n    getEvent<K extends DotNestedKeys<H3Event>> (key: K): DotNestedValue<H3Event, K>\n    getEvent<K extends DotNestedKeys<H3Event>> (key?: K): any {\n        return safeDot(this.event, key)\n    }\n}\n","import { HttpContext, Middleware } from '@h3ravel/http'\n\nexport class LogRequests extends Middleware {\n    async handle ({ request }: HttpContext, next: () => Promise<unknown>): Promise<unknown> {\n        const url = request.getEvent('url')\n        console.log(`[${request.getEvent('method')}] ${url.pathname + url.search}`)\n        return next()\n    }\n}\n","import { H3, serve } from 'h3'\n\nimport { ServiceProvider } from '@h3ravel/core'\n\n/**\n * Sets up HTTP kernel and request lifecycle.\n * \n * Register Request, Response, and Middleware classes.\n * Configure global middleware stack.\n * Boot HTTP kernel.\n * \n * Auto-Registered\n */\nexport class HttpServiceProvider extends ServiceProvider {\n    register () {\n        this.app.singleton('http.app', () => {\n            return new H3()\n        })\n\n        this.app.singleton('http.serve', () => serve)\n    }\n}\n","import { EventHandlerRequest, H3Event } from \"h3\";\n\nexport interface Resource {\n    [key: string]: any;\n    pagination?: {\n        from?: number | undefined;\n        to?: number | undefined;\n        perPage?: number | undefined;\n        total?: number | undefined;\n    } | undefined;\n}\n\ntype BodyResource = Resource & {\n    data: Omit<Resource, 'pagination'>,\n    meta?: {\n        pagination?: Resource['pagination']\n    } | undefined;\n}\n\n/**\n * Class to render API resource\n */\nexport class JsonResource<R extends Resource = any> {\n    /**\n     * The request instance\n     */\n    request: H3Event<EventHandlerRequest>['req'];\n    /**\n     * The response instance\n     */\n    response: H3Event['res'];\n    /**\n     * The data to send to the client\n     */\n    resource: R;\n    /**\n     * The final response data object\n     */\n    body: BodyResource = {\n        data: {},\n    };\n    /**\n     * Flag to track if response should be sent automatically\n     */\n    private shouldSend: boolean = false;\n    /**\n     * Flag to track if response has been sent\n     */\n\n    private responseSent: boolean = false;\n\n    /**\n     * Declare that this includes R's properties\n     */\n    [key: string]: any;\n\n    /**\n     * @param req The request instance\n     * @param res The response instance\n     * @param rsc The data to send to the client\n     */\n    constructor(private event: H3Event, rsc: R) {\n        this.request = event.req;\n        this.response = event.res;\n        this.resource = rsc;\n\n        // Copy all properties from rsc to this, avoiding conflicts\n        for (const key of Object.keys(rsc)) {\n            if (!(key in this)) {\n                Object.defineProperty(this, key, {\n                    enumerable: true,\n                    configurable: true,\n                    get: () => this.resource[key],\n                    set: (value) => {\n                        (<any>this.resource)[key] = value;\n                    },\n                });\n            }\n        }\n    }\n\n    /**\n     * Return the data in the expected format\n     * \n     * @returns \n     */\n    data (): Resource {\n        return this.resource\n    }\n\n    /**\n     * Build the response object\n     * @returns this\n     */\n    json () {\n        // Indicate response should be sent automatically\n        this.shouldSend = true;\n\n        // Set default status code\n        this.response.status = 200;\n\n        // Prepare body\n        const resource = this.data()\n        let data: Resource = Array.isArray(resource) ? [...resource] : { ...resource };\n\n        if (typeof data.data !== 'undefined') {\n            data = data.data\n        }\n\n        if (!Array.isArray(resource)) {\n            delete data.pagination;\n        }\n\n        this.body = {\n            data,\n        };\n\n        // Set the pagination from the data() resource, if available\n        if (!Array.isArray(resource) && resource.pagination) {\n            const meta: BodyResource['meta'] = this.body.meta ?? {}\n            meta.pagination = resource.pagination;\n            this.body.meta = meta;\n        }\n\n        // If pagination is not available on the resource, then check and set it\n        // if it's available on the base resource.\n        if (this.resource.pagination && !this.body.meta?.pagination) {\n            const meta: BodyResource['meta'] = this.body.meta ?? {}\n            meta.pagination = this.resource.pagination;\n            this.body.meta = meta;\n        }\n\n        return this;\n    }\n\n    /**\n     * Add context data to the response object\n     * @param data Context data\n     * @returns this\n     */\n    additional<X extends { [key: string]: any }> (data: X) {\n\n        // Allow automatic send after additional\n        this.shouldSend = true;\n\n        // Merge data with body\n        delete data.data;\n        delete data.pagination;\n\n        this.body = {\n            ...this.body,\n            ...data,\n        };\n\n        return this;\n    }\n\n    /**\n     * Send the output to the client\n     * @returns this\n     */\n    send () {\n        this.shouldSend = false; // Prevent automatic send\n        if (!this.responseSent) {\n            this.#send();\n        }\n        return this;\n    }\n\n    /**\n     * Set the status code for this response\n     * @param code Status code\n     * @returns this\n     */\n    status (code: number) {\n        this.response.status = code;\n        return this;\n    }\n\n    /**\n     * Private method to send the response\n     */\n    #send () {\n        if (!this.responseSent) {\n            this.event.context.\n                this.response.json(this.body);\n\n            // Mark response as sent\n            this.responseSent = true;\n        }\n    }\n\n    /**\n     * Check if send should be triggered automatically\n     */\n    private checkSend () {\n        if (this.shouldSend && !this.responseSent) {\n            this.#send();\n        }\n    }\n}\n","import { JsonResource, Resource } from \"./JsonResource\";\n\nimport { H3Event } from \"h3\";\n\nexport function ApiResource (\n    instance: JsonResource\n) {\n    return new Proxy(instance, {\n        get (target, prop, receiver) {\n            const value = Reflect.get(target, prop, receiver);\n            if (typeof value === 'function') {\n                // Intercept json, additional, and send methods\n                if (prop === 'json' || prop === 'additional') {\n                    return (...args: any[]) => {\n                        const result = value.apply(target, args);\n                        // Schedule checkSend after json or additional\n                        setImmediate(() => target['checkSend']());\n                        return result;\n                    };\n                } else if (prop === 'send') {\n                    return (...args: any[]) => {\n                        // Prevent checkSend from firing\n                        target['shouldSend'] = false;\n\n                        return value.apply(target, args);\n                    };\n                }\n            }\n            return value;\n        },\n    });\n}\n\nexport default function BaseResource<R extends Resource> (\n    evt: H3Event,\n    rsc: R\n) {\n    return ApiResource(new JsonResource<R>(evt, rsc))\n}\n"],"mappings":"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","names":["Middleware","Request","event","all","data","getRouterParams","getQuery","req","method","Object","assign","fromEntries","formData","entries","readBody","input","key","defaultValue","params","query","getEvent","safeDot","import_support","import_h3","Response","event","statusCode","headers","setStatusCode","code","res","status","setHeader","name","value","html","content","applyHeaders","json","data","text","redirect","url","Object","entries","forEach","key","set","getEvent","safeDot","LogRequests","Middleware","handle","request","next","url","getEvent","console","log","pathname","search","import_h3","HttpServiceProvider","ServiceProvider","register","app","singleton","H3","serve","JsonResource","request","response","resource","body","data","shouldSend","responseSent","event","rsc","req","res","key","Object","keys","defineProperty","enumerable","configurable","get","set","value","json","status","Array","isArray","pagination","meta","additional","send","code","context","this","checkSend","ApiResource","instance","Proxy","get","target","prop","receiver","value","Reflect","args","result","apply","setImmediate"]}

package/dist/index.d.cts

@@ -0,0 +1,199 @@
+import { H3Event, EventHandlerRequest } from 'h3';
+import { DotNestedKeys, DotNestedValue } from '@h3ravel/support';
+import { ServiceProvider } from '@h3ravel/core';
+
+declare class Request {
+    private readonly event;
+    constructor(event: H3Event);
+    /**
+     * Get all input data (query + body).
+     */
+    all<T = Record<string, unknown>>(): Promise<T>;
+    /**
+     * Get a single input field from query or body.
+     */
+    input<T = unknown>(key: string, defaultValue?: T): Promise<T>;
+    /**
+     * Get route parameters.
+     */
+    params<T = Record<string, string>>(): T;
+    /**
+     * Get query parameters.
+     */
+    query<T = Record<string, string>>(): T;
+    /**
+     * Get the base event
+     */
+    getEvent(): H3Event;
+    getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
+}
+
+declare class Response {
+    private readonly event;
+    private statusCode;
+    private headers;
+    constructor(event: H3Event);
+    /**
+     * Set HTTP status code.
+     */
+    setStatusCode(code: number): this;
+    /**
+     * Set a header.
+     */
+    setHeader(name: string, value: string): this;
+    html(content: string): string;
+    /**
+     * Send a JSON response.
+     */
+    json<T = unknown>(data: T): T;
+    /**
+     * Send plain text.
+     */
+    text(data: string): string;
+    /**
+     * Redirect to another URL.
+     */
+    redirect(url: string, status?: number): string;
+    /**
+     * Apply headers before sending response.
+     */
+    private applyHeaders;
+    /**
+     * Get the base event
+     */
+    getEvent(): H3Event;
+    getEvent<K extends DotNestedKeys<H3Event>>(key: K): DotNestedValue<H3Event, K>;
+}
+
+interface HttpContext {
+    request: Request;
+    response: Response;
+}
+
+declare abstract class Middleware {
+    abstract handle(context: HttpContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+
+/**
+ * Defines the contract for all controllers.
+ * Any controller implementing this must define these methods.
+ */
+interface IController {
+    show(ctx: HttpContext): any;
+    index(ctx: HttpContext): any;
+    store(ctx: HttpContext): any;
+    update(ctx: HttpContext): any;
+    destroy(ctx: HttpContext): any;
+}
+
+declare class LogRequests extends Middleware {
+    handle({ request }: HttpContext, next: () => Promise<unknown>): Promise<unknown>;
+}
+
+/**
+ * Sets up HTTP kernel and request lifecycle.
+ *
+ * Register Request, Response, and Middleware classes.
+ * Configure global middleware stack.
+ * Boot HTTP kernel.
+ *
+ * Auto-Registered
+ */
+declare class HttpServiceProvider extends ServiceProvider {
+    register(): void;
+}
+
+interface Resource {
+    [key: string]: any;
+    pagination?: {
+        from?: number | undefined;
+        to?: number | undefined;
+        perPage?: number | undefined;
+        total?: number | undefined;
+    } | undefined;
+}
+type BodyResource = Resource & {
+    data: Omit<Resource, 'pagination'>;
+    meta?: {
+        pagination?: Resource['pagination'];
+    } | undefined;
+};
+/**
+ * Class to render API resource
+ */
+declare class JsonResource<R extends Resource = any> {
+    #private;
+    private event;
+    /**
+     * The request instance
+     */
+    request: H3Event<EventHandlerRequest>['req'];
+    /**
+     * The response instance
+     */
+    response: H3Event['res'];
+    /**
+     * The data to send to the client
+     */
+    resource: R;
+    /**
+     * The final response data object
+     */
+    body: BodyResource;
+    /**
+     * Flag to track if response should be sent automatically
+     */
+    private shouldSend;
+    /**
+     * Flag to track if response has been sent
+     */
+    private responseSent;
+    /**
+     * Declare that this includes R's properties
+     */
+    [key: string]: any;
+    /**
+     * @param req The request instance
+     * @param res The response instance
+     * @param rsc The data to send to the client
+     */
+    constructor(event: H3Event, rsc: R);
+    /**
+     * Return the data in the expected format
+     *
+     * @returns
+     */
+    data(): Resource;
+    /**
+     * Build the response object
+     * @returns this
+     */
+    json(): this;
+    /**
+     * Add context data to the response object
+     * @param data Context data
+     * @returns this
+     */
+    additional<X extends {
+        [key: string]: any;
+    }>(data: X): this;
+    /**
+     * Send the output to the client
+     * @returns this
+     */
+    send(): this;
+    /**
+     * Set the status code for this response
+     * @param code Status code
+     * @returns this
+     */
+    status(code: number): this;
+    /**
+     * Check if send should be triggered automatically
+     */
+    private checkSend;
+}
+
+declare function ApiResource(instance: JsonResource): JsonResource<any>;
+
+export { ApiResource, type HttpContext, HttpServiceProvider, type IController, JsonResource, LogRequests, Middleware, Request, type Resource, Response };