@cripty2001/utils 0.0.58 → 0.0.60

package/dist/Appserver/server.d.ts

@@ -16,6 +16,21 @@ export declare class AppserverAuthError extends AppserverError {
 export declare class AppserverHandledError extends AppserverError {
     constructor(code: string, message: string, payload?: AppserverData);
 }
+/**
+ * Lightweight typed RPC runner that exposes POST `/exec/:action` endpoints using msgpack payloads
+ * and a GET `/metrics` endpoint for Prometheus gauges.
+ *
+ * Usage:
+ * const app = new Appserver(8080, parseToken, collectMetrics);
+ * app.register('sum', SumSchema, true, async (input, user) => ({ total: input.a + input.b }));
+ *
+ * Request requirements:
+ * - `Content-Type: application/vnd.msgpack`
+ * - Body is msgpack-encoded object matching the provided schema.
+ * - Optional `Authorization: Bearer <token>` header is decoded via the provided parseUser function.
+ *
+ * Responses are msgpack encoded objects with either handler data or `{ error, code, payload }` for handled errors.
+ */
 export declare class Appserver<U extends AppserverData> {
     private app;
     private parseUser;
@@ -24,5 +39,12 @@ export declare class Appserver<U extends AppserverData> {
     constructor(port: number, parseUser: AppserverUsergetter<U>, getMetrics: () => Record<string, number>);
     private handleMetricsRequest;
     private parseInput;
+    /**
+     * Registers a msgpack RPC endpoint under `/exec/${action}`.
+     * @param action unique action name (duplicates throw)
+     * @param inputSchema typebox schema used for runtime validation
+     * @param auth when true rejects requests without a valid user
+     * @param handler business logic returning serializable data
+     */
     register<ISchema extends TSchema, O extends AppserverData, I extends Static<ISchema> & AppserverData = Static<ISchema> & AppserverData>(action: string, inputSchema: ISchema, auth: boolean, handler: AppserverHandler<I, U, O>): void;
 }

package/dist/Appserver/server.js

@@ -36,6 +36,21 @@ class AppserverHandledError extends AppserverError {
     }
 }
 exports.AppserverHandledError = AppserverHandledError;
+/**
+ * Lightweight typed RPC runner that exposes POST `/exec/:action` endpoints using msgpack payloads
+ * and a GET `/metrics` endpoint for Prometheus gauges.
+ *
+ * Usage:
+ * const app = new Appserver(8080, parseToken, collectMetrics);
+ * app.register('sum', SumSchema, true, async (input, user) => ({ total: input.a + input.b }));
+ *
+ * Request requirements:
+ * - `Content-Type: application/vnd.msgpack`
+ * - Body is msgpack-encoded object matching the provided schema.
+ * - Optional `Authorization: Bearer <token>` header is decoded via the provided parseUser function.
+ *
+ * Responses are msgpack encoded objects with either handler data or `{ error, code, payload }` for handled errors.
+ */
 class Appserver {
     app;
     parseUser;
@@ -96,6 +111,13 @@ class Appserver {
             user: token ? await this.parseUser(token) : null
         };
     }
+    /**
+     * Registers a msgpack RPC endpoint under `/exec/${action}`.
+     * @param action unique action name (duplicates throw)
+     * @param inputSchema typebox schema used for runtime validation
+     * @param auth when true rejects requests without a valid user
+     * @param handler business logic returning serializable data
+     */
     register(action, inputSchema, auth, handler) {
         if (this.registered.has(action))
             throw new Error(`Action ${action} is already registered`);

package/dist/MailTemplate/image.d.ts

@@ -0,0 +1,10 @@
+import { type Static } from "@cripty2001/utils/appserver/server";
+export declare const SCHEMA: import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"image">;
+    mobile: import("@sinclair/typebox").TString;
+    desktop: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    link: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+    alt: import("@sinclair/typebox").TString;
+}>;
+export type T = Static<typeof SCHEMA>;
+export declare function build(config: T): string;

package/dist/MailTemplate/image.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA = void 0;
+exports.build = build;
+const server_1 = require("@cripty2001/utils/appserver/server");
+exports.SCHEMA = server_1.Type.Object({
+    type: server_1.Type.Literal("image"),
+    mobile: server_1.Type.String(),
+    desktop: server_1.Type.Union([server_1.Type.String(), server_1.Type.Null()]),
+    link: server_1.Type.Union([server_1.Type.String(), server_1.Type.Null()]),
+    alt: server_1.Type.String()
+});
+function build(config) {
+    const img = (breakpoint, url) => `
+    <mj-image
+      css-class="${breakpoint ?? ''}"
+      src="${url}"
+      alt="${config.alt}"
+      ${config.link ? `href="${config.link}"` : ''}
+      padding="0"
+    />
+  `;
+    const imgs = config.desktop === null ?
+        img(null, config.mobile) :
+        [
+            img("onlyDesktop", config.desktop),
+            img("onlyMobile", config.mobile)
+        ].join('\n');
+    const toReturn = `
+    <mj-section padding="0">
+      <mj-column width="100%" padding="0">
+        ${imgs}
+      </mj-column>
+    </mj-section>
+  `;
+    return toReturn;
+}

package/dist/MailTemplate/index.d.ts

@@ -0,0 +1,29 @@
+import { type Static } from "@cripty2001/utils/appserver/server";
+export declare const TEMPLATE_SCHEMA: import("@sinclair/typebox").TObject<{
+    style: import("@sinclair/typebox").TObject<{
+        font: import("@sinclair/typebox").TString;
+        backgroundColor: import("@sinclair/typebox").TString;
+        textColor: import("@sinclair/typebox").TString;
+    }>;
+    content: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"image">;
+        mobile: import("@sinclair/typebox").TString;
+        desktop: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        link: import("@sinclair/typebox").TUnion<[import("@sinclair/typebox").TString, import("@sinclair/typebox").TNull]>;
+        alt: import("@sinclair/typebox").TString;
+    }>, import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"text">;
+        size: import("@sinclair/typebox").TNumber;
+        weight: import("@sinclair/typebox").TNumber;
+        color: import("@sinclair/typebox").TString;
+        padding: import("@sinclair/typebox").TObject<{
+            top: import("@sinclair/typebox").TNumber;
+        }>;
+        content: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+    }>, import("@sinclair/typebox").TObject<{
+        type: import("@sinclair/typebox").TLiteral<"raw">;
+        data: import("@sinclair/typebox").TString;
+    }>]>>;
+}>;
+export type Template = Static<typeof TEMPLATE_SCHEMA>;
+export declare function genBuilder<T extends any>(config: Template): HandlebarsTemplateDelegate<T>;

