jcc-express-mvc 1.8.7 → 1.8.21

package/lib/Socialite/config.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveSocialiteConfig = resolveSocialiteConfig;
+const Config_1 = require("../Config/Config");
+function normalizeAppUrl(url) {
+    let u = (url || "").trim().replace(/\/$/, "");
+    if (!u)
+        u = "http://localhost:5500";
+    if (!/^https?:\/\//i.test(u))
+        u = `http://${u}`;
+    return u;
+}
+const defaultCallbackPath = {
+    google: "/auth/google/callback",
+    github: "/auth/github/callback",
+    facebook: "/auth/facebook/callback",
+    gitlab: "/auth/gitlab/callback",
+    twitter: "/auth/twitter/callback",
+    slack: "/auth/slack/callback",
+};
+/**
+ * Laravel `config/services.php` shape expressed via env:
+ * `{DRIVER}_CLIENT_ID`, `{DRIVER}_CLIENT_SECRET`, optional `{DRIVER}_REDIRECT_URI`.
+ */
+function resolveSocialiteConfig(driver) {
+    const key = driver.toUpperCase();
+    const clientId = String(Config_1.config.get(`${key}_CLIENT_ID`, "") ?? "");
+    const clientSecret = String(Config_1.config.get(`${key}_CLIENT_SECRET`, "") ?? "");
+    let redirectUri = String(Config_1.config.get(`${key}_REDIRECT_URI`, "") ?? "");
+    if (!redirectUri) {
+        const base = normalizeAppUrl(String(Config_1.config.get("APP_URL", "") ?? ""));
+        const path = defaultCallbackPath[driver] ?? `/auth/${encodeURIComponent(driver)}/callback`;
+        redirectUri = `${base}${path.startsWith("/") ? path : `/${path}`}`;
+    }
+    const out = {
+        clientId,
+        clientSecret,
+        redirectUri,
+    };
+    if (driver === "gitlab") {
+        out.gitlabUrl = String(Config_1.config.get("GITLAB_URL", "https://gitlab.com") ?? "https://gitlab.com").replace(/\/$/, "");
+    }
+    return out;
+}

package/lib/Socialite/constant.d.ts

@@ -0,0 +1,18 @@
+export declare const GOOGLE_AUTH = "https://accounts.google.com/o/oauth2/v2/auth";
+export declare const GOOGLE_TOKEN = "https://oauth2.googleapis.com/token";
+export declare const GOOGLE_USERINFO = "https://openidconnect.googleapis.com/v1/userinfo";
+export declare const GITHUB_AUTHORIZE = "https://github.com/login/oauth/authorize";
+export declare const GITHUB_TOKEN = "https://github.com/login/oauth/access_token";
+export declare const GITHUB_USER = "https://api.github.com/user";
+export declare const GITHUB_EMAILS = "https://api.github.com/user/emails";
+export declare const FACEBOOK_GRAPH_VERSION = "v21.0";
+export declare const FACEBOOK_AUTHORIZE = "https://www.facebook.com/v21.0/dialog/oauth";
+export declare const FACEBOOK_TOKEN = "https://graph.facebook.com/v21.0/oauth/access_token";
+export declare const TWITTER_AUTHORIZE = "https://twitter.com/i/oauth2/authorize";
+export declare const TWITTER_TOKEN = "https://api.twitter.com/2/oauth2/token";
+export declare const TWITTER_USER_ME = "https://api.twitter.com/2/users/me";
+/** Slack Sign in with Slack — OpenID Connect */
+export declare const SLACK_OPENID_AUTHORIZE = "https://slack.com/openid/connect/authorize";
+export declare const SLACK_OPENID_TOKEN = "https://slack.com/api/openid.connect.token";
+export declare const SLACK_OPENID_USERINFO = "https://slack.com/api/openid.connect.userInfo";
+//# sourceMappingURL=constant.d.ts.map

package/lib/Socialite/constant.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constant.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Socialite/constant.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,WAAW,iDAAiD,CAAC;AAC1E,eAAO,MAAM,YAAY,wCAAwC,CAAC;AAClE,eAAO,MAAM,eAAe,qDACwB,CAAC;AAErD,eAAO,MAAM,gBAAgB,6CAA6C,CAAC;AAC3E,eAAO,MAAM,YAAY,gDAAgD,CAAC;AAC1E,eAAO,MAAM,WAAW,gCAAgC,CAAC;AACzD,eAAO,MAAM,aAAa,uCAAuC,CAAC;AAElE,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAC9C,eAAO,MAAM,kBAAkB,gDAAoE,CAAC;AACpG,eAAO,MAAM,cAAc,wDAA4E,CAAC;AAExG,eAAO,MAAM,iBAAiB,2CAA2C,CAAC;AAC1E,eAAO,MAAM,aAAa,2CAA2C,CAAC;AACtE,eAAO,MAAM,eAAe,uCAAuC,CAAC;AAEpE,gDAAgD;AAChD,eAAO,MAAM,sBAAsB,+CACW,CAAC;AAC/C,eAAO,MAAM,kBAAkB,+CAA+C,CAAC;AAC/E,eAAO,MAAM,qBAAqB,kDACe,CAAC"}

package/lib/Socialite/constant.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SLACK_OPENID_USERINFO = exports.SLACK_OPENID_TOKEN = exports.SLACK_OPENID_AUTHORIZE = exports.TWITTER_USER_ME = exports.TWITTER_TOKEN = exports.TWITTER_AUTHORIZE = exports.FACEBOOK_TOKEN = exports.FACEBOOK_AUTHORIZE = exports.FACEBOOK_GRAPH_VERSION = exports.GITHUB_EMAILS = exports.GITHUB_USER = exports.GITHUB_TOKEN = exports.GITHUB_AUTHORIZE = exports.GOOGLE_USERINFO = exports.GOOGLE_TOKEN = exports.GOOGLE_AUTH = void 0;
+exports.GOOGLE_AUTH = "https://accounts.google.com/o/oauth2/v2/auth";
+exports.GOOGLE_TOKEN = "https://oauth2.googleapis.com/token";
+exports.GOOGLE_USERINFO = "https://openidconnect.googleapis.com/v1/userinfo";
+exports.GITHUB_AUTHORIZE = "https://github.com/login/oauth/authorize";
+exports.GITHUB_TOKEN = "https://github.com/login/oauth/access_token";
+exports.GITHUB_USER = "https://api.github.com/user";
+exports.GITHUB_EMAILS = "https://api.github.com/user/emails";
+exports.FACEBOOK_GRAPH_VERSION = "v21.0";
+exports.FACEBOOK_AUTHORIZE = `https://www.facebook.com/${exports.FACEBOOK_GRAPH_VERSION}/dialog/oauth`;
+exports.FACEBOOK_TOKEN = `https://graph.facebook.com/${exports.FACEBOOK_GRAPH_VERSION}/oauth/access_token`;
+exports.TWITTER_AUTHORIZE = "https://twitter.com/i/oauth2/authorize";
+exports.TWITTER_TOKEN = "https://api.twitter.com/2/oauth2/token";
+exports.TWITTER_USER_ME = "https://api.twitter.com/2/users/me";
+/** Slack Sign in with Slack — OpenID Connect */
+exports.SLACK_OPENID_AUTHORIZE = "https://slack.com/openid/connect/authorize";
+exports.SLACK_OPENID_TOKEN = "https://slack.com/api/openid.connect.token";
+exports.SLACK_OPENID_USERINFO = "https://slack.com/api/openid.connect.userInfo";

package/lib/Socialite/index.d.ts

@@ -0,0 +1,13 @@
+export { Socialite } from "./Socialite";
+export { AbstractProvider } from "./AbstractProvider";
+export type { OAuthAuthorizeContext, OAuthProviderConfig } from "./types";
+export { resolveSocialiteConfig } from "./config";
+export { SocialUser } from "./SocialUser";
+export { SocialiteProvider } from "./SocialiteProvider";
+export { GoogleProvider } from "./Drivers/google/GoogleProvider";
+export { GitHubProvider } from "./Drivers/github/GitHubProvider";
+export { FacebookProvider } from "./Drivers/facebook/FacebookProvider";
+export { GitLabProvider } from "./Drivers/gitlab/GitLabProvider";
+export { TwitterProvider } from "./Drivers/twitter/TwitterProvider";
+export { SlackProvider } from "./Drivers/slack/SlackProvider";
+//# sourceMappingURL=index.d.ts.map

package/lib/Socialite/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Socialite/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,YAAY,EAAE,qBAAqB,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC;AAC1E,OAAO,EAAE,sBAAsB,EAAE,MAAM,UAAU,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AACvE,OAAO,EAAE,cAAc,EAAE,MAAM,iCAAiC,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,mCAAmC,CAAC;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC"}

package/lib/Socialite/index.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SlackProvider = exports.TwitterProvider = exports.GitLabProvider = exports.FacebookProvider = exports.GitHubProvider = exports.GoogleProvider = exports.SocialiteProvider = exports.SocialUser = exports.resolveSocialiteConfig = exports.AbstractProvider = exports.Socialite = void 0;
+var Socialite_1 = require("./Socialite");
+Object.defineProperty(exports, "Socialite", { enumerable: true, get: function () { return Socialite_1.Socialite; } });
+var AbstractProvider_1 = require("./AbstractProvider");
+Object.defineProperty(exports, "AbstractProvider", { enumerable: true, get: function () { return AbstractProvider_1.AbstractProvider; } });
+var config_1 = require("./config");
+Object.defineProperty(exports, "resolveSocialiteConfig", { enumerable: true, get: function () { return config_1.resolveSocialiteConfig; } });
+var SocialUser_1 = require("./SocialUser");
+Object.defineProperty(exports, "SocialUser", { enumerable: true, get: function () { return SocialUser_1.SocialUser; } });
+var SocialiteProvider_1 = require("./SocialiteProvider");
+Object.defineProperty(exports, "SocialiteProvider", { enumerable: true, get: function () { return SocialiteProvider_1.SocialiteProvider; } });
+var GoogleProvider_1 = require("./Drivers/google/GoogleProvider");
+Object.defineProperty(exports, "GoogleProvider", { enumerable: true, get: function () { return GoogleProvider_1.GoogleProvider; } });
+var GitHubProvider_1 = require("./Drivers/github/GitHubProvider");
+Object.defineProperty(exports, "GitHubProvider", { enumerable: true, get: function () { return GitHubProvider_1.GitHubProvider; } });
+var FacebookProvider_1 = require("./Drivers/facebook/FacebookProvider");
+Object.defineProperty(exports, "FacebookProvider", { enumerable: true, get: function () { return FacebookProvider_1.FacebookProvider; } });
+var GitLabProvider_1 = require("./Drivers/gitlab/GitLabProvider");
+Object.defineProperty(exports, "GitLabProvider", { enumerable: true, get: function () { return GitLabProvider_1.GitLabProvider; } });
+var TwitterProvider_1 = require("./Drivers/twitter/TwitterProvider");
+Object.defineProperty(exports, "TwitterProvider", { enumerable: true, get: function () { return TwitterProvider_1.TwitterProvider; } });
+var SlackProvider_1 = require("./Drivers/slack/SlackProvider");
+Object.defineProperty(exports, "SlackProvider", { enumerable: true, get: function () { return SlackProvider_1.SlackProvider; } });

package/lib/Socialite/types.d.ts

@@ -0,0 +1,13 @@
+export interface OAuthProviderConfig {
+    clientId: string;
+    clientSecret: string;
+    redirectUri: string;
+    /** Self-hosted GitLab base URL (no trailing slash). Default https://gitlab.com */
+    gitlabUrl?: string;
+}
+/** Optional PKCE context passed to {@link AbstractProvider.buildAuthorizeUrl} (Twitter). */
+export type OAuthAuthorizeContext = {
+    codeChallenge: string;
+    codeChallengeMethod: string;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/Socialite/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Socialite/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,kFAAkF;IAClF,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,4FAA4F;AAC5F,MAAM,MAAM,qBAAqB,GAAG;IAClC,aAAa,EAAE,MAAM,CAAC;IACtB,mBAAmB,EAAE,MAAM,CAAC;CAC7B,CAAC"}

package/lib/Socialite/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/lib/Templating-engine/benchmark.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Simple benchmark for the templating engine.
+ * Run: npx ts-node jcc-express-mvc/lib/Templating-engine/benchmark.ts
+ * Or: node build/jcc-express-mvc/lib/Templating-engine/benchmark.js
+ */
+export {};
+//# sourceMappingURL=benchmark.d.ts.map

package/lib/Templating-engine/benchmark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"benchmark.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Templating-engine/benchmark.ts"],"names":[],"mappings":"AAAA;;;;GAIG"}

