@enfyra/sdk-nuxt 0.3.1 → 0.3.2

package/README.md

@@ -27,12 +27,19 @@ Add the module to your `nuxt.config.ts`:
 export default defineNuxtConfig({
   modules: ["@enfyra/sdk-nuxt"],
   enfyraSDK: {
-    apiUrl: "http://localhost:1105",
-    appUrl: "http://localhost:3001",
+    apiUrl: "http://localhost:1105", // Only apiUrl is required
   },
 })
 ```
 
+### Automatic App URL Detection
+
+The SDK automatically detects your application URL:
+
+- **Client-side**: Uses `window.location.origin`
+- **Server-side**: Detects from request headers (supports proxies with `X-Forwarded-*` headers)
+- **No configuration needed**: Works out of the box with any deployment
+
 ## Quick Start
 
 ### SSR Mode - Perfect for Page Data

package/dist/composables/useEnfyraApi.mjs

@@ -1,5 +1,6 @@
 import { ref, unref, toRaw } from "vue";
 import { $fetch } from "../utils/http";
+import { getAppUrl } from "../utils/url";
 import { ENFYRA_API_PREFIX } from "../constants/config";
 import { useRuntimeConfig, useFetch, useRequestHeaders } from "#imports";
 function handleError(error, context, customHandler) {
@@ -17,11 +18,14 @@ function handleError(error, context, customHandler) {
   return apiError;
 }
 export function useEnfyraApi(path, opts = {}) {
-  const { method = "get", body, query, errorContext, onError, ssr, key, batchSize, concurrent, onProgress } = opts;
+  const { method = "get", body, query, errorContext, onError, ssr, key } = opts;
+  const batchOptions = opts;
+  const { batchSize, concurrent, onProgress } = batchOptions;
   if (ssr) {
     const config = useRuntimeConfig().public.enfyraSDK;
     const basePath = (typeof path === "function" ? path() : path).replace(/^\/?api\/?/, "").replace(/^\/+/, "");
-    const finalUrl = (config?.appUrl || "") + (config?.apiPrefix || ENFYRA_API_PREFIX) + "/" + basePath;
+    const appUrl = getAppUrl();
+    const finalUrl = appUrl + (config?.apiPrefix || ENFYRA_API_PREFIX) + "/" + basePath;
     const clientHeaders = process.client ? {} : useRequestHeaders([
       "authorization",
       "cookie",
@@ -42,7 +46,6 @@ export function useEnfyraApi(path, opts = {}) {
       headers: {
         ...serverHeaders,
         ...opts.headers
-        // Custom headers override client headers
       }
     };
     if (key) {
@@ -61,7 +64,7 @@ export function useEnfyraApi(path, opts = {}) {
     error.value = null;
     try {
       const config = useRuntimeConfig().public.enfyraSDK;
-      const apiUrl = config?.appUrl;
+      const apiUrl = getAppUrl();
       const apiPrefix = config?.apiPrefix;
       const basePath = (typeof path === "function" ? path() : path).replace(/^\/?api\/?/, "").replace(/^\/+/, "");
       const finalBody = executeOpts?.body || unref(body);
@@ -82,7 +85,10 @@ export function useEnfyraApi(path, opts = {}) {
         let failed = 0;
         const chunks = effectiveBatchSize ? Array.from(
           { length: Math.ceil(items.length / effectiveBatchSize) },
-          (_, i) => items.slice(i * effectiveBatchSize, i * effectiveBatchSize + effectiveBatchSize)
+          (_, i) => items.slice(
+            i * effectiveBatchSize,
+            i * effectiveBatchSize + effectiveBatchSize
+          )
         ) : [items];
         const totalBatches = chunks.length;
         let currentBatch = 0;
@@ -165,7 +171,9 @@ export function useEnfyraApi(path, opts = {}) {
                     result,
                     duration
                   });
-                  updateProgress(Math.max(0, batch.length - (batchItemIndex + 1)));
+                  updateProgress(
+                    Math.max(0, batch.length - (batchItemIndex + 1))
+                  );
                   return result;
                 } catch (error2) {
                   const duration = Date.now() - itemStartTime;
@@ -177,7 +185,9 @@ export function useEnfyraApi(path, opts = {}) {
                     error: error2,
                     duration
                   });
-                  updateProgress(Math.max(0, batch.length - (batchItemIndex + 1)));
+                  updateProgress(
+                    Math.max(0, batch.length - (batchItemIndex + 1))
+                  );
                   throw error2;
                 }
               });
@@ -200,7 +210,9 @@ export function useEnfyraApi(path, opts = {}) {
                   result,
                   duration
                 });
-                updateProgress(Math.max(0, chunk.length - (chunkItemIndex + 1)));
+                updateProgress(
+                  Math.max(0, chunk.length - (chunkItemIndex + 1))
+                );
                 return result;
               } catch (error2) {
                 const duration = Date.now() - itemStartTime;
@@ -212,7 +224,9 @@ export function useEnfyraApi(path, opts = {}) {
                   error: error2,
                   duration
                 });
-                updateProgress(Math.max(0, chunk.length - (chunkItemIndex + 1)));
+                updateProgress(
+                  Math.max(0, chunk.length - (chunkItemIndex + 1))
+                );
                 throw error2;
               }
             });
@@ -224,30 +238,35 @@ export function useEnfyraApi(path, opts = {}) {
         return results;
       }
       if (isBatchOperation && executeOpts?.ids && executeOpts.ids.length > 0) {
-        const responses = await processBatch(executeOpts.ids, async (id, index) => {
-          const finalPath2 = buildPath(basePath, id);
-          return $fetch(finalPath2, {
-            baseURL: fullBaseURL,
-            method,
-            body: finalBody ? toRaw(finalBody) : void 0,
-            headers: opts.headers,
-            query: finalQuery
-          });
-        });
+        const responses = await processBatch(
+          executeOpts.ids,
+          async (id) => {
+            const finalPath2 = buildPath(basePath, id);
+            return $fetch(finalPath2, {
+              baseURL: fullBaseURL,
+              method,
+              body: finalBody ? toRaw(finalBody) : void 0,
+              headers: opts.headers,
+              query: finalQuery
+            });
+          }
+        );
         data.value = responses;
         return responses;
       }
       if (isBatchOperation && executeOpts?.files && Array.isArray(executeOpts.files) && executeOpts.files.length > 0) {
-        const responses = await processBatch(executeOpts.files, async (fileObj, index) => {
-          return $fetch(basePath, {
-            baseURL: fullBaseURL,
-            method,
-            body: fileObj,
-            // {file: file1, folder: null}
-            headers: opts.headers,
-            query: finalQuery
-          });
-        });
+        const responses = await processBatch(
+          executeOpts.files,
+          async (fileObj) => {
+            return $fetch(basePath, {
+              baseURL: fullBaseURL,
+              method,
+              body: fileObj,
+              headers: opts.headers,
+              query: finalQuery
+            });
+          }
+        );
         data.value = responses;
         return responses;
       }

package/dist/index.d.ts.map

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

package/dist/index.js

@@ -1,2 +1 @@
-// Re-export auth types
 export * from './auth';

package/dist/module.cjs

@@ -10,25 +10,37 @@ const module$1 = kit.defineNuxtModule({
     configKey: "enfyraSDK"
   },
   defaults: {
-    apiUrl: "",
-    appUrl: ""
+    apiUrl: ""
   },
   setup(options, nuxt) {
     const { resolve } = kit.createResolver((typeof document === 'undefined' ? require('u' + 'rl').pathToFileURL(__filename).href : (_documentCurrentScript && _documentCurrentScript.tagName.toUpperCase() === 'SCRIPT' && _documentCurrentScript.src || new URL('module.cjs', document.baseURI).href)));
-    if (!options.apiUrl || !options.appUrl) {
-      throw new Error(
+    if (!options.apiUrl) {
+      console.warn(
         `[Enfyra SDK Nuxt] Missing required configuration:
