princejs 1.9.2 → 1.9.3

package/dist/scheduler.d.ts

@@ -1,13 +1,90 @@
 export declare const cron: (pattern: string, task: () => void) => void;
-export declare const openapi: (info: {
-    title: string;
-    version: string;
-}) => {
+export interface OpenAPISpec {
     openapi: string;
     info: {
         title: string;
         version: string;
+        [key: string]: unknown;
     };
-    paths: {};
-};
+    paths: Record<string, unknown>;
+    components?: Record<string, unknown>;
+    [key: string]: unknown;
+}
+export interface ScalarOptions {
+    /** Scalar theme. Options: "default" | "alternate" | "moon" | "purple" | "solarized" | "bluePlanet" | "deepSpace" | "saturn" | "kepler" | "mars" | "none" */
+    theme?: string;
+    /** Page title shown in the browser tab. Defaults to the spec's info.title. */
+    pageTitle?: string;
+    /** Layout mode. "modern" (default) or "classic" */
+    layout?: "modern" | "classic";
+    /** Hide the spec download button. */
+    hideDownloadButton?: boolean;
+    /** Custom CSS injected into the page. */
+    customCss?: string;
+}
+export interface OpenAPIBuilder {
+    /** The raw spec object — mutate this to add paths, components, etc. */
+    spec: OpenAPISpec;
+    /** Backward-compatible direct accessors — mirrors spec.openapi / .info / .paths */
+    readonly openapi: string;
+    readonly info: OpenAPISpec["info"];
+    readonly paths: OpenAPISpec["paths"];
+    /**
+     * Returns a plain-function route handler that serves the Scalar UI.
+     * Mount it on any path in your router.
+     *
+     * Works with any framework that uses `(req, res) => void` handlers
+     * (Node http, Express, Fastify inject, etc.).
+     *
+     * @example
+     * // Plain Node http
+     * server.on("request", (req, res) => {
+     *   if (req.url === "/docs")  return api.scalar()(req, res);
+     *   if (req.url === "/openapi.json") return api.json()(req, res);
+     * });
+     *
+     * @example
+     * // Express / Hono-style
+     * app.get("/docs", api.scalar({ theme: "moon" }));
+     * app.get("/openapi.json", api.json());
+     */
+    scalar(options?: ScalarOptions): (req: unknown, res: {
+        writeHead(status: number, headers: Record<string, string>): void;
+        end(body: string): void;
+    }) => void;
+    /**
+     * Returns a route handler that serves the raw OpenAPI spec as JSON.
+     *
+     * @example
+     * app.get("/openapi.json", api.json());
+     */
+    json(): (req: unknown, res: {
+        writeHead(status: number, headers: Record<string, string>): void;
+        end(body: string): void;
+    }) => void;
+}
+/**
+ * Creates an OpenAPI builder with a `.scalar()` and `.json()` route handler,
+ * mirroring the Hono / @scalar/hono-api-reference middleware pattern —
+ * but framework-agnostic.
+ *
+ * @example
+ * import http from "http";
+ * import { openapi } from "./scheduler";
+ *
+ * const api = openapi({ title: "My API", version: "1.0.0" });
+ *
+ * api.spec.paths["/hello"] = {
+ *   get: { summary: "Say hello", responses: { 200: { description: "OK" } } },
+ * };
+ *
+ * http.createServer((req, res) => {
+ *   if (req.url === "/docs")         return api.scalar({ theme: "moon" })(req, res);
+ *   if (req.url === "/openapi.json") return api.json()(req, res);
+ * }).listen(3000);
+ */
+export declare const openapi: (info: {
+    title: string;
+    version: string;
+}) => OpenAPIBuilder;
 //# sourceMappingURL=scheduler.d.ts.map

package/dist/scheduler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,IAAI,SAiCrD,CAAC;AAGF,eAAO,MAAM,OAAO,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE;;;eAAzB,MAAM;iBAAW,MAAM;;;CAE7D,CAAC"}
+{"version":3,"file":"scheduler.d.ts","sourceRoot":"","sources":["../src/scheduler.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,IAAI,GAAI,SAAS,MAAM,EAAE,MAAM,MAAM,IAAI,SAiCrD,CAAC;AAIF,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAA;KAAE,CAAC;IACjE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC/B,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,aAAa;IAC5B,4JAA4J;IAC5J,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,8EAA8E;IAC9E,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,mDAAmD;IACnD,MAAM,CAAC,EAAE,QAAQ,GAAG,SAAS,CAAC;IAC9B,qCAAqC;IACrC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,yCAAyC;IACzC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,cAAc;IAC7B,uEAAuE;IACvE,IAAI,EAAE,WAAW,CAAC;IAElB,mFAAmF;IACnF,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;IAErC;;;;;;;;;;;;;;;;;;OAkBG;IACH,MAAM,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;QACnD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;QACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,KAAK,IAAI,CAAC;IAEX;;;;;OAKG;IACH,IAAI,IAAI,CAAC,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE;QAC1B,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC;QACjE,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;KACzB,KAAK,IAAI,CAAC;CACZ;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,OAAO,GAAI,MAAM;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,KAAG,cAyDlE,CAAC"}

package/dist/scheduler.js

@@ -23,7 +23,60 @@ var cron = (pattern, task) => {
   setInterval(check, 60000);
 };
 var openapi = (info) => {
-  return { openapi: "3.0.0", info, paths: {} };
+  const spec = { openapi: "3.0.0", info, paths: {} };
+  const renderScalarHtml = (options = {}) => {
+    const {
+      pageTitle = spec.info.title,
+      theme = "default",
+      layout = "modern",
+      hideDownloadButton = false,
+      customCss = ""
+    } = options;
+    return `<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>${pageTitle}</title>
+    ${customCss ? `<style>${customCss}</style>` : ""}
+  </head>
+  <body>
+    <script
+      id="api-reference"
+      type="application/json"
+      data-theme="${theme}"
+      data-layout="${layout}"
+      ${hideDownloadButton ? 'data-hide-download-button="true"' : ""}
+    >${JSON.stringify(spec)}</script>
+    <script src="https://cdn.jsdelivr.net/npm/@scalar/api-reference"></script>
+  </body>
+</html>`;
+  };
+  return {
+    spec,
+    get openapi() {
+      return spec.openapi;
+    },
+    get info() {
+      return spec.info;
+    },
+    get paths() {
+      return spec.paths;
+    },
+    scalar(options = {}) {
+      return (_req, res) => {
+        const html = renderScalarHtml(options);
+        res.writeHead(200, { "Content-Type": "text/html; charset=utf-8" });
+        res.end(html);
+      };
+    },
+    json() {
+      return (_req, res) => {
+        res.writeHead(200, { "Content-Type": "application/json; charset=utf-8" });
+        res.end(JSON.stringify(spec, null, 2));
+      };
+    }
+  };
 };
 export {
   openapi,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "princejs",
-  "version": "1.9.2",
+  "version": "1.9.3",
   "description": "An easy and fast backend framework that is among the top three — by a 13yo developer, for developers.",
   "main": "dist/prince.js",
   "types": "dist/prince.d.ts",