package/lib/Templating-engine/benchmark.js

@@ -0,0 +1,44 @@
+"use strict";
+/**
+ * Simple benchmark for the templating engine.
+ * Run: npx ts-node jcc-express-mvc/lib/Templating-engine/benchmark.ts
+ * Or: node build/jcc-express-mvc/lib/Templating-engine/benchmark.js
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_1 = require("./index");
+const ITERATIONS = 5000;
+const template = `
+<div class="user">
+  <h1>{{ user.name }}</h1>
+  <p>{{ user.email }}</p>
+  @if(user.active)
+    <span class="badge">Active</span>
+  @endif
+  @foreach(items as item)
+    <li>{{ item.name }} - {{ item.price }}</li>
+  @endforeach
+</div>
+`;
+const data = {
+    user: { name: "John Doe", email: "john@example.com", active: true },
+    items: [
+        { name: "Item 1", price: "$10" },
+        { name: "Item 2", price: "$20" },
+        { name: "Item 3", price: "$30" },
+    ],
+};
+function runBenchmark() {
+    // Warmup
+    for (let i = 0; i < 100; i++) {
+        (0, index_1.compileString)(template, data);
+    }
+    const start = performance.now();
+    for (let i = 0; i < ITERATIONS; i++) {
+        (0, index_1.compileString)(template, data);
+    }
+    const elapsed = performance.now() - start;
+    console.log(`Rendered ${ITERATIONS} templates in ${elapsed.toFixed(2)}ms`);
+    console.log(`Average: ${(elapsed / ITERATIONS).toFixed(3)}ms per template`);
+    console.log(`Throughput: ${(ITERATIONS / (elapsed / 1000)).toFixed(0)} templates/sec`);
+}
+runBenchmark();

package/lib/Templating-engine/engineHelper.d.ts

@@ -11,11 +11,11 @@ export declare class EngineHelpers extends TemplateRegex {
      */
     protected content(content: string, match: any): ContentType;
     /**
-     * Escapes special characters in a string to HTML entities.
+     * Escapes special characters in a string to HTML entities (Laravel {{ }} behavior).
      * @param {string} str - The original string.
      * @returns {string} - The string with special characters replaced by HTML entities.
      */