package/dist/MailTemplate/index.js

@@ -0,0 +1,80 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TEMPLATE_SCHEMA = void 0;
+exports.genBuilder = genBuilder;
+const handlebars_1 = __importDefault(require("handlebars"));
+const server_1 = require("@cripty2001/utils/appserver/server");
+const image_js_1 = require("./image.js");
+const raw_js_1 = require("./raw.js");
+const text_js_1 = require("./text.js");
+exports.TEMPLATE_SCHEMA = server_1.Type.Object({
+    style: server_1.Type.Object({
+        font: server_1.Type.String(),
+        backgroundColor: server_1.Type.String(),
+        textColor: server_1.Type.String()
+    }),
+    content: server_1.Type.Array(server_1.Type.Union([
+        image_js_1.SCHEMA,
+        text_js_1.SCHEMA,
+        raw_js_1.SCHEMA
+    ]))
+});
+function genBuilder(config) {
+    const mappedContent = config.content
+        .map(item => {
+        switch (item.type) {
+            case "image":
+                return (0, image_js_1.build)(item);
+            case "raw":
+                return (0, raw_js_1.build)(item);
+            case "text":
+                return (0, text_js_1.build)(item);
+            default:
+                // @ts-expect-error Should never happen
+                throw new Error(`Invalid type ${item.type}`);
+        }
+    })
+        .join('\n');
+    return handlebars_1.default.compile(`
+        <mjml>
+            <mj-head>
+            <mj-style>
+                .onlyMobile { 
+                display: none !important; 
+                } 
+                .onlyDesktop { 
+                display: block !important; 
+                } 
+                @media only screen and (max-width: 500px) { 
+                .onlyMobile { 
+                    display: block !important; 
+                } 
+                .onlyDesktop { 
+                    display: none !important; 
+                } 
+                }
+            </mj-style>
+
+            <mj-attributes>
+                <mj-all
+                font-family="${config.style.font}, Arial, Helvetica, sans-serif"
+                />
+                <mj-text
+                font-size="18px"
+                line-height="1.5"
+                color="${config.style.textColor}"
+                />
+                <mj-body width="700px" />
+                <mj-section width="700px" padding="0" />
+            </mj-attributes>
+            </mj-head>
+
+            <mj-body background-color="${config.style.backgroundColor}">
+            ${mappedContent}
+            </mj-body>
+        </mjml>
+    `);
+}

