@starklabs/forge 1.3.23 → 1.3.24-beta.1

package/dist/js/email/utils/auto-fields.js

@@ -0,0 +1,232 @@
+/**
+ * Normalize an IP address.
+ *
+ * Node may return IPv4 addresses as IPv4-mapped IPv6 addresses:
+ *
+ *   ::ffff:127.0.0.1
+ *   ::ffff:192.168.1.10
+ *
+ * Converting them makes local/private IP detection much easier.
+ */
+function normalizeIp(ip) {
+    const value = ip.trim();
+    if (value.startsWith("::ffff:")) {
+        return value.slice(7);
+    }
+    return value;
+}
+/**
+ * Whether an IP belongs to the local machine.
+ */
+function isLocalhostIp(ip) {
+    const normalized = normalizeIp(ip).toLowerCase();
+    return (normalized === "127.0.0.1" ||
+        normalized === "::1" ||
+        normalized === "0.0.0.0" ||
+        normalized === "::");
+}
+/**
+ * Whether an IPv4 address belongs to a private/local network.
+ *
+ * Private IPv4 ranges:
+ *
+ *   10.0.0.0/8
+ *   172.16.0.0/12
+ *   192.168.0.0/16
+ */
+function isPrivateIpv4(ip) {
+    const normalized = normalizeIp(ip);
+    const parts = normalized.split(".").map(Number);
+    if (parts.length !== 4 ||
+        parts.some((part) => !Number.isInteger(part) || part < 0 || part > 255)) {
+        return false;
+    }
+    const [a, b] = parts;
+    return (a === 10 ||
+        (a === 172 && b >= 16 && b <= 31) ||
+        (a === 192 && b === 168));
+}
+/**
+ * Whether an IP is a private/local address.
+ */
+function isPrivateIp(ip) {
+    const normalized = normalizeIp(ip).toLowerCase();
+    // IPv4 private ranges.
+    if (isPrivateIpv4(normalized)) {
+        return true;
+    }
+    // IPv6 unique-local addresses: fc00::/7
+    if (/^f[cd][0-9a-f]{2}:/i.test(normalized)) {
+        return true;
+    }
+    // IPv6 link-local: fe80::/10
+    if (/^fe[89ab][0-9a-f]{2}:/i.test(normalized)) {
+        return true;
+    }
+    return false;
+}
+/**
+ * Extract a single User-Agent value from the request headers.
+ */
+function getUserAgent(req) {
+    const value = req.headers["user-agent"];
+    if (typeof value === "string") {
+        return value;
+    }
+    if (Array.isArray(value)) {
+        return value[0];
+    }
+    return undefined;
+}
+/**
+ * Client IP address.
+ *
+ * Priority:
+ *
+ * 1. x-forwarded-for
+ * 2. framework-resolved req.ip
+ * 3. req.socket.remoteAddress
+ * 4. req.connection.remoteAddress
+ *
+ * NOTE:
+ * x-forwarded-for should only be trusted when your application is behind
+ * a trusted proxy/load balancer and proxy trust is configured correctly.
+ */
+export function getClientIp(req) {
+    const forwarded = req.headers["x-forwarded-for"];
+    if (typeof forwarded === "string") {
+        const firstIp = forwarded
+            .split(",")
+            .map((ip) => ip.trim())
+            .find(Boolean);
+        if (firstIp) {
+            return normalizeIp(firstIp);
+        }
+    }
+    if (Array.isArray(forwarded)) {
+        const firstIp = forwarded
+            .map((ip) => ip.trim())
+            .find(Boolean);
+        if (firstIp) {
+            return normalizeIp(firstIp);
+        }
+    }
+    if (req.ip) {
+        return normalizeIp(req.ip);
+    }
+    if (req.socket?.remoteAddress) {
+        return normalizeIp(req.socket.remoteAddress);
+    }
+    if (req.connection?.remoteAddress) {
+        return normalizeIp(req.connection.remoteAddress);
+    }
+    return "Unknown";
+}
+/**
+ * Human-readable device name derived from User-Agent.
+ *
+ * This intentionally uses lightweight detection so Forge does not need
+ * a UA parsing dependency.
+ */
+export function getDeviceName(req) {
+    const userAgent = getUserAgent(req);
+    if (!userAgent) {
+        return "Unknown device";
+    }
+    if (/postmanruntime/i.test(userAgent)) {
+        return "Postman";
+    }
+    if (/ipad/i.test(userAgent)) {
+        return "iPad";
+    }
+    if (/iphone/i.test(userAgent)) {
+        return "iPhone";
+    }
+    if (/android/i.test(userAgent)) {
+        if (/mobile/i.test(userAgent)) {
+            return "Android phone";
+        }
+        return "Android device";
+    }
+    if (/windows phone/i.test(userAgent)) {
+        return "Windows phone";
+    }
+    if (/macintosh|mac os x/i.test(userAgent)) {
+        return "Mac";
+    }
+    if (/windows/i.test(userAgent)) {
+        return "Windows PC";
+    }
+    if (/linux/i.test(userAgent)) {
+        return "Linux device";
+    }
+    return "Unknown device";
+}
+/**
+ * Get a human-readable location for an IP.
+ *
+ * Localhost:
+ *   ::1 / 127.0.0.1 -> "Localhost"
+ *
+ * Private LAN:
+ *   192.168.x.x
+ *   10.x.x.x
+ *   172.16.x.x - 172.31.x.x
+ *
+ * These addresses cannot be geolocated because they are not globally
+ * routable. We therefore return a useful development/network label.
+ *
+ * Public IPs require a GeoIP provider/database.
+ */
+export async function getLocationFromIp(ip) {
+    if (!ip || ip === "Unknown") {
+        return "Unknown location";
+    }
+    const normalized = normalizeIp(ip);
+    if (isLocalhostIp(normalized)) {
+        return "Localhost";
+    }
+    if (isPrivateIp(normalized)) {
+        return "Local network";
+    }
+    // TODO: Add a GeoIP provider here for public IP addresses.
+    //
+    // Example:
+    //
+    // const res = await fetch(`https://ipapi.co/${normalized}/json/`);
+    // const data = await res.json();
+    //
+    // if (data.city && data.country_name) {
+    //   return `${data.city}, ${data.country_name}`;
+    // }
+    return "Unknown location";
+}
+/** Current year for email footer/copyright fields. */
+export function getCurrentYear() {
+    return new Date().getFullYear();
+}
+/**
+ * Current date/time formatted for human-readable email fields.
+ */
+export function getFormattedNow(locale = "en-US", timeZone) {
+    return new Date().toLocaleString(locale, {
+        dateStyle: "long",
+        timeStyle: "short",
+        timeZone,
+    });
+}
+/**
+ * Compute all automatically-derived email fields.
+ */
+export async function getAutoDerivedFields(req) {
+    const ipAddress = getClientIp(req);
+    const deviceName = getDeviceName(req);
+    const location = await getLocationFromIp(ipAddress);
+    return {
+        currentYear: getCurrentYear(),
+        ipAddress,
+        deviceName,
+        location,
+    };
+}
+//# sourceMappingURL=auto-fields.js.map