-    private htmlspecialchars;
+    protected htmlspecialchars(str: any): string;
     /**
      * Replaces placeholders in layout content with section body content.
      * @param {string} content - The content with section placeholders.
@@ -23,33 +23,62 @@ export declare class EngineHelpers extends TemplateRegex {
      * @returns {string} - The layout content with replaced section content.
      */
     protected layout(content: string, layoutContent: string): string;
+    /** Path segment cache to avoid repeated split in hot loops. */
+    private _pathCache;
+    private _pathCacheSize;
+    private static readonly PATH_CACHE_MAX;
+    /** Clear path cache (call with clearCache in dev). */
+    clearPathCache(): void;
+    /**
+     * Fast path resolution - avoids repeated split in hot paths.
+     */
+    private getPathParts;
     /**
      * Accesses nested properties of an object using dot notation.
-     * @param {object} obj - The object to access properties from.
-     * @param {string} propertyString - Dot-separated string representing the property path.
-     * @returns {*} - The value of the nested property, or an empty string if not found.
+     * Optimized: for-loop, path cache for repeated lookups.
+     */
+    protected accessNestedProperty(obj: any, propertyString: string): any;
+    /** Whitelist of safe JS methods allowed in templates (e.g. join, split, trim). */
+    private static readonly ALLOWED_METHODS;
+    /** String methods that work on primitives - coerce to string first if needed. */
+    private static readonly STRING_METHODS;
+    /** Parse method arguments: quoted strings, numbers, or variable names. */
+    private parseMethodArgs;
+    /** Split by comma, respecting quoted strings. */
+    private splitArgs;
+    /**
+     * Resolve variable expression with optional method calls, top-level function calls, and ternary.
+     * Supports: items.join(', '), statusBadge(job.status), url == '/path' ? 'active' : ''
+     */
+    protected resolveVariableExpression(expr: string, param: Record<string, any>): any;
+    /** Resolve ternary branch: quoted string or variable reference. */
+    protected resolveTernaryBranch(branch: string, param: Record<string, any>): any;
+    /**
+     * Checks if a nested property exists (for @isset).
      */