-${!options.apiUrl ? "- apiUrl is required\n" : ""}${!options.appUrl ? "- appUrl is required\n" : ""}Please configure both in your nuxt.config.ts:
+- apiUrl is required
+Please configure it in your nuxt.config.ts:
 enfyraSDK: {
-  apiUrl: 'https://your-api-url',
-  appUrl: 'https://your-app-url'
+  apiUrl: 'https://your-api-url'
 }`
       );
+      nuxt.options.runtimeConfig.public.enfyraSDK = {
+        ...options,
+        apiPrefix: config_mjs.ENFYRA_API_PREFIX,
+        configError: true,
+        configErrorMessage: "Enfyra SDK: apiUrl is required. Please configure it in nuxt.config.ts"
+      };
+    } else {
+      nuxt.options.runtimeConfig.public.enfyraSDK = {
+        ...options,
+        apiPrefix: config_mjs.ENFYRA_API_PREFIX
+      };
+    }
+    if (!options.apiUrl) {
+      kit.addPlugin({
+        src: resolve("./runtime/plugin/config-error.client"),
+        mode: "client"
+      });
     }
-    nuxt.options.runtimeConfig.public.enfyraSDK = {
-      ...options,
-      apiPrefix: config_mjs.ENFYRA_API_PREFIX
-    };
     kit.addImportsDir(resolve("./composables"));
     kit.addServerHandler({
       handler: resolve("./runtime/server/middleware/auth"),

package/dist/module.d.cts

@@ -2,10 +2,8 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 declare const _default: _nuxt_schema.NuxtModule<{
     apiUrl: string;
-    appUrl: string;
 }, {
     apiUrl: string;
-    appUrl: string;
 }, false>;
 
 export { _default as default };

package/dist/module.d.mts

@@ -2,10 +2,8 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 declare const _default: _nuxt_schema.NuxtModule<{
     apiUrl: string;
-    appUrl: string;
 }, {
     apiUrl: string;
-    appUrl: string;
 }, false>;
 
 export { _default as default };

package/dist/module.d.ts

@@ -2,10 +2,8 @@ import * as _nuxt_schema from '@nuxt/schema';
 
 declare const _default: _nuxt_schema.NuxtModule<{
     apiUrl: string;
-    appUrl: string;
 }, {
     apiUrl: string;
-    appUrl: string;
 }, false>;
 
 export { _default as default };

package/dist/module.json

@@ -1,7 +1,7 @@
 {
   "name": "@enfyra/sdk-nuxt",
   "configKey": "enfyraSDK",
-  "version": "0.3.1",
+  "version": "0.3.2",
   "builder": {
     "@nuxt/module-builder": "0.8.4",
     "unbuild": "2.0.0"

package/dist/module.mjs

@@ -1,4 +1,4 @@
-import { defineNuxtModule, createResolver, addImportsDir, addServerHandler } from '@nuxt/kit';
+import { defineNuxtModule, createResolver, addPlugin, addImportsDir, addServerHandler } from '@nuxt/kit';
 import { ENFYRA_API_PREFIX } from '../dist/constants/config.mjs';
 
 const module = defineNuxtModule({
@@ -7,25 +7,37 @@ const module = defineNuxtModule({
     configKey: "enfyraSDK"
   },
   defaults: {
-    apiUrl: "",
-    appUrl: ""
+    apiUrl: ""
   },
   setup(options, nuxt) {
     const { resolve } = createResolver(import.meta.url);
-    if (!options.apiUrl || !options.appUrl) {
-      throw new Error(
+    if (!options.apiUrl) {
+      console.warn(
         `[Enfyra SDK Nuxt] Missing required configuration:
