@enfyra/sdk-nuxt 0.2.3 → 0.3.0

package/README.md

@@ -427,9 +427,6 @@ export default defineNuxtConfig({
     // Required: Main API URL
     apiUrl: process.env.ENFYRA_API_URL || "http://localhost:1105",
     
-    // Optional: API path prefix (default: '/api')
-    apiPrefix: '/api/v1',
-    
     // Required: App URL for SSR requests  
     appUrl: process.env.ENFYRA_APP_URL || "http://localhost:3001",
   },
@@ -508,13 +505,47 @@ const { execute } = useEnfyraApi<CreateUserResponse>('/users', {
 - Implement proper cache keys to avoid over-caching
 - Group related operations with batch APIs
 
+## Development
+
+### Testing
+
+The SDK includes a comprehensive test suite using Vitest:
+
+```bash
+# Run tests once
+npm run test:run
+
+# Run tests in watch mode
+npm test
+
+# Run tests with UI
+npm run test:ui
+```
+
+**Test Coverage:**
+- ✅ **Extension naming utilities** - UUID generation and validation
+- ✅ **Vue SFC validation** - Syntax and structure validation  
+- ✅ **JS bundle validation** - Syntax and export validation
+- ✅ **Extension processing** - Complete workflow testing
+- ✅ **35 test cases** covering all edge cases and error handling
+
+### Building
+
+```bash
+# Build the module
+npm run build
+
+# Development mode
+npm run dev
+```
+
 ## License
 
 MIT
 
 ## Contributing
 
-Pull requests are welcome! Please read our contributing guidelines and ensure tests pass.
+Pull requests are welcome! Please read our contributing guidelines and ensure tests pass before submitting.
 
 ## Changelog
 

package/dist/composables/useEnfyraApi.mjs

@@ -1,5 +1,6 @@
 import { ref, unref, toRaw } from "vue";
 import { $fetch } from "../utils/http";
+import { ENFYRA_API_PREFIX } from "../constants/config";
 import { useRuntimeConfig, useFetch, useRequestHeaders } from "#imports";
 function handleError(error, context, customHandler) {
   const apiError = {
@@ -20,7 +21,7 @@ export function useEnfyraApi(path, opts = {}) {
   if (ssr) {
     const config = useRuntimeConfig().public.enfyraSDK;
     const basePath = (typeof path === "function" ? path() : path).replace(/^\/?api\/?/, "").replace(/^\/+/, "");
-    const finalUrl = (config?.appUrl || "") + (config?.apiPrefix || "") + "/" + basePath;
+    const finalUrl = (config?.appUrl || "") + (config?.apiPrefix || ENFYRA_API_PREFIX) + "/" + basePath;
     const clientHeaders = process.client ? {} : useRequestHeaders([
       "authorization",
       "cookie",
@@ -72,7 +73,7 @@ export function useEnfyraApi(path, opts = {}) {
       const buildPath = (...segments) => {
         return segments.filter(Boolean).join("/");
       };
-      const fullBaseURL = apiUrl + (apiPrefix || "");
+      const fullBaseURL = apiUrl + (apiPrefix || ENFYRA_API_PREFIX);
       async function processBatch(items, processor) {
         const results = [];
         const progressResults = [];

package/dist/constants/config.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Hardcoded API prefix for all Enfyra SDK routes
+ * This ensures no conflicts with application routes
+ */
+export declare const ENFYRA_API_PREFIX = "/enfyra/api";

package/dist/constants/config.mjs

@@ -0,0 +1 @@
+export const ENFYRA_API_PREFIX = "/enfyra/api";

package/dist/index.d.ts

@@ -1,6 +1,5 @@
 export interface EnfyraConfig {
     apiUrl: string;
-    apiPrefix?: string;
     defaultHeaders?: Record<string, string>;
 }
 export interface ApiError {

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/types/index.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACzC;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,QAAQ,CAAC,EAAE,GAAG,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,0CAA0C;IAC1C,QAAQ,EAAE,MAAM,CAAC;IACjB,qCAAqC;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,iCAAiC;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,kCAAkC;IAClC,MAAM,EAAE,MAAM,CAAC;IACf,iDAAiD;IACjD,UAAU,EAAE,MAAM,CAAC;IACnB,+CAA+C;IAC/C,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,iDAAiD;IACjD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,oCAAoC;IACpC,YAAY,EAAE,MAAM,CAAC;IACrB,8BAA8B;IAC9B,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,sDAAsD;IACtD,OAAO,EAAE,KAAK,CAAC;QACb,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,WAAW,GAAG,QAAQ,CAAC;QAC/B,MAAM,CAAC,EAAE,GAAG,CAAC;QACb,KAAK,CAAC,EAAE,QAAQ,CAAC;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAC;KACnB,CAAC,CAAC;CACJ;AAGD,UAAU,cAAc,CAAC,CAAC;IACxB,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,OAAO,GAAG,QAAQ,CAAC;IACnG,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC5B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC,CAAC;IAClB,iDAAiD;IACjD,GAAG,CAAC,EAAE,OAAO,CAAC;IACd,sCAAsC;IACtC,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAGD,UAAU,eAAe;IACvB,yGAAyG;IACzG,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4FAA4F;IAC5F,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6FAA6F;IAC7F,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AAGD,KAAK,uBAAuB,CAAC,CAAC,IAAI,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,OAAO,GAAG,QAAQ,CAAA;CAAE,GAC5F,eAAe,GACf,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACtC,eAAe,GACf,CAAC,SAAS;IAAE,MAAM,CAAC,EAAE,SAAS,CAAA;CAAE,GAChC,OAAO,CAAC,eAAe,CAAC,GACxB,EAAE,CAAC;AAGP,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI,cAAc,CAAC,CAAC,CAAC,GAAG,uBAAuB,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;AAE3F,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,KAAK,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAqB,SAAQ,YAAY;IACxD,KAAK,EAAE;QACL,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,CAAC,EAAE,GAAG,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC;QACf,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,CAAC;CACH;AAED,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAG1C,MAAM,WAAW,qBAAqB,CAAC,CAAC,CAAE,SAAQ,SAAS,CAAC,CAAC,GAAG,IAAI,EAAE,QAAQ,CAAC;IAC7E,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,KAAK,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC9B;AAID,UAAU,kBAAkB;IAC1B,IAAI,CAAC,EAAE,GAAG,CAAC;IACX,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;CACtB;AAGD,UAAU,mBAAmB;IAC3B,GAAG,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1B,iDAAiD;IACjD,KAAK,CAAC,EAAE,QAAQ,EAAE,CAAC;IACnB,sDAAsD;IACtD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,4DAA4D;IAC5D,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,6DAA6D;IAC7D,UAAU,CAAC,EAAE,CAAC,QAAQ,EAAE,aAAa,KAAK,IAAI,CAAC;CAChD;AASD,MAAM,MAAM,cAAc,GAAG,kBAAkB,GAAG,mBAAmB,CAAC;AAGtE,MAAM,WAAW,wBAAwB,CAAC,CAAC;IACzC,IAAI,EAAE,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IACpB,KAAK,EAAE,GAAG,CAAC,QAAQ,GAAG,IAAI,CAAC,CAAC;IAC5B,OAAO,EAAE,GAAG,CAAC,OAAO,CAAC,CAAC;IACtB,OAAO,EAAE,CAAC,WAAW,CAAC,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,CAAC;CACpE;AAID,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/types/index.ts"],"names":[],"mappings":"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"}

package/dist/module.cjs

@@ -1,6 +1,7 @@
 'use strict';
 
 const kit = require('@nuxt/kit');
+const config_mjs = require('../dist/constants/config.mjs');
 
 var _documentCurrentScript = typeof document !== 'undefined' ? document.currentScript : null;
 const module$1 = kit.defineNuxtModule({
@@ -10,7 +11,6 @@ const module$1 = kit.defineNuxtModule({
   },
   defaults: {
     apiUrl: "",
-    apiPrefix: "/api",
     appUrl: ""
   },
   setup(options, nuxt) {
@@ -26,8 +26,8 @@ enfyraSDK: {
       );
     }
     nuxt.options.runtimeConfig.public.enfyraSDK = {
-      ...nuxt.options.runtimeConfig.public.enfyraSDK,
-      ...options
+      ...options,
+      apiPrefix: config_mjs.ENFYRA_API_PREFIX
     };
     kit.addImportsDir(resolve("./composables"));
     kit.addServerHandler({
@@ -35,17 +35,27 @@ enfyraSDK: {
       middleware: true
     });
     kit.addServerHandler({
-      route: "/api/login",
+      route: `${config_mjs.ENFYRA_API_PREFIX}/login`,
       handler: resolve("./runtime/server/api/login.post"),
       method: "post"
     });
     kit.addServerHandler({
-      route: "/api/logout",
+      route: `${config_mjs.ENFYRA_API_PREFIX}/logout`,
       handler: resolve("./runtime/server/api/logout.post"),
       method: "post"
     });
     kit.addServerHandler({
-      route: "/api/**",
+      route: `${config_mjs.ENFYRA_API_PREFIX}/extension_definition`,
+      handler: resolve("./runtime/server/api/extension_definition.post"),
+      method: "post"
+    });
+    kit.addServerHandler({
+      route: `${config_mjs.ENFYRA_API_PREFIX}/extension_definition/**`,
+      handler: resolve("./runtime/server/api/extension_definition/[id].patch"),
+      method: "patch"
+    });
+    kit.addServerHandler({
+      route: `${config_mjs.ENFYRA_API_PREFIX}/**`,
       handler: resolve("./runtime/server/api/all")
     });
   }

package/dist/module.d.cts

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

package/dist/module.d.mts

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

package/dist/module.d.ts

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

package/dist/module.json

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

package/dist/module.mjs

@@ -1,4 +1,5 @@
 import { defineNuxtModule, createResolver, addImportsDir, addServerHandler } from '@nuxt/kit';
+import { ENFYRA_API_PREFIX } from '../dist/constants/config.mjs';
 
 const module = defineNuxtModule({
   meta: {
@@ -7,7 +8,6 @@ const module = defineNuxtModule({
   },
   defaults: {
     apiUrl: "",
-    apiPrefix: "/api",
     appUrl: ""
   },
   setup(options, nuxt) {
@@ -23,8 +23,8 @@ enfyraSDK: {
       );
     }
     nuxt.options.runtimeConfig.public.enfyraSDK = {
-      ...nuxt.options.runtimeConfig.public.enfyraSDK,
-      ...options
+      ...options,
+      apiPrefix: ENFYRA_API_PREFIX
     };
     addImportsDir(resolve("./composables"));
     addServerHandler({
@@ -32,17 +32,27 @@ enfyraSDK: {
       middleware: true
     });
     addServerHandler({
-      route: "/api/login",
+      route: `${ENFYRA_API_PREFIX}/login`,
       handler: resolve("./runtime/server/api/login.post"),
       method: "post"
     });
     addServerHandler({
-      route: "/api/logout",
+      route: `${ENFYRA_API_PREFIX}/logout`,
       handler: resolve("./runtime/server/api/logout.post"),
       method: "post"
     });
     addServerHandler({
-      route: "/api/**",
+      route: `${ENFYRA_API_PREFIX}/extension_definition`,
+      handler: resolve("./runtime/server/api/extension_definition.post"),
+      method: "post"
+    });
+    addServerHandler({
+      route: `${ENFYRA_API_PREFIX}/extension_definition/**`,
+      handler: resolve("./runtime/server/api/extension_definition/[id].patch"),
+      method: "patch"
+    });
+    addServerHandler({
+      route: `${ENFYRA_API_PREFIX}/**`,
       handler: resolve("./runtime/server/api/all")
     });
   }

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

@@ -0,0 +1,40 @@
+import {
+  defineEventHandler,
+  readBody,
+  getHeader,
+  createError
+} from "h3";
+import { useRuntimeConfig } from "#imports";
+import { $fetch } from "ofetch";
+import {
+  processExtensionDefinition
+} from "../../../../utils/server/extension";
+export default defineEventHandler(async (event) => {
+  const method = event.method;
+  try {
+    let body = await readBody(event);
+    const { processedBody, compiledCode } = await processExtensionDefinition(body, method);
+    body = processedBody;
+    const config = useRuntimeConfig();
+    const apiPath = event.path.replace("/enfyra/api", "");
+    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const response = await $fetch(targetUrl, {
+      method: "PATCH",
+      headers: {
+        cookie: getHeader(event, "cookie") || "",
+        authorization: event.context.proxyHeaders?.authorization || "",
+        "Content-Type": "application/json"
+      },
+      body: body || void 0
+    });
+    return response;
+  } catch (error) {
+    if (error.statusCode) {
+      throw error;
+    }
+    throw createError({
+      statusCode: 500,
+      statusMessage: error.message || `Failed to process extension definition ${method}`
+    });
+  }
+});

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

@@ -0,0 +1,40 @@
+import {
+  defineEventHandler,
+  readBody,
+  getHeader,
+  createError
+} from "h3";
+import { useRuntimeConfig } from "#imports";
+import { $fetch } from "ofetch";
+import {
+  processExtensionDefinition
+} from "../../../../utils/server/extension";
+export default defineEventHandler(async (event) => {
+  const method = event.method;
+  try {
+    let body = await readBody(event);
+    const { processedBody, compiledCode } = await processExtensionDefinition(body, method);
+    body = processedBody;
+    const config = useRuntimeConfig();
+    const apiPath = event.path.replace("/enfyra/api", "");
+    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const response = await $fetch(targetUrl, {
+      method: "PATCH",
+      headers: {
+        cookie: getHeader(event, "cookie") || "",
+        authorization: event.context.proxyHeaders?.authorization || "",
+        "Content-Type": "application/json"
+      },
+      body: body || void 0
+    });
+    return response;
+  } catch (error) {
+    if (error.statusCode) {
+      throw error;
+    }
+    throw createError({
+      statusCode: 500,
+      statusMessage: error.message || `Failed to process extension definition ${method}`
+    });
+  }
+});

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

@@ -0,0 +1,40 @@
+import {
+  defineEventHandler,
+  readBody,
+  getHeader,
+  createError
+} from "h3";
+import { useRuntimeConfig } from "#imports";
+import { $fetch } from "ofetch";
+import {
+  processExtensionDefinition
+} from "../../../utils/server/extension";
+export default defineEventHandler(async (event) => {
+  const method = event.method;
+  try {
+    let body = await readBody(event);
+    const { processedBody, compiledCode } = await processExtensionDefinition(body, method);
+    body = processedBody;
+    const config = useRuntimeConfig();
+    const apiPath = event.path.replace("/enfyra/api", "");
+    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const response = await $fetch(targetUrl, {
+      method,
+      headers: {
+        cookie: getHeader(event, "cookie") || "",
+        authorization: event.context.proxyHeaders?.authorization || "",
+        "Content-Type": "application/json"
+      },
+      body: body || void 0
+    });
+    return response;
+  } catch (error) {
+    if (error.statusCode) {
+      throw error;
+    }
+    throw createError({
+      statusCode: 500,
+      statusMessage: error.message || `Failed to process extension definition ${method}`
+    });
+  }
+});

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

@@ -0,0 +1,40 @@
+import {
+  defineEventHandler,
+  readBody,
+  getHeader,
+  createError
+} from "h3";
+import { useRuntimeConfig } from "#imports";
+import { $fetch } from "ofetch";
+import {
+  processExtensionDefinition
+} from "../../../utils/server/extension";
+export default defineEventHandler(async (event) => {
+  const method = event.method;
+  try {
+    let body = await readBody(event);
+    const { processedBody, compiledCode } = await processExtensionDefinition(body, method);
+    body = processedBody;
+    const config = useRuntimeConfig();
+    const apiPath = event.path.replace("/enfyra/api", "");
+    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+    const response = await $fetch(targetUrl, {
+      method,
+      headers: {
+        cookie: getHeader(event, "cookie") || "",
+        authorization: event.context.proxyHeaders?.authorization || "",
+        "Content-Type": "application/json"
+      },
+      body: body || void 0
+    });
+    return response;
+  } catch (error) {
+    if (error.statusCode) {
+      throw error;
+    }
+    throw createError({
+      statusCode: 500,
+      statusMessage: error.message || `Failed to process extension definition ${method}`
+    });
+  }
+});

package/dist/utils/config.mjs

@@ -1,7 +1,6 @@
 import { ref } from "vue";
 const config = ref({
   apiUrl: "",
-  apiPrefix: "/api",
   defaultHeaders: {}
 });
 export function useEnfyraConfig() {

package/dist/utils/server/extension/compiler.mjs

@@ -0,0 +1,64 @@
+import { randomUUID } from "crypto";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { build } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { createError } from "h3";
+export async function buildExtensionWithVite(vueContent, extensionId) {
+  const buildId = `${extensionId}-${Date.now()}-${randomUUID()}`;
+  const tempDir = join(process.cwd(), ".temp-extension-builds", buildId);
+  const tempExtensionFile = join(tempDir, "extension.vue");
+  const tempEntryFile = join(tempDir, "entry.js");
+  try {
+    if (!existsSync(tempDir)) {
+      mkdirSync(tempDir, { recursive: true });
+    }
+    writeFileSync(tempExtensionFile, vueContent);
+    writeFileSync(tempEntryFile, `
+import ExtensionComponent from './extension.vue'
+export default ExtensionComponent
+`);
+    await build({
+      root: tempDir,
+      build: {
+        lib: {
+          entry: tempEntryFile,
+          name: extensionId,
+          fileName: () => "extension.js",
+          formats: ["umd"]
+        },
+        outDir: join(tempDir, "dist"),
+        emptyOutDir: true,
+        write: true,
+        rollupOptions: {
+          external: ["vue"],
+          output: {
+            globals: {
+              vue: "Vue"
+            }
+          }
+        }
+      },
+      plugins: [vue()]
+    });
+    const compiledFile = join(tempDir, "dist", "extension.js");
+    const compiledCode = readFileSync(compiledFile, "utf-8");
+    return compiledCode;
+  } catch (error) {
+    throw createError({
+      statusCode: 500,
+      statusMessage: `Failed to build extension: ${error.message || "Unknown error"}`
+    });
+  } finally {
+    await cleanupTempDirectory(tempDir);
+  }
+}
+async function cleanupTempDirectory(tempDir) {
+  try {
+    if (existsSync(tempDir)) {
+      const fs = await import("fs/promises");
+      await fs.rm(tempDir, { recursive: true, force: true });
+    }
+  } catch (cleanupError) {
+  }
+}

package/dist/utils/server/extension/index.mjs

@@ -0,0 +1,4 @@
+export * from "./naming.mjs";
+export * from "./validation.mjs";
+export * from "./compiler.mjs";
+export * from "./processor.mjs";

package/dist/utils/server/extension/naming.mjs

@@ -0,0 +1,13 @@
+import { randomUUID } from "crypto";
+const EXTENSION_UUID_PATTERN = /^extension_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+export function autoAssignExtensionName(body) {
+  const currentExtensionId = body.extensionId || "";
+  if (!currentExtensionId || !EXTENSION_UUID_PATTERN.test(currentExtensionId)) {
+    const uuid = randomUUID();
+    body.extensionId = `extension_${uuid}`;
+  }
+  return body;
+}
+export function isValidExtensionId(extensionId) {
+  return EXTENSION_UUID_PATTERN.test(extensionId);
+}

package/dist/utils/server/extension/processor.mjs

@@ -0,0 +1,34 @@
+import { createError } from "h3";
+import { autoAssignExtensionName } from "./naming.mjs";
+import { isProbablyVueSFC, assertValidVueSFC, assertValidJsBundleSyntax } from "./validation.mjs";
+import { buildExtensionWithVite } from "./compiler.mjs";
+export function isExtensionDefinitionPath(path) {
+  return path.includes("/extension_definition");
+}
+export async function processExtensionDefinition(body, method) {
+  if (method !== "POST" && method !== "PATCH") {
+    return { processedBody: body };
+  }
+  if (!body || typeof body.code !== "string") {
+    return { processedBody: body };
+  }
+  body = autoAssignExtensionName(body);
+  const code = body.code;
+  const extensionId = body.id || body.name || "extension_" + Date.now();
+  if (isProbablyVueSFC(code)) {
+    assertValidVueSFC(code);
+    try {
+      const compiledCode = await buildExtensionWithVite(code, body.extensionId);
+      body.compiledCode = compiledCode;
+      return { processedBody: body, compiledCode };
+    } catch (compileError) {
+      throw createError({
+        statusCode: 400,
+        statusMessage: compileError?.statusMessage || `Failed to build Vue SFC for ${extensionId}: ${compileError?.message || "Unknown error"}`
+      });
+    }
+  } else {
+    assertValidJsBundleSyntax(code);
+    return { processedBody: body };
+  }
+}

package/dist/utils/server/extension/validation.mjs

@@ -0,0 +1,67 @@
+import { createError } from "h3";
+export function isProbablyVueSFC(content) {
+  if (typeof content !== "string") return false;
+  const trimmed = content.trim();
+  if (!trimmed) return false;
+  const hasSfcTags = /<template[\s>]|<script[\s>]|<style[\s>]/i.test(trimmed);
+  const hasClosing = /<\/template>|<\/script>|<\/style>/i.test(trimmed);
+  return hasSfcTags && hasClosing;
+}
+export function assertValidVueSFC(content) {
+  const templateOpen = (content.match(/<template[^>]*>/g) || []).length;
+  const templateClose = (content.match(/<\/template>/g) || []).length;
+  const scriptOpen = (content.match(/<script[^>]*>/g) || []).length;
+  const scriptClose = (content.match(/<\/script>/g) || []).length;
+  const styleOpen = (content.match(/<style[^>]*>/g) || []).length;
+  const styleClose = (content.match(/<\/style>/g) || []).length;
+  if (templateOpen !== templateClose || scriptOpen !== scriptClose || styleOpen !== styleClose) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid Vue SFC: unbalanced tags"
+    });
+  }
+  if (templateOpen === 0 && scriptOpen === 0) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid Vue SFC: must have at least <template> or <script>"
+    });
+  }
+  if (scriptOpen > 0) {
+    const scriptContent = content.match(/<script[^>]*>([\s\S]*?)<\/script>/i);
+    if (scriptContent && scriptContent[1]) {
+      const script = scriptContent[1];
+      if (script.includes("export default") && !script.includes("{")) {
+        throw createError({
+          statusCode: 400,
+          statusMessage: "Invalid Vue SFC: script must have proper export default syntax"
+        });
+      }
+    }
+  }
+}
+export function assertValidJsBundleSyntax(code) {
+  const brackets = { "(": 0, ")": 0, "{": 0, "}": 0, "[": 0, "]": 0 };
+  for (const char of code) {
+    if (char in brackets) {
+      brackets[char]++;
+    }
+  }
+  if (brackets["("] !== brackets[")"] || brackets["{"] !== brackets["}"] || brackets["["] !== brackets["]"]) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid JS syntax: unbalanced brackets"
+    });
+  }
+  if (!code.includes("export") && !code.includes("module.exports") && !code.includes("window.")) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid JS bundle: must have export statement or module.exports"
+    });
+  }
+  if (code.includes("function(") && !code.includes(")")) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid JS syntax: incomplete function declaration"
+    });
+  }
+}

package/dist/utils/server/extension.mjs

@@ -0,0 +1 @@
+export * from "./extension/index.mjs";

package/dist/utils/server/proxy.mjs

@@ -1,8 +1,9 @@
 import { proxyRequest } from "h3";
 import { useRuntimeConfig } from "#imports";
+import { ENFYRA_API_PREFIX } from "../../constants/config";
 export function proxyToAPI(event, customPath) {
   const config = useRuntimeConfig();
-  const apiPrefix = config.public.enfyraSDK.apiPrefix;
+  const apiPrefix = config.public.enfyraSDK.apiPrefix || ENFYRA_API_PREFIX;
   const rawPath = customPath || event.path.replace(new RegExp(`^${apiPrefix}`), "");
   const targetUrl = `${config.public.enfyraSDK.apiUrl}${rawPath}`;
   const headers = event.context.proxyHeaders || {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@enfyra/sdk-nuxt",
-  "version": "0.2.3",
+  "version": "0.3.0",
   "description": "Nuxt SDK for Enfyra CMS",
   "repository": {
     "type": "git",
@@ -37,26 +37,31 @@
   "scripts": {
     "dev": "nuxi dev playground",
     "build": "nuxt-module-build build && npx tsc -p tsconfig.build.json && node scripts/copy-composables-types.js",
-    "prepack": "nuxt-module-build build && npx tsc -p tsconfig.build.json && node scripts/copy-composables-types.js"
+    "prepack": "nuxt-module-build build && npx tsc -p tsconfig.build.json && node scripts/copy-composables-types.js",
+    "test": "vitest",
+    "test:ui": "vitest --ui",
+    "test:run": "vitest run"
   },
   "peerDependencies": {
     "@nuxt/kit": "^3.18.1",
     "vue": "^3.0.0"
   },
   "dependencies": {
-    "@enfyra/sdk-nuxt": "^0.1.8",
+    "@vitejs/plugin-vue": "^5.2.0",
     "cookie": "^0.6.0",
     "glob": "^8.1.0",
     "h3": "^1.15.4",
     "jwt-decode": "^4.0.0",
     "nuxt": "^3.18.1",
-    "ofetch": "^1.3.3"
+    "ofetch": "^1.3.3",
+    "vite": "^6.0.7"
   },
   "devDependencies": {
     "@nuxt/module-builder": "^0.8.4",
     "@types/cookie": "^0.6.0",
+    "@vitest/ui": "^3.2.4",
     "typescript": "^5.0.0",
-    "vite": "^6.0.3",
-    "vite-plugin-dts": "^4.3.0"
+    "vite-plugin-dts": "^4.3.0",
+    "vitest": "^3.2.4"
   }
 }

package/src/composables/useEnfyraApi.ts

@@ -9,6 +9,7 @@ import type {
   BatchProgress,
 } from "../types";
 import { $fetch } from "../utils/http";
+import { ENFYRA_API_PREFIX } from "../constants/config";
 import { useRuntimeConfig, useFetch, useRequestHeaders } from "#imports";
 
 function handleError(
@@ -58,7 +59,7 @@ export function useEnfyraApi<T = any>(
       .replace(/^\/+/, ""); // Remove leading slashes
 
     const finalUrl =
-      (config?.appUrl || "") + (config?.apiPrefix || "") + "/" + basePath;
+      (config?.appUrl || "") + (config?.apiPrefix || ENFYRA_API_PREFIX) + "/" + basePath;
 
     // Get headers from client request and filter out connection-specific headers
     const clientHeaders = process.client
@@ -138,7 +139,7 @@ export function useEnfyraApi<T = any>(
       };
 
       // Build full base URL with prefix
-      const fullBaseURL = apiUrl + (apiPrefix || "");
+      const fullBaseURL = apiUrl + (apiPrefix || ENFYRA_API_PREFIX);
 
       // Helper function for batch processing with chunking, concurrency control, and real-time progress tracking
       async function processBatch<T>(

package/src/constants/config.ts

@@ -0,0 +1,5 @@
+/**
+ * Hardcoded API prefix for all Enfyra SDK routes
+ * This ensures no conflicts with application routes
+ */
+export const ENFYRA_API_PREFIX = "/enfyra/api";

package/src/module.ts

@@ -4,6 +4,7 @@ import {
   addServerHandler,
   addImportsDir,
 } from "@nuxt/kit";
+import { ENFYRA_API_PREFIX } from "./constants/config";
 
 export default defineNuxtModule({
   meta: {
@@ -12,7 +13,6 @@ export default defineNuxtModule({
   },
   defaults: {
     apiUrl: "",
-    apiPrefix: "/api",
     appUrl: "",
   },
   setup(options, nuxt) {
@@ -22,20 +22,20 @@ export default defineNuxtModule({
     if (!options.apiUrl || !options.appUrl) {
       throw new Error(
         `[Enfyra SDK Nuxt] Missing required configuration:\n` +
-        `${!options.apiUrl ? '- apiUrl is required\n' : ''}` +
-        `${!options.appUrl ? '- appUrl is required\n' : ''}` +
-        `Please configure both in your nuxt.config.ts:\n` +
-        `enfyraSDK: {\n` +
-        `  apiUrl: 'https://your-api-url',\n` +
-        `  appUrl: 'https://your-app-url'\n` +
-        `}`
+          `${!options.apiUrl ? "- apiUrl is required\n" : ""}` +
+          `${!options.appUrl ? "- appUrl is required\n" : ""}` +
+          `Please configure both in your nuxt.config.ts:\n` +
+          `enfyraSDK: {\n` +
+          `  apiUrl: 'https://your-api-url',\n` +
+          `  appUrl: 'https://your-app-url'\n` +
+          `}`
       );
     }
 
-    // Make module options available at runtime
+    // Make module options available at runtime with hardcoded apiPrefix
     nuxt.options.runtimeConfig.public.enfyraSDK = {
-      ...nuxt.options.runtimeConfig.public.enfyraSDK,
       ...options,
+      apiPrefix: ENFYRA_API_PREFIX,
     };
 
     // Auto-import composables
@@ -47,21 +47,35 @@ export default defineNuxtModule({
       middleware: true,
     });
 
-    // Register server handlers from SDK
+    // Register server handlers from SDK with hardcoded prefix
     addServerHandler({
-      route: "/api/login",
+      route: `${ENFYRA_API_PREFIX}/login`,
       handler: resolve("./runtime/server/api/login.post"),
       method: "post",
     });
 
     addServerHandler({
-      route: "/api/logout",
+      route: `${ENFYRA_API_PREFIX}/logout`,
       handler: resolve("./runtime/server/api/logout.post"),
       method: "post",
     });
 
+    // Register extension_definition specific handlers
     addServerHandler({
-      route: "/api/**",
+      route: `${ENFYRA_API_PREFIX}/extension_definition`,
+      handler: resolve("./runtime/server/api/extension_definition.post"),
+      method: "post",
+    });
+
+    addServerHandler({
+      route: `${ENFYRA_API_PREFIX}/extension_definition/**`,
+      handler: resolve("./runtime/server/api/extension_definition/[id].patch"),
+      method: "patch",
+    });
+
+    // Catch-all handler for other routes
+    addServerHandler({
+      route: `${ENFYRA_API_PREFIX}/**`,
       handler: resolve("./runtime/server/api/all"),
     });
   },

package/src/runtime/server/api/extension_definition/[id].patch.ts

@@ -0,0 +1,50 @@
+import {
+  defineEventHandler,
+  readBody,
+  getHeader,
+  createError,
+} from "h3";
+import { useRuntimeConfig } from "#imports";
+import { $fetch } from "ofetch";
+import {
+  processExtensionDefinition,
+} from "../../../../utils/server/extension";
+
+export default defineEventHandler(async (event) => {
+  const method = event.method;
+
+  try {
+    let body = await readBody(event);
+    
+    // Process extension definition logic
+    const { processedBody, compiledCode } = await processExtensionDefinition(body, method);
+    body = processedBody;
+
+    // Make API call to backend
+    const config = useRuntimeConfig();
+    const apiPath = event.path.replace("/enfyra/api", "");
+    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+
+    const response = await $fetch(targetUrl, {
+      method: "PATCH",
+      headers: {
+        cookie: getHeader(event, "cookie") || "",
+        authorization: event.context.proxyHeaders?.authorization || "",
+        "Content-Type": "application/json",
+      },
+      body: body || undefined,
+    });
+
+    return response;
+  } catch (error: any) {
+    if (error.statusCode) {
+      throw error;
+    }
+
+    throw createError({
+      statusCode: 500,
+      statusMessage:
+        error.message || `Failed to process extension definition ${method}`,
+    });
+  }
+});

package/src/runtime/server/api/extension_definition.post.ts

@@ -0,0 +1,50 @@
+import {
+  defineEventHandler,
+  readBody,
+  getHeader,
+  createError,
+} from "h3";
+import { useRuntimeConfig } from "#imports";
+import { $fetch } from "ofetch";
+import {
+  processExtensionDefinition,
+} from "../../../utils/server/extension";
+
+export default defineEventHandler(async (event) => {
+  const method = event.method;
+
+  try {
+    let body = await readBody(event);
+    
+    // Process extension definition logic
+    const { processedBody, compiledCode } = await processExtensionDefinition(body, method);
+    body = processedBody;
+
+    // Make API call to backend
+    const config = useRuntimeConfig();
+    const apiPath = event.path.replace("/enfyra/api", "");
+    const targetUrl = `${config.public.enfyraSDK.apiUrl}${apiPath}`;
+
+    const response = await $fetch(targetUrl, {
+      method: method as any,
+      headers: {
+        cookie: getHeader(event, "cookie") || "",
+        authorization: event.context.proxyHeaders?.authorization || "",
+        "Content-Type": "application/json",
+      },
+      body: body || undefined,
+    });
+
+    return response;
+  } catch (error: any) {
+    if (error.statusCode) {
+      throw error;
+    }
+
+    throw createError({
+      statusCode: 500,
+      statusMessage:
+        error.message || `Failed to process extension definition ${method}`,
+    });
+  }
+});

package/src/types/index.ts

@@ -1,6 +1,5 @@
 export interface EnfyraConfig {
   apiUrl: string;
-  apiPrefix?: string;
   defaultHeaders?: Record<string, string>;
 }
 

package/src/utils/config.ts

@@ -3,7 +3,6 @@ import type { EnfyraConfig } from '../types';
 
 const config = ref<EnfyraConfig>({
   apiUrl: '',
-  apiPrefix: '/api',
   defaultHeaders: {}
 });
 

package/src/utils/server/extension/compiler.ts

@@ -0,0 +1,78 @@
+import { randomUUID } from "crypto";
+import { readFileSync, writeFileSync, mkdirSync, existsSync } from "fs";
+import { join } from "path";
+import { build } from "vite";
+import vue from "@vitejs/plugin-vue";
+import { createError } from "h3";
+
+export async function buildExtensionWithVite(
+  vueContent: string,
+  extensionId: string
+): Promise<string> {
+  // Generate unique temp directory name for each build to avoid conflicts
+  const buildId = `${extensionId}-${Date.now()}-${randomUUID()}`;
+  const tempDir = join(process.cwd(), ".temp-extension-builds", buildId);
+  const tempExtensionFile = join(tempDir, "extension.vue");
+  const tempEntryFile = join(tempDir, "entry.js");
+
+  try {
+    if (!existsSync(tempDir)) {
+      mkdirSync(tempDir, { recursive: true });
+    }
+
+    writeFileSync(tempExtensionFile, vueContent);
+    writeFileSync(tempEntryFile, `
+import ExtensionComponent from './extension.vue'
+export default ExtensionComponent
+`);
+
+    await build({
+      root: tempDir,
+      build: {
+        lib: {
+          entry: tempEntryFile,
+          name: extensionId,
+          fileName: () => "extension.js",
+          formats: ["umd"],
+        },
+        outDir: join(tempDir, "dist"),
+        emptyOutDir: true,
+        write: true,
+        rollupOptions: {
+          external: ["vue"],
+          output: {
+            globals: {
+              vue: "Vue",
+            },
+          },
+        },
+      },
+      plugins: [vue()],
+    });
+
+    const compiledFile = join(tempDir, "dist", "extension.js");
+    const compiledCode = readFileSync(compiledFile, "utf-8");
+
+    return compiledCode;
+  } catch (error: any) {
+    throw createError({
+      statusCode: 500,
+      statusMessage: `Failed to build extension: ${
+        error.message || "Unknown error"
+      }`,
+    });
+  } finally {
+    await cleanupTempDirectory(tempDir);
+  }
+}
+
+async function cleanupTempDirectory(tempDir: string): Promise<void> {
+  try {
+    if (existsSync(tempDir)) {
+      const fs = await import("fs/promises");
+      await fs.rm(tempDir, { recursive: true, force: true });
+    }
+  } catch (cleanupError) {
+    // Silent cleanup failure - not critical
+  }
+}

package/src/utils/server/extension/index.ts

@@ -0,0 +1,4 @@
+export * from "./naming";
+export * from "./validation";
+export * from "./compiler";
+export * from "./processor";

package/src/utils/server/extension/naming.ts

@@ -0,0 +1,18 @@
+import { randomUUID } from "crypto";
+
+const EXTENSION_UUID_PATTERN = /^extension_[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+
+export function autoAssignExtensionName(body: any): any {
+  const currentExtensionId = body.extensionId || "";
+
+  if (!currentExtensionId || !EXTENSION_UUID_PATTERN.test(currentExtensionId)) {
+    const uuid = randomUUID();
+    body.extensionId = `extension_${uuid}`;
+  }
+
+  return body;
+}
+
+export function isValidExtensionId(extensionId: string): boolean {
+  return EXTENSION_UUID_PATTERN.test(extensionId);
+}

package/src/utils/server/extension/processor.ts

@@ -0,0 +1,51 @@
+import { createError } from "h3";
+import { autoAssignExtensionName } from "./naming";
+import { isProbablyVueSFC, assertValidVueSFC, assertValidJsBundleSyntax } from "./validation";
+import { buildExtensionWithVite } from "./compiler";
+
+export function isExtensionDefinitionPath(path: string): boolean {
+  return path.includes('/extension_definition');
+}
+
+export async function processExtensionDefinition(
+  body: any,
+  method: string
+): Promise<{ processedBody: any; compiledCode?: string }> {
+  if (method !== "POST" && method !== "PATCH") {
+    return { processedBody: body };
+  }
+
+  if (!body || typeof body.code !== "string") {
+    return { processedBody: body };
+  }
+
+  // Auto-assign extension name
+  body = autoAssignExtensionName(body);
+
+  const code: string = body.code;
+  const extensionId = body.id || body.name || "extension_" + Date.now();
+
+  if (isProbablyVueSFC(code)) {
+    // Validate SFC syntax before building
+    assertValidVueSFC(code);
+
+    try {
+      const compiledCode = await buildExtensionWithVite(code, body.extensionId);
+      body.compiledCode = compiledCode;
+      return { processedBody: body, compiledCode };
+    } catch (compileError: any) {
+      throw createError({
+        statusCode: 400,
+        statusMessage:
+          compileError?.statusMessage ||
+          `Failed to build Vue SFC for ${extensionId}: ${
+            compileError?.message || "Unknown error"
+          }`,
+      });
+    }
+  } else {
+    // Treat as compiled bundle; validate syntax first
+    assertValidJsBundleSyntax(code);
+    return { processedBody: body };
+  }
+}

package/src/utils/server/extension/validation.ts

@@ -0,0 +1,91 @@
+import { createError } from "h3";
+
+export function isProbablyVueSFC(content: string): boolean {
+  if (typeof content !== "string") return false;
+  const trimmed = content.trim();
+  if (!trimmed) return false;
+
+  const hasSfcTags = /<template[\s>]|<script[\s>]|<style[\s>]/i.test(trimmed);
+  const hasClosing = /<\/template>|<\/script>|<\/style>/i.test(trimmed);
+
+  return hasSfcTags && hasClosing;
+}
+
+export function assertValidVueSFC(content: string): void {
+  const templateOpen = (content.match(/<template[^>]*>/g) || []).length;
+  const templateClose = (content.match(/<\/template>/g) || []).length;
+  const scriptOpen = (content.match(/<script[^>]*>/g) || []).length;
+  const scriptClose = (content.match(/<\/script>/g) || []).length;
+  const styleOpen = (content.match(/<style[^>]*>/g) || []).length;
+  const styleClose = (content.match(/<\/style>/g) || []).length;
+
+  if (
+    templateOpen !== templateClose ||
+    scriptOpen !== scriptClose ||
+    styleOpen !== styleClose
+  ) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid Vue SFC: unbalanced tags",
+    });
+  }
+
+  if (templateOpen === 0 && scriptOpen === 0) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid Vue SFC: must have at least <template> or <script>",
+    });
+  }
+
+  if (scriptOpen > 0) {
+    const scriptContent = content.match(/<script[^>]*>([\s\S]*?)<\/script>/i);
+    if (scriptContent && scriptContent[1]) {
+      const script = scriptContent[1];
+      if (script.includes("export default") && !script.includes("{")) {
+        throw createError({
+          statusCode: 400,
+          statusMessage: "Invalid Vue SFC: script must have proper export default syntax",
+        });
+      }
+    }
+  }
+}
+
+export function assertValidJsBundleSyntax(code: string): void {
+  const brackets = { "(": 0, ")": 0, "{": 0, "}": 0, "[": 0, "]": 0 };
+
+  for (const char of code) {
+    if (char in brackets) {
+      brackets[char as keyof typeof brackets]++;
+    }
+  }
+
+  if (
+    brackets["("] !== brackets[")"] ||
+    brackets["{"] !== brackets["}"] ||
+    brackets["["] !== brackets["]"]
+  ) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid JS syntax: unbalanced brackets",
+    });
+  }
+
+  if (
+    !code.includes("export") &&
+    !code.includes("module.exports") &&
+    !code.includes("window.")
+  ) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid JS bundle: must have export statement or module.exports",
+    });
+  }
+
+  if (code.includes("function(") && !code.includes(")")) {
+    throw createError({
+      statusCode: 400,
+      statusMessage: "Invalid JS syntax: incomplete function declaration",
+    });
+  }
+}

package/src/utils/server/extension.ts

@@ -0,0 +1,2 @@
+// Re-export all extension utilities from modular structure
+export * from "./extension";

package/src/utils/server/proxy.ts

@@ -1,9 +1,10 @@
 import { H3Event, proxyRequest } from "h3";
 import { useRuntimeConfig } from "#imports";
+import { ENFYRA_API_PREFIX } from "../../constants/config";
 
 export function proxyToAPI(event: H3Event, customPath?: string) {
   const config = useRuntimeConfig();
-  const apiPrefix = config.public.enfyraSDK.apiPrefix;
+  const apiPrefix = config.public.enfyraSDK.apiPrefix || ENFYRA_API_PREFIX;
   const rawPath =
     customPath || event.path.replace(new RegExp(`^${apiPrefix}`), "");
   const targetUrl = `${config.public.enfyraSDK.apiUrl}${rawPath}`;