-    protected accessNestedProperty(obj: any, propertyString: string): string;
+    protected hasNestedProperty(obj: any, propertyString: string): boolean;
     /**
      * Reads file content from the specified path.
      * @param {string} path - The path to the file.
      * @returns {string} - The content of the file.
      */
     protected readFile(path: string): string;
+    /** Check if a view file exists (for @includeIf). */
+    protected viewExists(viewPath: string): boolean;
     /**
      * Removes quotes from a string.
      * @param {string} str - The original string.
      * @returns {string} - The string with quotes removed.
      */
     protected removeQuotes(str: string): string;
-    protected evaluateCondition(condition: string, locals: any): string | boolean;
+    protected evaluateCondition(condition: string, locals: any): any;
     protected getAssets(content: string): string;
     protected getPublicFile(file: string): string;
     protected addScriptTag(src: string): string;
     protected getAssetPath(resolvePath: string, beforeMatch: string, afterMatch: string, cssPath?: string): string;
     protected addCSSLinkTag(link: string): string;
     protected getResource(resources: Array<string>, select?: number): string;
-    protected injectReactRefefresh(): string;
+    protected injectReactRefresh(): string;
     protected escapeJsonForHtml(json: string): string;
 }
 //# sourceMappingURL=engineHelper.d.ts.map