-${!options.apiUrl ? "- apiUrl is required\n" : ""}${!options.appUrl ? "- appUrl is required\n" : ""}Please configure both in your nuxt.config.ts:
+- apiUrl is required
+Please configure it in your nuxt.config.ts:
 enfyraSDK: {
-  apiUrl: 'https://your-api-url',
-  appUrl: 'https://your-app-url'
+  apiUrl: 'https://your-api-url'
 }`
       );
+      nuxt.options.runtimeConfig.public.enfyraSDK = {
+        ...options,
+        apiPrefix: ENFYRA_API_PREFIX,
+        configError: true,
+        configErrorMessage: "Enfyra SDK: apiUrl is required. Please configure it in nuxt.config.ts"
+      };
+    } else {
+      nuxt.options.runtimeConfig.public.enfyraSDK = {
+        ...options,
+        apiPrefix: ENFYRA_API_PREFIX
+      };
+    }
+    if (!options.apiUrl) {
+      addPlugin({
+        src: resolve("./runtime/plugin/config-error.client"),
+        mode: "client"
+      });
     }
-    nuxt.options.runtimeConfig.public.enfyraSDK = {
-      ...options,
-      apiPrefix: ENFYRA_API_PREFIX
-    };
     addImportsDir(resolve("./composables"));
     addServerHandler({
       handler: resolve("./runtime/server/middleware/auth"),

package/dist/runtime/plugin/config-error.client.js

@@ -0,0 +1,107 @@
+import { defineNuxtPlugin, useRuntimeConfig } from "#imports";
+export default defineNuxtPlugin(() => {
+  const config = useRuntimeConfig().public?.enfyraSDK;
+  if (config?.configError) {
+    if (typeof window !== "undefined" && document) {
+      let showError = function() {
+        const errorDiv = document.createElement("div");
+        errorDiv.id = "enfyra-config-error";
+        errorDiv.style.cssText = `
+          position: fixed;
+          top: 0;
+          left: 0;
+          right: 0;
+          bottom: 0;
+          background: rgba(0, 0, 0, 0.9);
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          z-index: 999999;
+          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+        `;
+        const content = document.createElement("div");
+        content.style.cssText = `
+          background: white;
+          padding: 40px;
+          border-radius: 12px;
+          max-width: 600px;
+          width: 90%;
+          box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+        `;
+        content.innerHTML = `
+          <div style="display: flex; align-items: center; margin-bottom: 20px;">
+            <svg width="32" height="32" viewBox="0 0 24 24" fill="none" style="margin-right: 12px;">
+              <circle cx="12" cy="12" r="10" stroke="#ef4444" stroke-width="2"/>
+              <path d="M12 8v4M12 16h.01" stroke="#ef4444" stroke-width="2" stroke-linecap="round"/>
+            </svg>
+            <h1 style="margin: 0; color: #1f2937; font-size: 24px; font-weight: 600;">
+              Configuration Error
+            </h1>
+          </div>
+          
+          <div style="color: #4b5563; margin-bottom: 24px; line-height: 1.6;">
+            <p style="margin: 0 0 16px 0; font-size: 16px;">
+              <strong>Enfyra SDK</strong> is not configured properly.
+            </p>
+            <p style="margin: 0; color: #6b7280; font-size: 14px;">
+              ${config?.configErrorMessage || "Missing required configuration"}
+            </p>
+          </div>
+          
+          <div style="background: #f9fafb; border: 1px solid #e5e7eb; border-radius: 8px; padding: 16px; margin-bottom: 24px;">
+            <p style="margin: 0 0 12px 0; color: #6b7280; font-size: 13px; text-transform: uppercase; letter-spacing: 0.5px;">
+              Add to your nuxt.config.ts:
+            </p>
+            <pre style="margin: 0; background: #1f2937; color: #f3f4f6; padding: 16px; border-radius: 6px; overflow-x: auto; font-size: 14px; line-height: 1.4;"><code>export default defineNuxtConfig({
+  modules: ["@enfyra/sdk-nuxt"],
+  enfyraSDK: {
+    <span style="color: #fbbf24;">apiUrl</span>: <span style="color: #34d399;">"https://your-api-url"</span>
+  }
+})</code></pre>
+          </div>
+          
+          <div style="display: flex; gap: 12px;">
+            <button onclick="location.reload()" style="
+              background: #3b82f6;
+              color: white;
+              border: none;
+              padding: 10px 20px;
+              border-radius: 6px;
+              font-size: 14px;
+              font-weight: 500;
+              cursor: pointer;
+              transition: background 0.2s;
+            " onmouseover="this.style.background='#2563eb'" onmouseout="this.style.background='#3b82f6'">
+              Reload Page
+            </button>
+            <button onclick="document.getElementById('enfyra-config-error').style.display='none'" style="
+              background: #f3f4f6;
+              color: #4b5563;
+              border: 1px solid #e5e7eb;
+              padding: 10px 20px;
+              border-radius: 6px;
+              font-size: 14px;
+              font-weight: 500;
+              cursor: pointer;
+              transition: all 0.2s;
+            " onmouseover="this.style.background='#e5e7eb'" onmouseout="this.style.background='#f3f4f6'">
+              Dismiss
+            </button>
+          </div>
+        `;
+        errorDiv.appendChild(content);
+        document.body.appendChild(errorDiv);
+        console.error(
+          "%c\u26A0\uFE0F Enfyra SDK Configuration Error",
+          "color: #ef4444; font-size: 16px; font-weight: bold;",
+          "\n\n" + (config?.configErrorMessage || "Missing required configuration") + '\n\nPlease add the following to your nuxt.config.ts:\n\nenfyraSDK: {\n  apiUrl: "https://your-api-url"\n}'
+        );
+      };
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", showError);
+      } else {
+        showError();
+      }
+    }
+  }
+});

package/dist/runtime/plugin/config-error.client.mjs

@@ -0,0 +1,107 @@
+import { defineNuxtPlugin, useRuntimeConfig } from "#imports";
+export default defineNuxtPlugin(() => {
+  const config = useRuntimeConfig().public?.enfyraSDK;
+  if (config?.configError) {
+    if (typeof window !== "undefined" && document) {
+      let showError = function() {
+        const errorDiv = document.createElement("div");
+        errorDiv.id = "enfyra-config-error";
+        errorDiv.style.cssText = `
+          position: fixed;
+          top: 0;
+          left: 0;
+          right: 0;
+          bottom: 0;
+          background: rgba(0, 0, 0, 0.9);
+          display: flex;
+          align-items: center;
+          justify-content: center;
+          z-index: 999999;
+          font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+        `;
+        const content = document.createElement("div");
+        content.style.cssText = `
+          background: white;
+          padding: 40px;
+          border-radius: 12px;
+          max-width: 600px;
+          width: 90%;
+          box-shadow: 0 20px 60px rgba(0, 0, 0, 0.3);
+        `;
+        content.innerHTML = `
+          <div style="display: flex; align-items: center; margin-bottom: 20px;">
+            <svg width="32" height="32" viewBox="0 0 24 24" fill="none" style="margin-right: 12px;">
+              <circle cx="12" cy="12" r="10" stroke="#ef4444" stroke-width="2"/>
+              <path d="M12 8v4M12 16h.01" stroke="#ef4444" stroke-width="2" stroke-linecap="round"/>
+            </svg>
+            <h1 style="margin: 0; color: #1f2937; font-size: 24px; font-weight: 600;">
+              Configuration Error
+            </h1>
+          </div>
+          
+          <div style="color: #4b5563; margin-bottom: 24px; line-height: 1.6;">
+            <p style="margin: 0 0 16px 0; font-size: 16px;">
+              <strong>Enfyra SDK</strong> is not configured properly.
+            </p>
+            <p style="margin: 0; color: #6b7280; font-size: 14px;">
+              ${config?.configErrorMessage || "Missing required configuration"}
+            </p>
+          </div>
+          
+          <div style="background: #f9fafb; border: 1px solid #e5e7eb; border-radius: 8px; padding: 16px; margin-bottom: 24px;">
+            <p style="margin: 0 0 12px 0; color: #6b7280; font-size: 13px; text-transform: uppercase; letter-spacing: 0.5px;">
+              Add to your nuxt.config.ts:
+            </p>
+            <pre style="margin: 0; background: #1f2937; color: #f3f4f6; padding: 16px; border-radius: 6px; overflow-x: auto; font-size: 14px; line-height: 1.4;"><code>export default defineNuxtConfig({
+  modules: ["@enfyra/sdk-nuxt"],
+  enfyraSDK: {
+    <span style="color: #fbbf24;">apiUrl</span>: <span style="color: #34d399;">"https://your-api-url"</span>
+  }
+})</code></pre>
+          </div>
+          
+          <div style="display: flex; gap: 12px;">
+            <button onclick="location.reload()" style="
+              background: #3b82f6;
+              color: white;
+              border: none;
+              padding: 10px 20px;
+              border-radius: 6px;
+              font-size: 14px;
+              font-weight: 500;
+              cursor: pointer;
+              transition: background 0.2s;
+            " onmouseover="this.style.background='#2563eb'" onmouseout="this.style.background='#3b82f6'">
+              Reload Page
+            </button>
+            <button onclick="document.getElementById('enfyra-config-error').style.display='none'" style="
+              background: #f3f4f6;
+              color: #4b5563;
+              border: 1px solid #e5e7eb;
+              padding: 10px 20px;
+              border-radius: 6px;
+              font-size: 14px;
+              font-weight: 500;
+              cursor: pointer;
+              transition: all 0.2s;
+            " onmouseover="this.style.background='#e5e7eb'" onmouseout="this.style.background='#f3f4f6'">
+              Dismiss
+            </button>
+          </div>
+        `;
+        errorDiv.appendChild(content);
+        document.body.appendChild(errorDiv);
+        console.error(
+          "%c\u26A0\uFE0F Enfyra SDK Configuration Error",
+          "color: #ef4444; font-size: 16px; font-weight: bold;",
+          "\n\n" + (config?.configErrorMessage || "Missing required configuration") + '\n\nPlease add the following to your nuxt.config.ts:\n\nenfyraSDK: {\n  apiUrl: "https://your-api-url"\n}'
+        );
+      };
+      if (document.readyState === "loading") {
+        document.addEventListener("DOMContentLoaded", showError);
+      } else {
+        showError();
+      }
+    }
+  }
+});

package/dist/runtime/server/api/extension_definition/[id].patch.js

@@ -17,7 +17,7 @@ export default defineEventHandler(async (event) => {
     body = processedBody;
     const config = useRuntimeConfig();
     const apiPath = event.path.replace("/enfyra/api", "");
-    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const targetUrl = `${config.public?.enfyraSDK?.apiUrl}${apiPath}`;
     const response = await $fetch(targetUrl, {
       method: "PATCH",
       headers: {

package/dist/runtime/server/api/extension_definition/[id].patch.mjs

@@ -17,7 +17,7 @@ export default defineEventHandler(async (event) => {
     body = processedBody;
     const config = useRuntimeConfig();
     const apiPath = event.path.replace("/enfyra/api", "");
-    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const targetUrl = `${config.public?.enfyraSDK?.apiUrl}${apiPath}`;
     const response = await $fetch(targetUrl, {
       method: "PATCH",
       headers: {

package/dist/runtime/server/api/extension_definition.post.js

@@ -17,7 +17,7 @@ export default defineEventHandler(async (event) => {
     body = processedBody;
     const config = useRuntimeConfig();
     const apiPath = event.path.replace("/enfyra/api", "");
-    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const targetUrl = `${config.public?.enfyraSDK?.apiUrl}${apiPath}`;
     const response = await $fetch(targetUrl, {
       method,
       headers: {

package/dist/runtime/server/api/extension_definition.post.mjs

@@ -17,7 +17,7 @@ export default defineEventHandler(async (event) => {
     body = processedBody;
     const config = useRuntimeConfig();
     const apiPath = event.path.replace("/enfyra/api", "");
-    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const targetUrl = `${config.public?.enfyraSDK?.apiUrl}${apiPath}`;
     const response = await $fetch(targetUrl, {
       method,
       headers: {

package/dist/runtime/server/api/login.post.js

@@ -15,7 +15,7 @@ import {
 } from "../../../constants/auth";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
-  const apiUrl = config.public.enfyraSDK.apiUrl;
+  const apiUrl = config.public.enfyraSDK?.apiUrl;
   try {
     const body = await readBody(event);
     const response = await $fetch(`${apiUrl}/auth/login`, {

package/dist/runtime/server/api/login.post.mjs

@@ -15,7 +15,7 @@ import {
 } from "../../../constants/auth";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
-  const apiUrl = config.public.enfyraSDK.apiUrl;
+  const apiUrl = config.public.enfyraSDK?.apiUrl;
   try {
     const body = await readBody(event);
     const response = await $fetch(`${apiUrl}/auth/login`, {

package/dist/runtime/server/api/logout.post.js

@@ -8,7 +8,7 @@ import {
 } from "../../../constants/auth";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
-  const apiUrl = config.public.enfyraSDK.apiUrl;
+  const apiUrl = config.public?.enfyraSDK?.apiUrl;
   const refreshToken = getCookie(event, REFRESH_TOKEN_KEY);
   try {
     const result = await $fetch(`${apiUrl}/auth/logout`, {

package/dist/runtime/server/api/logout.post.mjs

@@ -8,7 +8,7 @@ import {
 } from "../../../constants/auth";
 export default defineEventHandler(async (event) => {
   const config = useRuntimeConfig();
-  const apiUrl = config.public.enfyraSDK.apiUrl;
+  const apiUrl = config.public?.enfyraSDK?.apiUrl;
   const refreshToken = getCookie(event, REFRESH_TOKEN_KEY);
   try {
     const result = await $fetch(`${apiUrl}/auth/logout`, {