package/dist/MailTemplate/raw.d.ts

@@ -0,0 +1,7 @@
+import { type Static } from "@cripty2001/utils/appserver/server";
+export declare const SCHEMA: import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"raw">;
+    data: import("@sinclair/typebox").TString;
+}>;
+export type T = Static<typeof SCHEMA>;
+export declare function build(config: T): string;

package/dist/MailTemplate/raw.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA = void 0;
+exports.build = build;
+const server_1 = require("@cripty2001/utils/appserver/server");
+exports.SCHEMA = server_1.Type.Object({
+    type: server_1.Type.Literal("raw"),
+    data: server_1.Type.String()
+});
+function build(config) {
+    return config.data;
+}

package/dist/MailTemplate/text.d.ts

@@ -0,0 +1,13 @@
+import { type Static } from "@cripty2001/utils/appserver/server";
+export declare const SCHEMA: import("@sinclair/typebox").TObject<{
+    type: import("@sinclair/typebox").TLiteral<"text">;
+    size: import("@sinclair/typebox").TNumber;
+    weight: import("@sinclair/typebox").TNumber;
+    color: import("@sinclair/typebox").TString;
+    padding: import("@sinclair/typebox").TObject<{
+        top: import("@sinclair/typebox").TNumber;
+    }>;
+    content: import("@sinclair/typebox").TArray<import("@sinclair/typebox").TString>;
+}>;
+export type T = Static<typeof SCHEMA>;
+export declare function build(config: T): string;

package/dist/MailTemplate/text.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SCHEMA = void 0;
+exports.build = build;
+const server_1 = require("@cripty2001/utils/appserver/server");
+exports.SCHEMA = server_1.Type.Object({
+    type: server_1.Type.Literal("text"),
+    size: server_1.Type.Number(),
+    weight: server_1.Type.Number(),
+    color: server_1.Type.String(),
+    padding: server_1.Type.Object({
+        top: server_1.Type.Number()
+    }),
+    content: server_1.Type.Array(server_1.Type.String())
+});
+function build(config) {
+    return `
+    <mj-section padding="0">
+      <mj-column width="100%" padding-top="${config.padding.top}px">
+        ${config.content.map(item => `
+          <mj-text font-size="${config.size}px" font-weight="${config.weight}" color="${config.color}">
+            ${item}
+          </mj-text>
+        `).join('')}
+      </mj-column>
+    </mj-section>
+  `;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cripty2001/utils",
-  "version": "0.0.58",
+  "version": "0.0.60",
   "description": "Internal Set of utils. If you need them use them, otherwise go to the next package ;)",
   "homepage": "https://github.com/cripty2001/utils#readme",
   "bugs": {
@@ -21,6 +21,10 @@
   "files": [
     "dist"
   ],
+  "dependencies": {
+    "@cripty2001/whispr": "^0.2.0",
+    "lodash": "^4.17.21"
+  },
   "devDependencies": {
     "@types/express": "^5.0.5",
     "@types/node": "^24.9.1",
@@ -28,18 +32,14 @@
     "react": "^19",
     "typescript": "^5.9.3"
   },
-  "dependencies": {
-    "@cripty2001/whispr": "^0.2.0",
-    "@types/lodash": "^4.17.20",
-    "lodash": "^4.17.21"
-  },
   "peerDependencies": {
-    "lucide-react": "^0.552.0",
     "@msgpack/msgpack": "^3.1.2",
     "@sinclair/typebox": "^0.34.41",
     "dotenv": "^17.2.3",
     "express": "^5.1.0",
-    "react": "^19"
+    "lucide-react": "^0.552.0",
+    "react": "^19",
+    "handlebars": "^4.7.8"
   },
   "peerDependenciesMeta": {
     "react": {
@@ -74,6 +74,10 @@
     "./appserver/client": {
       "import": "./dist/Appserver/client.js",
       "types": "./dist/Appserver/client.d.ts"
+    },
+    "./mail-template": {
+      "import": "./dist/MailTemplate/index.js",
+      "types": "./dist/MailTemplate/index.d.ts"
     }
   }
 }