package/dist/js/email/utils/auto-fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fields.js","sourceRoot":"","sources":["../../../../src/js/email/utils/auto-fields.ts"],"names":[],"mappings":"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"}

package/dist/js/email/utils/auto-fields.type.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Fields the framework can figure out on its own at send time — from the
+ * incoming request or the system clock — so the developer using the
+ * framework never has to pass these in manually.
+ *
+ * Field -> where it's used (X/45 templates):
+ *   currentYear  -> every template (footer copyright year)
+ *   ipAddress    -> login-alert, new-device-login, password-changed
+ *   deviceName   -> login-alert, new-device-login, password-changed
+ *   location     -> login-alert, new-device-login, password-changed, security-alert
+ */
+export type AutoDerivedEmailFields = {
+    currentYear: number;
+    ipAddress: string;
+    deviceName: string;
+    location: string;
+};
+//# sourceMappingURL=auto-fields.type.d.ts.map

package/dist/js/email/utils/auto-fields.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fields.type.d.ts","sourceRoot":"","sources":["../../../../src/js/email/utils/auto-fields.type.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACnC,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC"}

package/dist/js/email/utils/auto-fields.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=auto-fields.type.js.map

package/dist/js/email/utils/auto-fields.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-fields.type.js","sourceRoot":"","sources":["../../../../src/js/email/utils/auto-fields.type.ts"],"names":[],"mappings":""}

package/dist/js/email/utils/emailTemplates.d.ts

@@ -0,0 +1,2 @@
+export declare const emailTemplates: Record<string, any>;
+//# sourceMappingURL=emailTemplates.d.ts.map

package/dist/js/email/utils/emailTemplates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailTemplates.d.ts","sourceRoot":"","sources":["../../../../src/js/email/utils/emailTemplates.ts"],"names":[],"mappings":"AAiDA,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAuDL,CAAC"}

package/dist/js/email/utils/emailTemplates.js

