@objectstack/runtime 3.2.0 → 3.2.2

package/dist/index.d.cts

@@ -465,6 +465,12 @@ declare class HttpDispatcher {
      * path: sub-path after /auth/
      */
     handleAuth(path: string, method: string, body: any, context: HttpProtocolContext): Promise<HttpDispatcherResult>;
+    /**
+     * Provides mock auth responses for core better-auth endpoints when
+     * AuthPlugin is not loaded (e.g. MSW/browser-only environments).
+     * This ensures registration/sign-in flows do not 404 in mock mode.
+     */
+    private mockAuthFallback;
     /**
      * Handles Metadata requests
      * Standard: /metadata/:type/:name
@@ -480,7 +486,19 @@ declare class HttpDispatcher {
      * Handles Analytics requests
      * path: sub-path after /analytics/
      */
-    handleAnalytics(path: string, method: string, body: any, context: HttpProtocolContext): Promise<HttpDispatcherResult>;
+    handleAnalytics(path: string, method: string, body: any, _context: HttpProtocolContext): Promise<HttpDispatcherResult>;
+    /**
+     * Handles i18n requests
+     * path: sub-path after /i18n/
+     *
+     * Routes:
+     *   GET /locales                    → getLocales
+     *   GET /translations/:locale       → getTranslations (locale from path)
+     *   GET /translations?locale=xx     → getTranslations (locale from query)
+     *   GET /labels/:object/:locale     → getFieldLabels  (both from path)
+     *   GET /labels/:object?locale=xx   → getFieldLabels  (locale from query)
+     */
+    handleI18n(path: string, method: string, query: any, _context: HttpProtocolContext): Promise<HttpDispatcherResult>;
     /**
      * Handles Package Management requests
      *
@@ -530,6 +548,12 @@ declare class HttpDispatcher {
     handleAutomation(path: string, method: string, body: any, context: HttpProtocolContext, query?: any): Promise<HttpDispatcherResult>;
     private getServicesMap;
     private getService;
+    /**
+     * Resolve any service by name, supporting async factories.
+     * Fallback chain: getServiceAsync → getService (sync) → context.getService → services map.
+     * Only returns when a non-null service is found; otherwise falls through to the next step.
+     */
+    private resolveService;
     /**
      * Get the ObjectQL service which provides access to SchemaRegistry.
      * Tries multiple access patterns since kernel structure varies.

package/dist/index.d.ts

@@ -465,6 +465,12 @@ declare class HttpDispatcher {
      * path: sub-path after /auth/
      */
     handleAuth(path: string, method: string, body: any, context: HttpProtocolContext): Promise<HttpDispatcherResult>;
+    /**
+     * Provides mock auth responses for core better-auth endpoints when
+     * AuthPlugin is not loaded (e.g. MSW/browser-only environments).
+     * This ensures registration/sign-in flows do not 404 in mock mode.
+     */
+    private mockAuthFallback;
     /**
      * Handles Metadata requests
      * Standard: /metadata/:type/:name
@@ -480,7 +486,19 @@ declare class HttpDispatcher {
      * Handles Analytics requests
      * path: sub-path after /analytics/
      */
-    handleAnalytics(path: string, method: string, body: any, context: HttpProtocolContext): Promise<HttpDispatcherResult>;
+    handleAnalytics(path: string, method: string, body: any, _context: HttpProtocolContext): Promise<HttpDispatcherResult>;
+    /**
+     * Handles i18n requests
+     * path: sub-path after /i18n/
+     *
+     * Routes:
+     *   GET /locales                    → getLocales
+     *   GET /translations/:locale       → getTranslations (locale from path)
+     *   GET /translations?locale=xx     → getTranslations (locale from query)
+     *   GET /labels/:object/:locale     → getFieldLabels  (both from path)
+     *   GET /labels/:object?locale=xx   → getFieldLabels  (locale from query)
+     */
+    handleI18n(path: string, method: string, query: any, _context: HttpProtocolContext): Promise<HttpDispatcherResult>;
     /**
      * Handles Package Management requests
      *
@@ -530,6 +548,12 @@ declare class HttpDispatcher {
     handleAutomation(path: string, method: string, body: any, context: HttpProtocolContext, query?: any): Promise<HttpDispatcherResult>;
     private getServicesMap;
     private getService;
+    /**
+     * Resolve any service by name, supporting async factories.
+     * Fallback chain: getServiceAsync → getService (sync) → context.getService → services map.
+     * Only returns when a non-null service is found; otherwise falls through to the next step.
+     */
+    private resolveService;
     /**
      * Get the ObjectQL service which provides access to SchemaRegistry.
      * Tries multiple access patterns since kernel structure varies.

package/dist/index.js

@@ -171,6 +171,16 @@ var AppPlugin = class {
 // src/http-dispatcher.ts
 import { getEnv } from "@objectstack/core";
 import { CoreServiceName } from "@objectstack/spec/system";
+function randomUUID() {
+  if (globalThis.crypto && typeof globalThis.crypto.randomUUID === "function") {
+    return globalThis.crypto.randomUUID();
+  }
+  return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+    const r = Math.random() * 16 | 0;
+    const v = c === "x" ? r : r & 3 | 8;
+    return v.toString(16);
+  });
+}
 var HttpDispatcher = class {
   // Casting to any to access dynamic props like broker, services, graphql
   constructor(kernel) {
@@ -313,9 +323,64 @@ var HttpDispatcher = class {
     }
     const normalizedPath = path.replace(/^\/+/, "");
     if (normalizedPath === "login" && method.toUpperCase() === "POST") {
-      const broker = this.ensureBroker();
-      const data = await broker.call("auth.login", body, { request: context.request });
-      return { handled: true, response: { status: 200, body: data } };
+      try {
+        const broker = this.ensureBroker();
+        const data = await broker.call("auth.login", body, { request: context.request });
+        return { handled: true, response: { status: 200, body: data } };
+      } catch (error) {
+        const statusCode = error?.statusCode ?? error?.status;
+        if (statusCode !== 500 || !error?.message?.includes("Broker not available")) {
+          throw error;
+        }
+      }
+    }
+    return this.mockAuthFallback(normalizedPath, method, body);
+  }
+  /**
+   * Provides mock auth responses for core better-auth endpoints when
+   * AuthPlugin is not loaded (e.g. MSW/browser-only environments).
+   * This ensures registration/sign-in flows do not 404 in mock mode.
+   */
+  mockAuthFallback(path, method, body) {
+    const m = method.toUpperCase();
+    const MOCK_SESSION_EXPIRY_MS = 864e5;
+    if ((path === "sign-up/email" || path === "register") && m === "POST") {
+      const id = `mock_${randomUUID()}`;
+      return {
+        handled: true,
+        response: {
+          status: 200,
+          body: {
+            user: { id, name: body?.name || "Mock User", email: body?.email || "mock@test.local", emailVerified: false, createdAt: (/* @__PURE__ */ new Date()).toISOString(), updatedAt: (/* @__PURE__ */ new Date()).toISOString() },
+            session: { id: `session_${id}`, userId: id, token: `mock_token_${id}`, expiresAt: new Date(Date.now() + MOCK_SESSION_EXPIRY_MS).toISOString() }
+          }
+        }
+      };
+    }
+    if ((path === "sign-in/email" || path === "login") && m === "POST") {
+      const id = `mock_${randomUUID()}`;
+      return {
+        handled: true,
+        response: {
+          status: 200,
+          body: {
+            user: { id, name: "Mock User", email: body?.email || "mock@test.local", emailVerified: true, createdAt: (/* @__PURE__ */ new Date()).toISOString(), updatedAt: (/* @__PURE__ */ new Date()).toISOString() },
+            session: { id: `session_${id}`, userId: id, token: `mock_token_${id}`, expiresAt: new Date(Date.now() + MOCK_SESSION_EXPIRY_MS).toISOString() }
+          }
+        }
+      };
+    }
+    if (path === "get-session" && m === "GET") {
+      return {
+        handled: true,
+        response: { status: 200, body: { session: null, user: null } }
+      };
+    }
+    if (path === "sign-out" && m === "POST") {
+      return {
+        handled: true,
+        response: { status: 200, body: { success: true } }
+      };
     }
     return { handled: false };
   }
@@ -328,7 +393,7 @@ var HttpDispatcher = class {
     const broker = this.ensureBroker();
     const parts = path.replace(/^\/+/, "").split("/").filter(Boolean);
     if (parts[0] === "types") {
-      const protocol = this.kernel?.context?.getService ? await this.kernel.context.getService("protocol") : null;
+      const protocol = await this.resolveService("protocol");
       if (protocol && typeof protocol.getMetaTypes === "function") {
         const result = await protocol.getMetaTypes({});
         return { handled: true, response: this.success(result) };
@@ -358,7 +423,7 @@ var HttpDispatcher = class {
     if (parts.length === 2) {
       const [type, name] = parts;
       if (method === "PUT" && body) {
-        const protocol = this.kernel?.context?.getService ? await this.kernel.context.getService("protocol") : null;
+        const protocol = await this.resolveService("protocol");
         if (protocol && typeof protocol.saveMetaItem === "function") {
           try {
             const result = await protocol.saveMetaItem({ type, name, item: body });
@@ -380,7 +445,7 @@ var HttpDispatcher = class {
           return { handled: true, response: this.success(data2) };
         }
         const singularType = type.endsWith("s") ? type.slice(0, -1) : type;
-        const protocol = this.kernel?.context?.getService ? await this.kernel.context.getService("protocol") : null;
+        const protocol = await this.resolveService("protocol");
         if (protocol && typeof protocol.getMetaItem === "function") {
           try {
             const data2 = await protocol.getMetaItem({ type: singularType, name });
@@ -398,7 +463,7 @@ var HttpDispatcher = class {
     if (parts.length === 1) {
       const typeOrName = parts[0];
       const packageId = query?.package || void 0;
-      const protocol = this.kernel?.context?.getService ? await this.kernel.context.getService("protocol") : null;
+      const protocol = await this.resolveService("protocol");
       if (protocol && typeof protocol.getMetaItems === "function") {
         try {
           const data = await protocol.getMetaItems({ type: typeOrName, packageId });
@@ -427,7 +492,7 @@ var HttpDispatcher = class {
       }
     }
     if (parts.length === 0) {
-      const protocol = this.kernel?.context?.getService ? await this.kernel.context.getService("protocol") : null;
+      const protocol = await this.resolveService("protocol");
       if (protocol && typeof protocol.getMetaTypes === "function") {
         const result = await protocol.getMetaTypes({});
         return { handled: true, response: this.success(result) };
@@ -500,25 +565,72 @@ var HttpDispatcher = class {
    * Handles Analytics requests
    * path: sub-path after /analytics/
    */
-  async handleAnalytics(path, method, body, context) {
+  async handleAnalytics(path, method, body, _context) {
     const analyticsService = await this.getService(CoreServiceName.enum.analytics);
     if (!analyticsService) return { handled: false };
     const m = method.toUpperCase();
     const subPath = path.replace(/^\/+/, "");
     if (subPath === "query" && m === "POST") {
-      const result = await analyticsService.query(body, { request: context.request });
+      const result = await analyticsService.query(body);
       return { handled: true, response: this.success(result) };
     }
     if (subPath === "meta" && m === "GET") {
-      const result = await analyticsService.getMetadata({ request: context.request });
+      const result = await analyticsService.getMeta();
       return { handled: true, response: this.success(result) };
     }
     if (subPath === "sql" && m === "POST") {
-      const result = await analyticsService.generateSql(body, { request: context.request });
+      const result = await analyticsService.generateSql(body);
       return { handled: true, response: this.success(result) };
     }
     return { handled: false };
   }
+  /**
+   * Handles i18n requests
+   * path: sub-path after /i18n/
+   *
+   * Routes:
+   *   GET /locales                    → getLocales
+   *   GET /translations/:locale       → getTranslations (locale from path)
+   *   GET /translations?locale=xx     → getTranslations (locale from query)
+   *   GET /labels/:object/:locale     → getFieldLabels  (both from path)
+   *   GET /labels/:object?locale=xx   → getFieldLabels  (locale from query)
+   */
+  async handleI18n(path, method, query, _context) {
+    const i18nService = await this.getService(CoreServiceName.enum.i18n);
+    if (!i18nService) return { handled: true, response: this.error("i18n service not available", 501) };
+    const m = method.toUpperCase();
+    const parts = path.replace(/^\/+/, "").split("/").filter(Boolean);
+    if (m !== "GET") return { handled: false };
+    if (parts[0] === "locales" && parts.length === 1) {
+      const locales = i18nService.getLocales();
+      return { handled: true, response: this.success({ locales }) };
+    }
+    if (parts[0] === "translations") {
+      const locale = parts[1] ? decodeURIComponent(parts[1]) : query?.locale;
+      if (!locale) return { handled: true, response: this.error("Missing locale parameter", 400) };
+      const translations = i18nService.getTranslations(locale);
+      return { handled: true, response: this.success({ locale, translations }) };
+    }
+    if (parts[0] === "labels" && parts.length >= 2) {
+      const objectName = decodeURIComponent(parts[1]);
+      const locale = parts[2] ? decodeURIComponent(parts[2]) : query?.locale;
+      if (!locale) return { handled: true, response: this.error("Missing locale parameter", 400) };
+      if (typeof i18nService.getFieldLabels === "function") {
+        const labels2 = i18nService.getFieldLabels(objectName, locale);
+        return { handled: true, response: this.success({ object: objectName, locale, labels: labels2 }) };
+      }
+      const translations = i18nService.getTranslations(locale);
+      const prefix = `o.${objectName}.fields.`;
+      const labels = {};
+      for (const [key, value] of Object.entries(translations)) {
+        if (key.startsWith(prefix)) {
+          labels[key.substring(prefix.length)] = value;
+        }
+      }
+      return { handled: true, response: this.success({ object: objectName, locale, labels }) };
+    }
+    return { handled: false };
+  }
   /**
    * Handles Package Management requests
    * 
@@ -709,7 +821,7 @@ var HttpDispatcher = class {
     if (parts[0] === "view" && parts[1]) {
       const objectName = parts[1];
       const type = parts[2] || query?.type || "list";
-      const protocol = this.kernel?.context?.getService ? await this.kernel.context.getService("protocol") : null;
+      const protocol = await this.resolveService("protocol");
       if (protocol && typeof protocol.getUiView === "function") {
         try {
           const result = await protocol.getUiView({ object: objectName, type });
@@ -823,33 +935,48 @@ var HttpDispatcher = class {
     return this.kernel.services || {};
   }
   async getService(name) {
-    if (typeof this.kernel.getService === "function") {
-      return await this.kernel.getService(name);
-    }
-    const services = this.getServicesMap();
-    return services[name];
+    return this.resolveService(name);
   }
   /**
-   * Get the ObjectQL service which provides access to SchemaRegistry.
-   * Tries multiple access patterns since kernel structure varies.
+   * Resolve any service by name, supporting async factories.
+   * Fallback chain: getServiceAsync → getService (sync) → context.getService → services map.
+   * Only returns when a non-null service is found; otherwise falls through to the next step.
    */
-  async getObjectQLService() {
+  async resolveService(name) {
+    if (typeof this.kernel.getServiceAsync === "function") {
+      try {
+        const svc = await this.kernel.getServiceAsync(name);
+        if (svc != null) return svc;
+      } catch {
+      }
+    }
     if (typeof this.kernel.getService === "function") {
       try {
-        const svc = await this.kernel.getService("objectql");
-        if (svc?.registry) return svc;
+        const svc = await this.kernel.getService(name);
+        if (svc != null) return svc;
       } catch {
       }
     }
     if (this.kernel?.context?.getService) {
       try {
-        const svc = await this.kernel.context.getService("objectql");
-        if (svc?.registry) return svc;
+        const svc = await this.kernel.context.getService(name);
+        if (svc != null) return svc;
       } catch {
       }
     }
     const services = this.getServicesMap();
-    if (services["objectql"]?.registry) return services["objectql"];
+    return services[name];
+  }
+  /**
+   * Get the ObjectQL service which provides access to SchemaRegistry.
+   * Tries multiple access patterns since kernel structure varies.
+   */
+  async getObjectQLService() {
+    try {
+      const svc = await this.resolveService("objectql");
+      if (svc?.registry) return svc;
+    } catch {
+    }
     return null;
   }
   capitalize(s) {
@@ -895,6 +1022,9 @@ var HttpDispatcher = class {
     if (cleanPath.startsWith("/packages")) {
       return this.handlePackages(cleanPath.substring(9), method, body, query, context);
     }
+    if (cleanPath.startsWith("/i18n")) {
+      return this.handleI18n(cleanPath.substring(5), method, query, context);
+    }
     if (cleanPath === "/openapi.json" && method === "GET") {
       const broker = this.ensureBroker();
       try {