npm - @seip/blue-bird - Versions diffs - 0.3.3 → 0.3.5 - Mend

@seip/blue-bird 0.3.3 → 0.3.5

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.

Files changed (43) hide show

package/.env_example +23 -13
package/LICENSE +21 -21
package/README.md +79 -79
package/backend/index.js +12 -12
package/backend/routes/api.js +34 -34
package/backend/routes/frontend.js +1 -8
package/core/app.js +359 -359
package/core/auth.js +69 -69
package/core/cache.js +35 -35
package/core/cli/component.js +42 -42
package/core/cli/init.js +120 -118
package/core/cli/react.js +383 -411
package/core/cli/route.js +42 -42
package/core/cli/scaffolding-auth.js +967 -0
package/core/config.js +41 -41
package/core/debug.js +248 -248
package/core/logger.js +80 -80
package/core/middleware.js +27 -27
package/core/router.js +134 -134
package/core/swagger.js +24 -24
package/core/template.js +288 -288
package/core/upload.js +76 -76
package/core/validate.js +291 -290
package/frontend/index.html +28 -22
package/frontend/resources/js/App.jsx +28 -42
package/frontend/resources/js/Main.jsx +17 -17
package/frontend/resources/js/blue-bird/components/Button.jsx +67 -0
package/frontend/resources/js/blue-bird/components/Card.jsx +17 -0
package/frontend/resources/js/blue-bird/components/DataTable.jsx +126 -0
package/frontend/resources/js/blue-bird/components/Input.jsx +21 -0
package/frontend/resources/js/blue-bird/components/Label.jsx +12 -0
package/frontend/resources/js/blue-bird/components/Modal.jsx +27 -0
package/frontend/resources/js/blue-bird/components/Translate.jsx +12 -0
package/frontend/resources/js/blue-bird/components/Typography.jsx +25 -0
package/frontend/resources/js/blue-bird/contexts/LanguageContext.jsx +29 -0
package/frontend/resources/js/blue-bird/contexts/SnackbarContext.jsx +38 -0
package/frontend/resources/js/blue-bird/contexts/ThemeContext.jsx +49 -0
package/frontend/resources/js/blue-bird/locales/en.json +30 -0
package/frontend/resources/js/blue-bird/locales/es.json +30 -0
package/frontend/resources/js/pages/About.jsx +33 -15
package/frontend/resources/js/pages/Home.jsx +93 -68
package/package.json +56 -55
package/vite.config.js +21 -21

package/core/template.js CHANGED Viewed