@@ -0,0 +1,49 @@
+import { accountCreated, accountDeleted, accountUpdated, announcement, apiKeyCreated, apiKeyRevoked, contactForm, dailyReport, emailChanged, feedback, invoice, loginAlert, magicLink, maintenance, memberAdded, memberRemoved, mention, monthlyReport, newComment, newDeviceLogin, newMessage, notification, orderCancelled, orderConfirmation, orderDelivered, orderShipped, organizationInvitation, passwordChanged, passwordExpiring, passwordReset, paymentFailed, paymentSuccess, receipt, reminder, securityAlert, subscriptionCancelled, subscriptionCreated, subscriptionRenewed, supportTicket, teamInvitation, trialEnding, twoFactorCode, verifyEmail, weeklyReport, welcome, } from "../templates/index.js";
+export const emailTemplates = {
+    welcome: welcome,
+    "verify-email": verifyEmail,
+    "password-reset": passwordReset,
+    "password-changed": passwordChanged,
+    "login-alert": loginAlert,
+    "two-factor-code": twoFactorCode,
+    "magic-link": magicLink,
+    "account-created": accountCreated,
+    "account-updated": accountUpdated,
+    "account-deleted": accountDeleted,
+    "email-changed": emailChanged,
+    "team-invitation": teamInvitation,
+    "organization-invitation": organizationInvitation,
+    "member-added": memberAdded,
+    "member-removed": memberRemoved,
+    "new-message": newMessage,
+    "new-comment": newComment,
+    mention: mention,
+    notification: notification,
+    reminder: reminder,
+    invoice: invoice,
+    receipt: receipt,
+    "payment-success": paymentSuccess,
+    "payment-failed": paymentFailed,
+    "subscription-created": subscriptionCreated,
+    "subscription-renewed": subscriptionRenewed,
+    "subscription-cancelled": subscriptionCancelled,
+    "trial-ending": trialEnding,
+    "order-confirmation": orderConfirmation,
+    "order-shipped": orderShipped,
+    "order-delivered": orderDelivered,
+    "order-cancelled": orderCancelled,
+    "password-expiring": passwordExpiring,
+    "security-alert": securityAlert,
+    "new-device-login": newDeviceLogin,
+    "api-key-created": apiKeyCreated,
+    "api-key-revoked": apiKeyRevoked,
+    "contact-form": contactForm,
+    "support-ticket": supportTicket,
+    feedback: feedback,
+    "daily-report": dailyReport,
+    "weekly-report": weeklyReport,
+    "monthly-report": monthlyReport,
+    maintenance: maintenance,
+    announcement: announcement,
+};
+//# sourceMappingURL=emailTemplates.js.map

package/dist/js/email/utils/emailTemplates.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emailTemplates.js","sourceRoot":"","sources":["../../../../src/js/email/utils/emailTemplates.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,cAAc,EACd,cAAc,EACd,YAAY,EACZ,aAAa,EACb,aAAa,EACb,WAAW,EACX,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,OAAO,EACP,UAAU,EACV,SAAS,EACT,WAAW,EACX,WAAW,EACX,aAAa,EACb,OAAO,EACP,aAAa,EACb,UAAU,EACV,cAAc,EACd,UAAU,EACV,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,cAAc,EACd,YAAY,EACZ,sBAAsB,EACtB,eAAe,EACf,gBAAgB,EAChB,aAAa,EACb,aAAa,EACb,cAAc,EACd,OAAO,EACP,QAAQ,EACR,aAAa,EACb,qBAAqB,EACrB,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,cAAc,EACd,WAAW,EACX,aAAa,EACb,WAAW,EACX,YAAY,EACZ,OAAO,GACR,MAAM,uBAAuB,CAAC;AAE/B,MAAM,CAAC,MAAM,cAAc,GAAwB;IACjD,OAAO,EAAE,OAAO;IAChB,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAC/B,kBAAkB,EAAE,eAAe;IACnC,aAAa,EAAE,UAAU;IACzB,iBAAiB,EAAE,aAAa;IAChC,YAAY,EAAE,SAAS;IAEvB,iBAAiB,EAAE,cAAc;IACjC,iBAAiB,EAAE,cAAc;IACjC,iBAAiB,EAAE,cAAc;IACjC,eAAe,EAAE,YAAY;IAE7B,iBAAiB,EAAE,cAAc;IACjC,yBAAyB,EAAE,sBAAsB;IACjD,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAE/B,aAAa,EAAE,UAAU;IACzB,aAAa,EAAE,UAAU;IACzB,OAAO,EAAE,OAAO;IAChB,YAAY,EAAE,YAAY;IAC1B,QAAQ,EAAE,QAAQ;IAElB,OAAO,EAAE,OAAO;IAChB,OAAO,EAAE,OAAO;IAChB,iBAAiB,EAAE,cAAc;IACjC,gBAAgB,EAAE,aAAa;IAC/B,sBAAsB,EAAE,mBAAmB;IAC3C,sBAAsB,EAAE,mBAAmB;IAC3C,wBAAwB,EAAE,qBAAqB;IAC/C,cAAc,EAAE,WAAW;IAE3B,oBAAoB,EAAE,iBAAiB;IACvC,eAAe,EAAE,YAAY;IAC7B,iBAAiB,EAAE,cAAc;IACjC,iBAAiB,EAAE,cAAc;IAEjC,mBAAmB,EAAE,gBAAgB;IACrC,gBAAgB,EAAE,aAAa;IAC/B,kBAAkB,EAAE,cAAc;IAClC,iBAAiB,EAAE,aAAa;IAChC,iBAAiB,EAAE,aAAa;IAEhC,cAAc,EAAE,WAAW;IAC3B,gBAAgB,EAAE,aAAa;IAC/B,QAAQ,EAAE,QAAQ;IAElB,cAAc,EAAE,WAAW;IAC3B,eAAe,EAAE,YAAY;IAC7B,gBAAgB,EAAE,aAAa;IAE/B,WAAW,EAAE,WAAW;IACxB,YAAY,EAAE,YAAY;CACc,CAAC"}