package/lib/Templating-engine/engineHelper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"engineHelper.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Templating-engine/engineHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK9C,qBAAa,aAAc,SAAQ,aAAa;IAE9C,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;;IAK3B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,WAAW;IAM3D;;;;OAIG;IACH,OAAO,CAAC,gBAAgB;IAcxB;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IA2BhE;;;;;OAKG;IACH,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,GAAG,MAAM;IAKxE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYxC;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IAgC1D,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM;IAWnC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAgBpC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM;IAOlC,SAAS,CAAC,YAAY,CACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM;IA8BT,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAIpC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAE,MAAU;IAOlE,SAAS,CAAC,oBAAoB;IAU9B,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAUlD"}
+{"version":3,"file":"engineHelper.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Templating-engine/engineHelper.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAK9C,qBAAa,aAAc,SAAQ,aAAa;IAE9C,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC;;IAK3B;;;;;OAKG;IACH,SAAS,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG,GAAG,WAAW;IAM3D;;;;OAIG;IACH,SAAS,CAAC,gBAAgB,CAAC,GAAG,EAAE,GAAG,GAAG,MAAM;IAc5C;;;;;OAKG;IACH,SAAS,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM,GAAG,MAAM;IA2BhE,+DAA+D;IAC/D,OAAO,CAAC,UAAU,CAA+B;IACjD,OAAO,CAAC,cAAc,CAAK;IAC3B,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAO;IAE7C,sDAAsD;IACtD,cAAc,IAAI,IAAI;IAKtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAapB;;;OAGG;IACH,SAAS,CAAC,oBAAoB,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,GAAG,GAAG;IAUrE,kFAAkF;IAClF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,eAAe,CAIpC;IAEH,iFAAiF;IACjF,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAInC;IAEH,0EAA0E;IAC1E,OAAO,CAAC,eAAe;IAiBvB,iDAAiD;IACjD,OAAO,CAAC,SAAS;IA4BjB;;;OAGG;IACH,SAAS,CAAC,yBAAyB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAgDlF,mEAAmE;IACnE,SAAS,CAAC,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,GAAG;IAQ/E;;OAEG;IACH,SAAS,CAAC,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,GAAG,OAAO;IAYtE;;;;OAIG;IACH,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;IAYxC,oDAAoD;IACpD,SAAS,CAAC,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO;IAM/C;;;;OAIG;IACH,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM;IAI3C,SAAS,CAAC,iBAAiB,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG;IA+B1D,SAAS,CAAC,SAAS,CAAC,OAAO,EAAE,MAAM;IAWnC,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAYpC,SAAS,CAAC,YAAY,CAAC,GAAG,EAAE,MAAM;IAOlC,SAAS,CAAC,YAAY,CACpB,WAAW,EAAE,MAAM,EACnB,WAAW,EAAE,MAAM,EACnB,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,MAAM,GACf,MAAM;IA8BT,SAAS,CAAC,aAAa,CAAC,IAAI,EAAE,MAAM;IAIpC,SAAS,CAAC,WAAW,CAAC,SAAS,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,MAAM,GAAE,MAAU;IAOlE,SAAS,CAAC,kBAAkB;IAU5B,SAAS,CAAC,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM;CAUlD"}

package/lib/Templating-engine/engineHelper.js