@@ -1,288 +1,288 @@
-import path from "node:path";
-import fs from "node:fs";
-import Config from "./config.js";
-import Logger from "./logger.js";
-const __dirname = Config.dirname();
-const props = Config.props();
-const TEMPLATE_PATH = path.join(__dirname, "frontend", "index.html");
-const BASE_TEMPLATE = fs.readFileSync(TEMPLATE_PATH, "utf-8");
-let CACHE_TEMPLATE = {};
-/**
- * Lightweight HTML template renderer optimized for SPA environments.
- */
-class Template {
-    /**
- * Renders the base HTML template for a React application using
- * string placeholder replacement and optional in-memory caching.
- *
- * This method injects:
- * - The root React component name
- * - Serialized component props
- * - SEO meta tags
- * - Custom <head> tags
- * - Stylesheets
- * - Scripts (head and body)
- * - Vite assets
- *
- * It supports basic HTML escaping, optional minification,
- * and template caching per component.
- *
- * @static
- * @method renderReact
- *
- * @param {import('express').Response} res
- * Express response object used to send the generated HTML.
- *
- * @param {string} [component="App"]
- * The root React component name to bootstrap on the client.
- * This value replaces the `__COMPONENT__` placeholder in the template.
- *
- * @param {Object<string, any>} [componentProps={}]
- * Props passed to the root React component.
- * These are serialized and injected into the template
- * via the `__PROPS__` placeholder.
- *
- * @param {Object} [options={}]
- * Rendering configuration options.
- *
- * @param {string} [options.langHtml="en"]
- * Value for the `<html lang="">` attribute.
- * Falls back to metaTags.langMeta if available.
- *
- * @param {string} [options.classBody="body"]
- * CSS class applied to the `<body>` tag.
- *
- * @param {Array<{tag:string, attrs:Object<string,string>}>} [options.head=[]]
- * Additional custom tags injected into `<head>`.
- * Example:
- * `{ tag: "meta", attrs: { name: "description", content: "Example" } }`
- *
- * @param {Array<{href:string}>} [options.linkStyles=[]]
- * Stylesheets injected as `<link rel="stylesheet" />` tags.
- *
- * @param {Array<{src:string}>} [options.scriptsInHead=[]]
- * Script files injected inside `<head>`.
- *
- * @param {Array<{src:string}>} [options.scriptsInBody=[]]
- * Script files injected before `</body>`.
- *
- * @param {boolean} [options.cache=true]
- * Enables in-memory caching of the generated HTML
- * per component name to improve performance.
- *
- * @param {Object} [options.metaTags]
- * SEO metadata configuration.
- *
- * @param {string} [options.metaTags.titleMeta]
- * Content for the `<title>` tag.
- *
- * @param {string} [options.metaTags.descriptionMeta]
- * Content for `<meta name="description">`.
- *
- * @param {string} [options.metaTags.keywordsMeta]
- * Content for `<meta name="keywords">`.
- *
- * @param {string} [options.metaTags.authorMeta]
- * Content for `<meta name="author">`.
- *
- * @param {string} [options.metaTags.langMeta]
- * Alternative language metadata value.
- *
- * @returns {void}
- * Sends a complete HTML response to the client.
- *
- * @throws {Error}
- * If template rendering fails, a 500 response is returned.
- *
- * @example
- * const options = {
- *   cache: true,
- *   classBody: "bg-gray-100",
- *   head: [
- *     { tag: "meta", attrs: { name: "robots", content: "index, follow" } }
- *   ],
- *   linkStyles: [
- *     { href: "/css/style.css" }
- *   ],
- *   scriptsInHead: [
- *     { src: "/js/head.js" }
- *   ],
- *   scriptsInBody: [
- *     { src: "/js/body.js" }
- *   ],
- *   metaTags: {
- *     titleMeta: "Example Title",
- *     descriptionMeta: "Example description",
- *     keywordsMeta: "express, react, framework",
- *     authorMeta: "Blue Bird",
- *     langMeta: "en"
- *   }
- * };
- *
- * Template.renderReact(res, "App", { title: "Hello World" }, options);
- */
-    static renderReact(res, component = "App", componentProps = {}, options = {}) {
-        try {
-            let {
-                langHtml = options.langHtml || props.langMeta || "en",
-                classBody = "body",
-                head = [],
-                linkStyles = [],
-                scriptsInHead = [],
-                scriptsInBody = [],
-                cache = true,
-                metaTags
-            } = options;
-            const metaTagsDefault = {
-                titleMeta: props.titleMeta,
-                descriptionMeta: props.descriptionMeta,
-                keywordsMeta: props.keywordsMeta,
-                authorMeta: props.authorMeta,
-                langMeta: props.langMeta,
-            }
-            metaTags = {
-                ...metaTagsDefault,
-                ...metaTags
-            }
-            res.type("text/html");
-            res.status(200);
-            const cacheKey = `${component}_${metaTags.titleMeta}`;
-            if (cache && CACHE_TEMPLATE[cacheKey]) {
-                return res.send(CACHE_TEMPLATE[cacheKey]);
-            }
-            const title = this.escapeHtml(metaTags.titleMeta || "");
-            const description = this.escapeHtml(metaTags.descriptionMeta || "");
-            const keywords = this.escapeHtml(metaTags.keywordsMeta || "");
-            const author = this.escapeHtml(metaTags.authorMeta || "");
-            const headOptions = head
-                .map(item => `<${item.tag} ${Object.entries(item.attrs).map(([k, v]) => `${k}="${v}"`).join(" ")} />`)
-                .join("");
-            const linkTags = linkStyles
-                .map(item => `<link rel="stylesheet" href="${item.href}" />`)
-                .join("");
-            const scriptsHeadTags = scriptsInHead
-                .map(item => `<script src="${item.src}"></script>`)
-                .join("");
-            const scriptsBodyTags = scriptsInBody
-                .map(item => `<script src="${item.src}"></script>`)
-                .join("");
-            const propsJson = JSON.stringify(componentProps).replace(/'/g, "&#39;");
-            let html = BASE_TEMPLATE
-                .replace(/__LANG__/g, this.escapeHtml(langHtml))
-                .replace(/__TITLE__/g, title)
-                .replace(/__DESCRIPTION__/g, description)
-                .replace(/__KEYWORDS__/g, keywords)
-                .replace(/__AUTHOR__/g, author)
-                .replace(/__HEAD_OPTIONS__/g, headOptions)
-                .replace(/__LINK_STYLES__/g, linkTags)
-                .replace(/__SCRIPTS_HEAD__/g, scriptsHeadTags)
-                .replace(/__CLASS_BODY__/g, classBody)
-                .replace(/__COMPONENT__/g, component)
-                .replace(/__PROPS__/g, propsJson)
-                .replace(/__VITE_ASSETS__/g, this.vite_assets())
-                .replace(/__SCRIPTS_BODY__/g, scriptsBodyTags);
-            html = this.minifyHtml(html);
-            CACHE_TEMPLATE[cacheKey] = html;
-            return res.send(html);
-        } catch (error) {
-            const logger = new Logger();
-            logger.error(`Template render error: ${error.message}`);
-            if (props.debug) {
-                console.log(error)
-                return res.status(500).send(`<pre>${error.stack}</pre>`);
-            }
-            return res.status(500).send("Internal Server Error");
-        }
-    }
-    /**
-     * Generates Vite asset tags depending on environment.
-     * @returns {string}
-     */
-    static vite_assets() {
-        if (props.debug) {
-            return `
-<script type="module">
-import RefreshRuntime from "http://localhost:5173/build/@react-refresh";
-RefreshRuntime.injectIntoGlobalHook(window);
-window.$RefreshReg$ = () => {};
-window.$RefreshSig$ = () => (type) => type;
-window.__vite_plugin_react_preamble_installed__ = true;
-</script>
-<script type="module" src="http://localhost:5173/build/@vite/client"></script>
-<script type="module" src="http://localhost:5173/build/Main.jsx"></script>`;
-        }
-        const buildPath = path.join(__dirname, props.static.path, "build");
-        let manifestPath = path.join(buildPath, "manifest.json");
-        if (!fs.existsSync(manifestPath)) {
-            manifestPath = path.join(buildPath, ".vite", "manifest.json");
-        }
-        if (fs.existsSync(manifestPath)) {
-            const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
-            const entry = manifest["Main.jsx"];
-            if (entry) {
-                const file = entry.file;
-                const css = entry.css || [];
-                let html = "";
-                css.forEach(cssFile => {
-                    html += `<link rel="stylesheet" href="/build/${cssFile}">`;
-                });
-                html += `<script type="module" src="/build/${file}"></script>`;
-                return html;
-            }
-        }
-        return "";
-    }
-    /**
-     * Minifies HTML output.
-     * @param {string} html
-     * @returns {string}
-     */
-    static minifyHtml(html) {
-        return html
-            .replace(/<!--(?!\[if).*?-->/gs, "")
-            .replace(/>\s+</g, "><")
-            .replace(/\s{2,}/g, " ")
-            .trim();
-    }
-    /**
-     * Escapes HTML special characters.
-     * @param {string} str
-     * @returns {string}
-     */
-    static escapeHtml(str = "") {
-        return String(str)
-            .replace(/&/g, "&amp;")
-            .replace(/</g, "&lt;")
-            .replace(/>/g, "&gt;")
-            .replace(/"/g, "&quot;")
-            .replace(/'/g, "&#39;");
-    }
-}
-export default Template;
+import path from "node:path";
+import fs from "node:fs";
+import Config from "./config.js";
+import Logger from "./logger.js";
+const __dirname = Config.dirname();
+const props = Config.props();
+const TEMPLATE_PATH = path.join(__dirname, "frontend", "index.html");
+const BASE_TEMPLATE = fs.readFileSync(TEMPLATE_PATH, "utf-8");
+let CACHE_TEMPLATE = {};
+/**
+ * Lightweight HTML template renderer optimized for SPA environments.
+ */
+class Template {
+    /**
+ * Renders the base HTML template for a React application using
+ * string placeholder replacement and optional in-memory caching.
+ *
+ * This method injects:
+ * - The root React component name
+ * - Serialized component props
+ * - SEO meta tags
+ * - Custom <head> tags
+ * - Stylesheets
+ * - Scripts (head and body)
+ * - Vite assets
+ *
+ * It supports basic HTML escaping, optional minification,
+ * and template caching per component.
+ *
+ * @static
+ * @method renderReact
+ *
+ * @param {import('express').Response} res
+ * Express response object used to send the generated HTML.
+ *
+ * @param {string} [component="App"]
+ * The root React component name to bootstrap on the client.
+ * This value replaces the `__COMPONENT__` placeholder in the template.
+ *
+ * @param {Object<string, any>} [componentProps={}]
+ * Props passed to the root React component.
+ * These are serialized and injected into the template
+ * via the `__PROPS__` placeholder.
+ *
+ * @param {Object} [options={}]
+ * Rendering configuration options.
+ *
+ * @param {string} [options.langHtml="en"]
+ * Value for the `<html lang="">` attribute.
+ * Falls back to metaTags.langMeta if available.
+ *
+ * @param {string} [options.classBody="body"]
+ * CSS class applied to the `<body>` tag.
+ *
+ * @param {Array<{tag:string, attrs:Object<string,string>}>} [options.head=[]]
+ * Additional custom tags injected into `<head>`.
+ * Example:
+ * `{ tag: "meta", attrs: { name: "description", content: "Example" } }`
+ *
+ * @param {Array<{href:string}>} [options.linkStyles=[]]
+ * Stylesheets injected as `<link rel="stylesheet" />` tags.
+ *
+ * @param {Array<{src:string}>} [options.scriptsInHead=[]]
+ * Script files injected inside `<head>`.
+ *
+ * @param {Array<{src:string}>} [options.scriptsInBody=[]]
+ * Script files injected before `</body>`.
+ *
+ * @param {boolean} [options.cache=true]
+ * Enables in-memory caching of the generated HTML
+ * per component name to improve performance.
+ *
+ * @param {Object} [options.metaTags]
+ * SEO metadata configuration.
+ *
+ * @param {string} [options.metaTags.titleMeta]
+ * Content for the `<title>` tag.
+ *
+ * @param {string} [options.metaTags.descriptionMeta]
+ * Content for `<meta name="description">`.
+ *
+ * @param {string} [options.metaTags.keywordsMeta]
+ * Content for `<meta name="keywords">`.
+ *
+ * @param {string} [options.metaTags.authorMeta]
+ * Content for `<meta name="author">`.
+ *
+ * @param {string} [options.metaTags.langMeta]
+ * Alternative language metadata value.
+ *
+ * @returns {void}
+ * Sends a complete HTML response to the client.
+ *
+ * @throws {Error}
+ * If template rendering fails, a 500 response is returned.
+ *
+ * @example
+ * const options = {
+ *   cache: true,
+ *   classBody: "bg-gray-100",
+ *   head: [
+ *     { tag: "meta", attrs: { name: "robots", content: "index, follow" } }
+ *   ],
+ *   linkStyles: [
+ *     { href: "/css/style.css" }
+ *   ],
+ *   scriptsInHead: [
+ *     { src: "/js/head.js" }
+ *   ],
+ *   scriptsInBody: [
+ *     { src: "/js/body.js" }
+ *   ],
+ *   metaTags: {
+ *     titleMeta: "Example Title",
+ *     descriptionMeta: "Example description",
+ *     keywordsMeta: "express, react, framework",
+ *     authorMeta: "Blue Bird",
+ *     langMeta: "en"
+ *   }
+ * };
+ *
+ * Template.renderReact(res, "App", { title: "Hello World" }, options);
+ */
+    static renderReact(res, component = "App", componentProps = {}, options = {}) {
+        try {
+            let {
+                langHtml = options.langHtml || props.langMeta || "en",
+                classBody = "body",
+                head = [],
+                linkStyles = [],
+                scriptsInHead = [],
+                scriptsInBody = [],
+                cache = true,
+                metaTags
+            } = options;
+            const metaTagsDefault = {
+                titleMeta: props.titleMeta,
+                descriptionMeta: props.descriptionMeta,
+                keywordsMeta: props.keywordsMeta,
+                authorMeta: props.authorMeta,
+                langMeta: props.langMeta,
+            }
+            metaTags = {
+                ...metaTagsDefault,
+                ...metaTags
+            }
+            res.type("text/html");
+            res.status(200);
+            const cacheKey = `${component}_${metaTags.titleMeta}`;
+            if (cache && CACHE_TEMPLATE[cacheKey]) {
+                return res.send(CACHE_TEMPLATE[cacheKey]);
+            }
+            const title = this.escapeHtml(metaTags.titleMeta || "");
+            const description = this.escapeHtml(metaTags.descriptionMeta || "");
+            const keywords = this.escapeHtml(metaTags.keywordsMeta || "");
+            const author = this.escapeHtml(metaTags.authorMeta || "");
+            const headOptions = head
+                .map(item => `<${item.tag} ${Object.entries(item.attrs).map(([k, v]) => `${k}="${v}"`).join(" ")} />`)
+                .join("");
+            const linkTags = linkStyles
+                .map(item => `<link rel="stylesheet" href="${item.href}" />`)
+                .join("");
+            const scriptsHeadTags = scriptsInHead
+                .map(item => `<script src="${item.src}"></script>`)
+                .join("");
+            const scriptsBodyTags = scriptsInBody
+                .map(item => `<script src="${item.src}"></script>`)
+                .join("");
+            const propsJson = JSON.stringify(componentProps).replace(/'/g, "&#39;");
+            let html = BASE_TEMPLATE
+                .replace(/__LANG__/g, this.escapeHtml(langHtml))
+                .replace(/__TITLE__/g, title)
+                .replace(/__DESCRIPTION__/g, description)
+                .replace(/__KEYWORDS__/g, keywords)
+                .replace(/__AUTHOR__/g, author)
+                .replace(/__HEAD_OPTIONS__/g, headOptions)
+                .replace(/__LINK_STYLES__/g, linkTags)
+                .replace(/__SCRIPTS_HEAD__/g, scriptsHeadTags)
+                .replace(/__CLASS_BODY__/g, classBody)
+                .replace(/__COMPONENT__/g, component)
+                .replace(/__PROPS__/g, propsJson)
+                .replace(/__VITE_ASSETS__/g, this.vite_assets())
+                .replace(/__SCRIPTS_BODY__/g, scriptsBodyTags);
+            html = this.minifyHtml(html);
+            CACHE_TEMPLATE[cacheKey] = html;
+            return res.send(html);
+        } catch (error) {
+            const logger = new Logger();
+            logger.error(`Template render error: ${error.message}`);
+            if (props.debug) {
+                console.log(error)
+                return res.status(500).send(`<pre>${error.stack}</pre>`);
+            }
+            return res.status(500).send("Internal Server Error");
+        }
+    }
+    /**
+     * Generates Vite asset tags depending on environment.
+     * @returns {string}
+     */
+    static vite_assets() {
+        if (props.debug) {
+            return `
+<script type="module">
+import RefreshRuntime from "http://localhost:5173/build/@react-refresh";
+RefreshRuntime.injectIntoGlobalHook(window);
+window.$RefreshReg$ = () => {};
+window.$RefreshSig$ = () => (type) => type;
+window.__vite_plugin_react_preamble_installed__ = true;
+</script>
+<script type="module" src="http://localhost:5173/build/@vite/client"></script>
+<script type="module" src="http://localhost:5173/build/Main.jsx"></script>`;
+        }
+        const buildPath = path.join(__dirname, props.static.path, "build");
+        let manifestPath = path.join(buildPath, "manifest.json");
+        if (!fs.existsSync(manifestPath)) {
+            manifestPath = path.join(buildPath, ".vite", "manifest.json");
+        }
+        if (fs.existsSync(manifestPath)) {
+            const manifest = JSON.parse(fs.readFileSync(manifestPath, "utf8"));
+            const entry = manifest["Main.jsx"];
+            if (entry) {
+                const file = entry.file;
+                const css = entry.css || [];
+                let html = "";
+                css.forEach(cssFile => {
+                    html += `<link rel="stylesheet" href="/build/${cssFile}">`;
+                });
+                html += `<script type="module" src="/build/${file}"></script>`;
+                return html;
+            }
+        }
+        return "";
+    }
+    /**
+     * Minifies HTML output.
+     * @param {string} html
+     * @returns {string}
+     */
+    static minifyHtml(html) {
+        return html
+            .replace(/<!--(?!\[if).*?-->/gs, "")
+            .replace(/>\s+</g, "><")
+            .replace(/\s{2,}/g, " ")
+            .trim();
+    }
+    /**
+     * Escapes HTML special characters.
+     * @param {string} str
+     * @returns {string}
+     */
+    static escapeHtml(str = "") {
+        return String(str)
+            .replace(/&/g, "&amp;")
+            .replace(/</g, "&lt;")
+            .replace(/>/g, "&gt;")
+            .replace(/"/g, "&quot;")
+            .replace(/'/g, "&#39;");
+    }
+}
+export default Template;