package/dist/js/email/utils/handleEmailTemplateConfig.d.ts

@@ -0,0 +1,4 @@
+import type { ActionContext } from "../../types/ActionHandler.js";
+declare const handleEmailTemplateConfig: (config: any, context: ActionContext) => Promise<any>;
+export default handleEmailTemplateConfig;
+//# sourceMappingURL=handleEmailTemplateConfig.d.ts.map

package/dist/js/email/utils/handleEmailTemplateConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleEmailTemplateConfig.d.ts","sourceRoot":"","sources":["../../../../src/js/email/utils/handleEmailTemplateConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAIlE,QAAA,MAAM,yBAAyB,GAC7B,QAAQ,GAAG,EACX,SAAS,aAAa,iBAmDvB,CAAC;AACF,eAAe,yBAAyB,CAAC"}

package/dist/js/email/utils/handleEmailTemplateConfig.js

@@ -0,0 +1,47 @@
+import AppLog from "../../utils/AppLog.js";
+import { getAutoDerivedFields, getCurrentYear } from "./auto-fields.js";
+const handleEmailTemplateConfig = async (config, context) => {
+    for (const [key, value] of Object.entries(config)) {
+        // current-date
+        if (value === "current-date") {
+            config[key] = new Date().toLocaleDateString("en-PK", {
+                dateStyle: "full",
+            });
+        }
+        // current-time
+        if (value === "current-time") {
+            config[key] = new Date().toLocaleTimeString("en-PK", {
+                timeStyle: "medium",
+            });
+        }
+        // function
+        if (typeof value === "function") {
+            try {
+                const result = await value(context);
+                config[key] = result;
+                if (result === undefined || result === null) {
+                    AppLog("x", "emailTemplateConfig", `Invalid configuration for '${key}'. Make sure the function returns correct value in routes -> route -> actions.`);
+                }
+            }
+            catch (error) {
+                console.error(`Function '${key}' failed:`, error);
+                throw error;
+            }
+        }
+    }
+    // autoDerivedFields
+    const autoDerivedFields = await getAutoDerivedFields({
+        headers: context.req.headers,
+        connection: context.req.connection,
+        ip: context.req.ip,
+        ips: context.req.ips,
+        socket: context.req.socket,
+    });
+    // return spread config
+    return {
+        ...config,
+        ...autoDerivedFields,
+    };
+};
+export default handleEmailTemplateConfig;
+//# sourceMappingURL=handleEmailTemplateConfig.js.map