@@ -13,6 +13,9 @@ const colors_1 = __importDefault(require("colors"));
 class EngineHelpers extends expressions_1.TemplateRegex {
     constructor() {
         super();
+        /** Path segment cache to avoid repeated split in hot loops. */
+        this._pathCache = new Map();
+        this._pathCacheSize = 0;
         this.viteHost = this.getPublicFile("hot") || "";
     }
     /**
@@ -27,12 +30,15 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         return { afterMatch, beforMatch };
     }
     /**
-     * Escapes special characters in a string to HTML entities.
+     * Escapes special characters in a string to HTML entities (Laravel {{ }} behavior).
      * @param {string} str - The original string.
      * @returns {string} - The string with special characters replaced by HTML entities.
      */
     htmlspecialchars(str) {
-        let map = {
+        if (str == null || str === undefined)
+            return "";
+        const s = String(str);
+        const map = {
             "&": "&",
             "<": "&lt;",
             ">": "&gt;",
@@ -40,9 +46,7 @@ class EngineHelpers extends expressions_1.TemplateRegex {
             "'": "&#x27;",
             "/": "&#x2F;",
         };
-        return str.replace(/[&<>"'/]/g, function (m) {
-            return map[m];
-        });
+        return s.replace(/[&<>"'/]/g, (m) => map[m] ?? m);
     }
     /**
      * Replaces placeholders in layout content with section body content.
@@ -71,15 +75,168 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         }
         return layoutContent;
     }
+    /** Clear path cache (call with clearCache in dev). */
+    clearPathCache() {
+        this._pathCache.clear();
+        this._pathCacheSize = 0;
+    }
+    /**
+     * Fast path resolution - avoids repeated split in hot paths.
+     */
+    getPathParts(propertyPath) {
+        if (propertyPath.length === 0)
+            return [];
+        let parts = this._pathCache.get(propertyPath);
+        if (!parts) {
+            parts = propertyPath.replace(/\s/g, "").split(".").filter(Boolean);
+            if (this._pathCacheSize < EngineHelpers.PATH_CACHE_MAX) {
+                this._pathCache.set(propertyPath, parts);
+                this._pathCacheSize++;
+            }
+        }
+        return parts;
+    }
     /**
      * Accesses nested properties of an object using dot notation.
-     * @param {object} obj - The object to access properties from.
-     * @param {string} propertyString - Dot-separated string representing the property path.
-     * @returns {*} - The value of the nested property, or an empty string if not found.
+     * Optimized: for-loop, path cache for repeated lookups.
      */
     accessNestedProperty(obj, propertyString) {
-        const properties = propertyString.replace(/\s/g, "")?.split(".") ?? [];
-        return properties.reduce((acc, prop) => acc?.[prop], obj) ?? "";
+        const parts = this.getPathParts(propertyString);
+        let val = obj;
+        for (let i = 0; i < parts.length; i++) {
+            if (val == null)
+                return "";
+            val = val[parts[i]];
+        }
+        return val === undefined || val === null ? "" : val;
+    }
+    /** Parse method arguments: quoted strings, numbers, or variable names. */
+    parseMethodArgs(argsStr, param) {
+        const args = [];
+        const parts = this.splitArgs(argsStr);
+        for (const p of parts) {
+            const s = p.trim();
+            if (s.length === 0)
+                continue;
+            if ((s.startsWith("'") && s.endsWith("'")) || (s.startsWith('"') && s.endsWith('"'))) {
+                args.push(s.slice(1, -1).replace(/\\(.)/g, "$1"));
+            }
+            else if (/^-?\d+\.?\d*$/.test(s)) {
+                args.push(parseFloat(s));
+            }
+            else {
+                args.push(this.accessNestedProperty(param, s));
+            }
+        }
+        return args;
+    }
+    /** Split by comma, respecting quoted strings. */
+    splitArgs(argsStr) {
+        const parts = [];
+        let current = "";
+        let i = 0;
+        let inQuote = "";
+        while (i < argsStr.length) {
+            const c = argsStr[i];
+            if (inQuote) {
+                current += c;
+                if (c === inQuote && argsStr[i - 1] !== "\\")
+                    inQuote = "";
+                i++;
+            }
+            else if (c === '"' || c === "'") {
+                inQuote = c;
+                current += c;
+                i++;
+            }
+            else if (c === ",") {
+                parts.push(current);
+                current = "";
+                i++;
+            }
+            else {
+                current += c;
+                i++;
+            }
+        }
+        parts.push(current);
+        return parts;
+    }
+    /**
+     * Resolve variable expression with optional method calls, top-level function calls, and ternary.
+     * Supports: items.join(', '), statusBadge(job.status), url == '/path' ? 'active' : ''
+     */
+    resolveVariableExpression(expr, param) {
+        const e = expr.trim();
+        const ternaryRe = /^(.+?)\s*\?\s*(.+?)\s*:\s*(.+)$/;
+        const ternaryMatch = e.match(ternaryRe);
+        if (ternaryMatch) {
+            const cond = ternaryMatch[1].trim();
+            const trueVal = ternaryMatch[2].trim();
+            const falseVal = ternaryMatch[3].trim();
+            const branch = this.evaluateCondition(cond, param) ? trueVal : falseVal;
+            const resolved = this.resolveTernaryBranch(branch, param);
+            return resolved === undefined || resolved === null ? "" : resolved;
+        }
+        const topLevelCallRe = /^(\w+)\s*\(\s*([^)]*)\s*\)\s*$/;
+        const topMatch = e.match(topLevelCallRe);
+        if (topMatch) {
+            const fnName = topMatch[1];
+            const fn = this.accessNestedProperty(param, fnName);
+            if (typeof fn === "function") {
+                const args = this.parseMethodArgs(topMatch[2], param);
+                const val = fn(...args);
+                return val === undefined || val === null ? "" : val;
+            }
+        }
+        const methodCallRe = /\.\s*(\w+)\s*\(\s*([^)]*)\s*\)/g;
+        const methodMatches = [...e.matchAll(methodCallRe)];
+        if (methodMatches.length === 0) {
+            return this.accessNestedProperty(param, e);
+        }
+        const firstMethodIndex = methodMatches[0].index;
+        const base = e.slice(0, firstMethodIndex).trim();
+        let val = this.accessNestedProperty(param, base);
+        for (const m of methodMatches) {
+            const methodName = m[1];
+            if (val == null && methodName !== "toString")
+                return "";
+            if (!EngineHelpers.ALLOWED_METHODS.has(methodName))
+                return "";
+            const argsStr = m[2];
+            const args = this.parseMethodArgs(argsStr, param);
+            // Coerce to string for string methods when value isn't a string (e.g. job.status from DB)
+            if (EngineHelpers.STRING_METHODS.has(methodName) && typeof val !== "string") {
+                val = val == null ? "" : String(val);
+            }
+            const fn = val[methodName];
+            if (typeof fn !== "function")
+                return "";
+            val = fn.apply(val, args);
+        }
+        return val === undefined || val === null ? "" : val;
+    }
+    /** Resolve ternary branch: quoted string or variable reference. */
+    resolveTernaryBranch(branch, param) {
+        const t = branch.trim();
+        if ((t.startsWith("'") && t.endsWith("'")) || (t.startsWith('"') && t.endsWith('"'))) {
+            return t.slice(1, -1).replace(/\\(.)/g, "$1");
+        }
+        return this.accessNestedProperty(param, t);
+    }
+    /**
+     * Checks if a nested property exists (for @isset).
+     */
+    hasNestedProperty(obj, propertyString) {
+        const parts = this.getPathParts(propertyString);
+        let current = obj;
+        for (let i = 0; i < parts.length; i++) {
+            if (current == null || typeof current !== "object" || !(parts[i] in current)) {
+                return false;
+            }
+            current = current[parts[i]];
+        }
+        return true;
     }
     /**
      * Reads file content from the specified path.
@@ -98,6 +255,12 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         }
         return "";
     }
+    /** Check if a view file exists (for @includeIf). */
+    viewExists(viewPath) {
+        const resolvePath = viewPath.replace(/\./g, "/").replace(/\"/g, "");
+        const fullPath = `${app_root_path_1.default.path}/resources/${resolvePath}.blade.html`;
+        return fs_1.default.existsSync(fullPath);
+    }
     /**
      * Removes quotes from a string.
      * @param {string} str - The original string.
@@ -107,12 +270,13 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         return str.replace(/(\'|\")/g, "");
     }
     evaluateCondition(condition, locals) {
-        const operatorRegex = /\s*(===|!==|==|!=|>|<|>=|<=)\s*/g;
-        if (!operatorRegex.test(condition)) {
-            return this.accessNestedProperty(locals, condition);
+        const operatorRegex = /\s*(===|!==|==|!=|>|<|>=|<=)\s*/;
+        const parts = this.removeQuotes(condition).split(operatorRegex).filter(Boolean);
+        if (parts.length < 3) {
+            return this.accessNestedProperty(locals, condition.trim());
         }
-        const [variable, operator, value] = this.removeQuotes(condition).split(operatorRegex);
-        const actualValue = this.accessNestedProperty(locals, variable);
+        const [variable, operator, value] = parts;
+        const actualValue = this.accessNestedProperty(locals, variable?.trim() ?? "");
         switch (operator) {
             case "==":
                 return actualValue == value;
@@ -121,7 +285,6 @@ class EngineHelpers extends expressions_1.TemplateRegex {
             case "===":
                 return actualValue === value;
             case "!==":
-            case "!=":
                 return actualValue !== value;
             case ">":
                 return actualValue > value;
@@ -146,16 +309,17 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         return assetType === "js" ? `${path}.js` : `${path}.css`;
     }
     getPublicFile(file) {
-        const bundler = `${app_root_path_1.default.path}/public/${file}`;
-        if (fs_1.default.existsSync(bundler) && Config_1.config.get("APP_ENV") != "production") {
-            return fs_1.default.readFileSync(bundler).toString();
+        const publicPath = `${app_root_path_1.default.path}/public/${file}`;
+        const buildPath = `${app_root_path_1.default.path}/build/public/${file}`;
+        if (Config_1.config.get("APP_ENV") != "production") {
+            if (fs_1.default.existsSync(publicPath))
+                return fs_1.default.readFileSync(publicPath).toString();
         }
         else {
-            const buildBundler = `${app_root_path_1.default.path}/build/public/${file}`;
-            if (Config_1.config.get("APP_ENV") == "production" &&
-                fs_1.default.existsSync(buildBundler)) {
-                return fs_1.default.readFileSync(buildBundler).toString();
-            }
+            if (fs_1.default.existsSync(buildPath))
+                return fs_1.default.readFileSync(buildPath).toString();
+            if (fs_1.default.existsSync(publicPath))
+                return fs_1.default.readFileSync(publicPath).toString();
         }
         return "";
     }
@@ -173,7 +337,7 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         const manifestContent = this.getPublicFile("build/manifest.json");
         if (!manifestContent) {
             console.log(colors_1.default.yellow("Run npm run vite in your terminal"));
-            return "";
+            return `${beforeMatch}${afterMatch}`;
         }
         const manifest = JSON.parse(manifestContent);
         const assetData = manifest[resolvePath];
@@ -195,7 +359,7 @@ class EngineHelpers extends expressions_1.TemplateRegex {
         const resource = resources[resources.length > 1 ? select : 0].trim();
         return this.removeQuotes(resource.startsWith("/") ? resource.slice(1) : resource);
     }
-    injectReactRefefresh() {
+    injectReactRefresh() {
         return ` <script type="module">
             import RefreshRuntime from '${this.viteHost}/@react-refresh';
             RefreshRuntime.injectIntoGlobalHook(window);
@@ -216,3 +380,16 @@ class EngineHelpers extends expressions_1.TemplateRegex {
     }
 }
 exports.EngineHelpers = EngineHelpers;
+EngineHelpers.PATH_CACHE_MAX = 128;
+/** Whitelist of safe JS methods allowed in templates (e.g. join, split, trim). */
+EngineHelpers.ALLOWED_METHODS = new Set([
+    "join", "split", "slice", "trim", "trimStart", "trimEnd",
+    "toUpperCase", "toLowerCase", "toString", "replace", "repeat",
+    "includes", "indexOf", "startsWith", "endsWith", "padStart", "padEnd",
+]);
+/** String methods that work on primitives - coerce to string first if needed. */
+EngineHelpers.STRING_METHODS = new Set([
+    "toUpperCase", "toLowerCase", "trim", "trimStart", "trimEnd",
+    "toString", "replace", "repeat", "includes", "indexOf", "startsWith", "endsWith",
+    "padStart", "padEnd", "slice", "split",
+]);

package/lib/Templating-engine/errors.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Template engine errors with line/column context.
+ */
+export declare class TemplateError extends Error {
+    readonly line?: number | undefined;
+    readonly column?: number | undefined;
+    readonly templatePath?: string | undefined;
+    constructor(message: string, line?: number | undefined, column?: number | undefined, templatePath?: string | undefined);
+    toString(): string;
+}
+export declare function getLineColumn(source: string, index: number): {
+    line: number;
+    column: number;
+};
+//# sourceMappingURL=errors.d.ts.map

package/lib/Templating-engine/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../jcc-express-mvc/lib/Templating-engine/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,qBAAa,aAAc,SAAQ,KAAK;aAGpB,IAAI,CAAC,EAAE,MAAM;aACb,MAAM,CAAC,EAAE,MAAM;aACf,YAAY,CAAC,EAAE,MAAM;gBAHrC,OAAO,EAAE,MAAM,EACC,IAAI,CAAC,EAAE,MAAM,YAAA,EACb,MAAM,CAAC,EAAE,MAAM,YAAA,EACf,YAAY,CAAC,EAAE,MAAM,YAAA;IAOvC,QAAQ,IAAI,MAAM;CAQnB;AAED,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAI7F"}