package/dist/js/email/utils/handleEmailTemplateConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handleEmailTemplateConfig.js","sourceRoot":"","sources":["../../../../src/js/email/utils/handleEmailTemplateConfig.ts"],"names":[],"mappings":"AACA,OAAO,MAAM,MAAM,uBAAuB,CAAC;AAC3C,OAAO,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAExE,MAAM,yBAAyB,GAAG,KAAK,EACrC,MAAW,EACX,OAAsB,EACtB,EAAE;IACF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;QAClD,eAAe;QACf,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;gBACnD,SAAS,EAAE,MAAM;aAClB,CAAC,CAAC;QACL,CAAC;QAED,eAAe;QACf,IAAI,KAAK,KAAK,cAAc,EAAE,CAAC;YAC7B,MAAM,CAAC,GAAG,CAAC,GAAG,IAAI,IAAI,EAAE,CAAC,kBAAkB,CAAC,OAAO,EAAE;gBACnD,SAAS,EAAE,QAAQ;aACpB,CAAC,CAAC;QACL,CAAC;QAED,WAAW;QACX,IAAI,OAAO,KAAK,KAAK,UAAU,EAAE,CAAC;YAChC,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,OAAO,CAAC,CAAC;gBACpC,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC;gBAErB,IAAI,MAAM,KAAK,SAAS,IAAI,MAAM,KAAK,IAAI,EAAE,CAAC;oBAC5C,MAAM,CACJ,GAAG,EACH,qBAAqB,EACrB,8BAA8B,GAAG,gFAAgF,CAClH,CAAC;gBACJ,CAAC;YACH,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,OAAO,CAAC,KAAK,CAAC,aAAa,GAAG,WAAW,EAAE,KAAK,CAAC,CAAC;gBAClD,MAAM,KAAK,CAAC;YACd,CAAC;QACH,CAAC;IACH,CAAC;IAED,oBAAoB;IACpB,MAAM,iBAAiB,GAAG,MAAM,oBAAoB,CAAC;QACnD,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,OAAO;QAC5B,UAAU,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU;QAClC,EAAE,EAAE,OAAO,CAAC,GAAG,CAAC,EAAE;QAClB,GAAG,EAAE,OAAO,CAAC,GAAG,CAAC,GAAG;QACpB,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,MAAM;KAC3B,CAAC,CAAC;IAEH,uBAAuB;IACvB,OAAO;QACL,GAAG,MAAM;QACT,GAAG,iBAAiB;KACrB,CAAC;AACJ,CAAC,CAAC;AACF,eAAe,yBAAyB,CAAC"}

package/dist/js/health/health.collection.js

@@ -2,36 +2,36 @@ const collection = (vals) => {
     return vals;
 };
 const healthCollection = collection({
-    routeName: "health",
-    reqType: "health",
-    routesArray: [
+    route: "health",
+    type: "health",
+    routes: [
         {
             handler: "healthGet",
             method: "get",
             path: "/",
-            authRole: "public",
-            validationKey: false,
+            auth: "public",
+            validation: false,
         },
         {
             handler: "healthPost",
             method: "post",
             path: "/",
-            authRole: "public",
-            validationKey: false,
+            auth: "public",
+            validation: false,
         },
         {
             handler: "healthPatch",
             method: "patch",
             path: "/",
-            authRole: "public",
-            validationKey: false,
+            auth: "public",
+            validation: false,
         },
         {
             handler: "healthDelete",
             method: "delete",
             path: "/",
-            authRole: "public",
-            validationKey: false,
+            auth: "public",
+            validation: false,
         },
     ],
 });

package/dist/js/health/health.collection.js.map

@@ -1 +1 @@
-{"version":3,"file":"health.collection.js","sourceRoot":"","sources":["../../../src/js/health/health.collection.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,IAAS,EAAE,EAAE;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,UAAU,CAAC;IAClC,SAAS,EAAE,QAAQ;IACnB,OAAO,EAAE,QAAQ;IACjB,WAAW,EAAE;QACX;YACE,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,KAAK;SACrB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,KAAK;SACrB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,KAAK;SACrB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,GAAG;YACT,QAAQ,EAAE,QAAQ;YAClB,aAAa,EAAE,KAAK;SACrB;KACF;CACF,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}
+{"version":3,"file":"health.collection.js","sourceRoot":"","sources":["../../../src/js/health/health.collection.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,GAAG,CAAC,IAAS,EAAE,EAAE;IAC/B,OAAO,IAAI,CAAC;AACd,CAAC,CAAA;AAED,MAAM,gBAAgB,GAAG,UAAU,CAAC;IAClC,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,QAAQ;IACd,MAAM,EAAE;QACN;YACE,OAAO,EAAE,WAAW;YACpB,MAAM,EAAE,KAAK;YACb,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,KAAK;SAClB;QACD;YACE,OAAO,EAAE,YAAY;YACrB,MAAM,EAAE,MAAM;YACd,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,KAAK;SAClB;QACD;YACE,OAAO,EAAE,aAAa;YACtB,MAAM,EAAE,OAAO;YACf,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,KAAK;SAClB;QACD;YACE,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,QAAQ;YAChB,IAAI,EAAE,GAAG;YACT,IAAI,EAAE,QAAQ;YACd,UAAU,EAAE,KAAK;SAClB;KACF;CACF,CAAC,CAAC;AAEH,eAAe,gBAAgB,CAAC"}

package/dist/js/health/index.d.ts

@@ -1,5 +1,5 @@
 import type { Express } from "express";
 import type { Route } from "../types/Collection.ts";
-declare const health: (app: Express, routeName: string, routes: Route[]) => void;
+declare const health: (app: Express, route: string, routes: Route[]) => void;
 export default health;
 //# sourceMappingURL=index.d.ts.map

package/dist/js/health/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/js/health/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,wBAAwB,CAAC;AAIpE,QAAA,MAAM,MAAM,GACV,KAAK,OAAO,EACZ,WAAW,MAAM,EACjB,QAAQ,KAAK,EAAE,SAUhB,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/js/health/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,KAAK,EAAE,KAAK,EAAkB,MAAM,wBAAwB,CAAC;AAIpE,QAAA,MAAM,MAAM,GACV,KAAK,OAAO,EACZ,OAAO,MAAM,EACb,QAAQ,KAAK,EAAE,SAUhB,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/js/health/index.js

@@ -1,9 +1,9 @@
 import { getEnvs } from "../config/envs.js";
 import handlerMap from "../config/handlerMap.js";
-const health = (app, routeName, routes) => {
+const health = (app, route, routes) => {
     const { apiVersion } = getEnvs();
     for (const routeObj of routes) {
-        app[routeObj.method](`/api/v${apiVersion}/${routeName}${routeObj.path}`, handlerMap[routeObj.handler]);
+        app[routeObj.method](`/api/v${apiVersion}/${route}${routeObj.path}`, handlerMap[routeObj.handler]);
     }
 };
 export default health;

package/dist/js/health/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/js/health/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,UAAU,MAAM,yBAAyB,CAAC;AAEjD,MAAM,MAAM,GAAG,CACb,GAAY,EACZ,SAAiB,EACjB,MAAe,EACf,EAAE;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;IAEjC,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAClB,SAAS,UAAU,IAAI,SAAS,GAAG,QAAQ,CAAC,IAAI,EAAE,EAClD,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/js/health/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC;AAC5C,OAAO,UAAU,MAAM,yBAAyB,CAAC;AAEjD,MAAM,MAAM,GAAG,CACb,GAAY,EACZ,KAAa,EACb,MAAe,EACf,EAAE;IACF,MAAM,EAAE,UAAU,EAAE,GAAG,OAAO,EAAE,CAAC;IAEjC,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;QAC9B,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAClB,SAAS,UAAU,IAAI,KAAK,GAAG,QAAQ,CAAC,IAAI,EAAE,EAC9C,UAAU,CAAC,QAAQ,CAAC,OAAO,CAAC,CAC7B,CAAC;IACJ,CAAC;AACH,CAAC,CAAC;AAEF,eAAe,MAAM,CAAC"}

package/dist/js/lib/OAuthProviders.js

@@ -7,7 +7,7 @@ export const OAUTH_PROVIDERS = [
     "microsoft",
     "discord",
     "linkedin",
-    "x",
+    "x", // formerly Twitter
     "gitlab",
     "spotify",
     "twitch",

package/dist/js/lib/OAuthProviders.js.map

@@ -1 +1 @@
-{"version":3,"file":"OAuthProviders.js","sourceRoot":"","sources":["../../../src/js/lib/OAuthProviders.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,OAAO;IACP,WAAW;IACX,SAAS;IACT,UAAU;IACV,GAAG;IACH,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;CACD,CAAC"}
+{"version":3,"file":"OAuthProviders.js","sourceRoot":"","sources":["../../../src/js/lib/OAuthProviders.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,OAAO;IACP,QAAQ;IACR,QAAQ;IACR,UAAU;IACV,OAAO;IACP,WAAW;IACX,SAAS;IACT,UAAU;IACV,GAAG,EAAE,mBAAmB;IACxB,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,OAAO;IACP,QAAQ;IACR,SAAS;CACD,CAAC"}

package/dist/js/lib/db.js

@@ -34,5 +34,6 @@ const connectDB = async ({ isOffline, mongoDBURI, databaseName, }) => {
         process.exit(1);
     }
 };
+// export
 export default connectDB;
 //# sourceMappingURL=db.js.map

package/dist/js/lib/db.js.map

@@ -1 +1 @@
-{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/js/lib/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,cAAc,GAAG,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,EAAE;IAC3D,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CACJ,GAAG,EACH,IAAI,EACJ,2FAA2F,CAC5F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,CACJ,OAAO,EACP,IAAI,EACJ,4CAA4C,YAAY,GAAG,CAC5D,CAAC;AACJ,CAAC,CAAC;AAQF,MAAM,SAAS,GAAG,KAAK,EAAE,EACvB,SAAS,EACT,UAAU,EACV,YAAY,GACI,EAAE,EAAE;IACpB,IAAI,CAAC;QACH,IAAI,SAAS;YAAE,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC;QAEnD,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAE5D,IAAI,CAAC,YAAY;YAAE,YAAY,GAAG,YAAY,CAAC;QAE/C,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,0BAA0B,CAAC,CAAC;QACtD,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,UAAU,IAAI,YAAY,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QACtC,MAAM,CACJ,OAAO,EACP,IAAI,EACJ,2CAA2C,YAAY,GAAG,CAC3D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,qCAAqC,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAGF,eAAe,SAAS,CAAC"}
+{"version":3,"file":"db.js","sourceRoot":"","sources":["../../../src/js/lib/db.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,UAAU,CAAC;AAChC,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,cAAc,GAAG,KAAK,EAAE,YAAY,GAAG,YAAY,EAAE,EAAE;IAC3D,IAAI,CAAC;QACH,MAAM,QAAQ,CAAC,OAAO,CAAC,6BAA6B,YAAY,EAAE,CAAC,CAAC;QACpE,OAAO,CAAC,kBAAkB,GAAG,SAAS,CAAC;IACzC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,CACJ,GAAG,EACH,IAAI,EACJ,2FAA2F,CAC5F,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,CACJ,OAAO,EACP,IAAI,EACJ,4CAA4C,YAAY,GAAG,CAC5D,CAAC;AACJ,CAAC,CAAC;AAQF,MAAM,SAAS,GAAG,KAAK,EAAE,EACvB,SAAS,EACT,UAAU,EACV,YAAY,GACI,EAAE,EAAE;IACpB,IAAI,CAAC;QACH,IAAI,SAAS;YAAE,OAAO,cAAc,CAAC,YAAY,CAAC,CAAC;QAEnD,IAAI,CAAC,UAAU;YACb,MAAM,IAAI,KAAK,CAAC,wCAAwC,CAAC,CAAC;QAE5D,IAAI,CAAC,YAAY;YAAE,YAAY,GAAG,YAAY,CAAC;QAE/C,UAAU,CAAC,GAAG,EAAE;YACd,MAAM,CAAC,SAAS,EAAE,IAAI,EAAE,0BAA0B,CAAC,CAAC;QACtD,CAAC,EAAE,EAAE,CAAC,CAAC;QAEP,MAAM,QAAQ,CAAC,OAAO,CAAC,GAAG,UAAU,IAAI,YAAY,EAAE,CAAC,CAAC;QACxD,OAAO,CAAC,kBAAkB,GAAG,QAAQ,CAAC;QACtC,MAAM,CACJ,OAAO,EACP,IAAI,EACJ,2CAA2C,YAAY,GAAG,CAC3D,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,GAAG,EAAE,IAAI,EAAE,qCAAqC,CAAC,CAAC;QACzD,MAAM,CAAC,GAAG,EAAE,IAAI,EAAG,KAAe,CAAC,OAAO,CAAC,CAAC;QAC5C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC;AAEF,SAAS;AACT,eAAe,SAAS,CAAC"}

package/dist/js/lib/model.factory.d.ts

@@ -1,10 +1,19 @@
 import type { SchemaDefinitionProperty } from "mongoose";
 type Primitive = string | number | boolean | Date;
+/**
+ * A field can now be:
+ * 1. UnifiedField  → { mongoose: ..., zod: ... }
+ * 2. Classic Mongoose definition (backward compatible)
+ * 3. Primitive value (also backward compatible)
+ */
 type ModelField = {
     mongoose: SchemaDefinitionProperty<unknown>;
     zod?: any;
 } | SchemaDefinitionProperty<unknown> | Primitive;
 type ModelDefinition = Record<string, ModelField>;
-declare const createModel: (name: string, definition: ModelDefinition, routeName?: string) => any;
+/**
+ * Creates (or returns existing) Mongoose model.
+ */
+declare const createModel: (name: string, definition: ModelDefinition, route?: string) => any;
 export default createModel;
 //# sourceMappingURL=model.factory.d.ts.map

package/dist/js/lib/model.factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model.factory.d.ts","sourceRoot":"","sources":["../../../src/js/lib/model.factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAMzD,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAQlD,KAAK,UAAU,GACX;IAAE,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,GAC1D,wBAAwB,CAAC,OAAO,CAAC,GACjC,SAAS,CAAC;AAEd,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AA8DlD,QAAA,MAAM,WAAW,GACf,MAAM,MAAM,EACZ,YAAY,eAAe,EAC3B,YAAY,MAAM,KACjB,GA6BF,CAAC;AAEF,eAAe,WAAW,CAAC"}
+{"version":3,"file":"model.factory.d.ts","sourceRoot":"","sources":["../../../src/js/lib/model.factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,UAAU,CAAC;AAMzD,KAAK,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;AAElD;;;;;GAKG;AACH,KAAK,UAAU,GACX;IAAE,QAAQ,EAAE,wBAAwB,CAAC,OAAO,CAAC,CAAC;IAAC,GAAG,CAAC,EAAE,GAAG,CAAA;CAAE,GAC1D,wBAAwB,CAAC,OAAO,CAAC,GACjC,SAAS,CAAC;AAEd,KAAK,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;AA2DlD;;GAEG;AACH,QAAA,MAAM,WAAW,GACf,MAAM,MAAM,EACZ,YAAY,eAAe,EAC3B,QAAQ,MAAM,KACb,GA6BF,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/js/lib/model.factory.js

@@ -2,19 +2,25 @@ import mongoose from "mongoose";
 import buildSchema from "./schema.builder.js";
 import AppLog from "../utils/AppLog.js";
 import AppError from "../utils/AppError.js";
+/**
+ * Extracts the pure Mongoose definition from any supported field format.
+ */
 const extractMongooseDefinition = (value) => {
+    // Case 1: Unified field → { mongoose, zod }
     if (value &&
         typeof value === "object" &&
         !Array.isArray(value) &&
         "mongoose" in value) {
         return value.mongoose;
     }
+    // Case 2: Already a classic Mongoose schema definition
     if (value &&
         typeof value === "object" &&
         !Array.isArray(value) &&
         "type" in value) {
         return value;
     }
+    // Case 3: Primitive values (string | number | boolean | Date)
     switch (typeof value) {
         case "number":
             return { type: Number, default: value };
@@ -26,27 +32,35 @@ const extractMongooseDefinition = (value) => {
             if (value instanceof Date) {
                 return { type: Date, default: value };
             }
+            // Fallback (arrays, nested objects, etc.)
             return value;
     }
 };
+/**
+ * Converts the whole definition object into a clean Mongoose-compatible definition.
+ */
 const normalizeDefinition = (definition) => {
     return Object.fromEntries(Object.entries(definition).map(([key, value]) => [
         key,
         extractMongooseDefinition(value),
     ]));
 };
-const createModel = (name, definition, routeName) => {
+/**
+ * Creates (or returns existing) Mongoose model.
+ */
+const createModel = (name, definition, route) => {
+    // Return existing model if already registered
     if (mongoose.modelNames().includes(name)) {
         return mongoose.model(name);
     }
     if (!definition) {
         console.log(name);
         throw new AppError({
-            message: `mongooseSchema for ${routeName} is required`,
+            message: `schema for ${route} is required`,
             statusCode: 409,
             hint: name.toLowerCase() === "users" || name.toLowerCase() === "user"
-                ? "If modelName for User model is written in auth collection, make sure mongooseSchema is written there too."
-                : `Make sure mongooseSchema is also written in ${routeName?.endsWith("s") ? routeName.slice(0, -1) : routeName} collection.`,
+                ? "If model for User model is written in auth collection, make sure schema is written there too."
+                : `Make sure schema is also written in ${route?.endsWith("s") ? route.slice(0, -1) : route} collection.`,
             details: {
                 handler: "",
                 method: "",

package/dist/js/lib/model.factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.factory.js","sourceRoot":"","sources":["../../../src/js/lib/model.factory.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"model.factory.js","sourceRoot":"","sources":["../../../src/js/lib/model.factory.ts"],"names":[],"mappings":"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"}

package/dist/js/lib/model.registry.js

@@ -1,3 +1,4 @@
+// GLOBAL MODEL REGISTRY
 import createModel from "./model.factory.js";
 const registerModel = {};
 export default registerModel;

package/dist/js/lib/model.registry.js.map

@@ -1 +1 @@
-{"version":3,"file":"model.registry.js","sourceRoot":"","sources":["../../../src/js/lib/model.registry.ts"],"names":[],"mappings":"AACA,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAE7C,MAAM,aAAa,GAAmD,EAAE,CAAC;AAEzE,eAAe,aAAa,CAAC"}
+{"version":3,"file":"model.registry.js","sourceRoot":"","sources":["../../../src/js/lib/model.registry.ts"],"names":[],"mappings":"AAAA,wBAAwB;AACxB,OAAO,WAAW,MAAM,oBAAoB,CAAC;AAE7C,MAAM,aAAa,GAAmD,EAAE,CAAC;AAEzE,eAAe,aAAa,CAAC"}