feat: namespaced extensions

.changeset/hungry-squids-yell.md

@@ -0,0 +1,11 @@
+---
+"@vue-storefront/middleware": minor
+---
+
+It is now possible to add namespaced extensions to integrations. Namespaced extensions are registered under `/{integration-name}/{extension-name}` extension of integration's namespace in opposition to non-namespaced extensions which are registered under `/{integration-name}` integration's namespace. Default value is `false`. Extensions without a namespace can potentially override existing endpoints, so it's recommended to use namespaced extensions whenever possible.
+
+Read more about extensions in our [docs](https://docs.vuestorefront.io/middleware/guides/extensions).
+
+
+
+

docs/content/3.middleware/2.guides/3.extensions.md

@@ -16,6 +16,7 @@ export const integrations = {
         ...extensions, // don't forget to add existing extensions
         {
           name: 'extension-name',
+          isNamespaced: `[true/false:default]`
           extendApiMethods: { /* ... */ },
           extendApp: (app) => { /* ... */ },
           hooks: () => { /* ... */ }
@@ -49,6 +50,7 @@ const extension = {
 ```
 
 - `name` - a unique name for your extension,
+- `isNamespaced` - defines if the extension should be namespaced. Namespaced extensions are registered under `/{integration-name}/{extension-name}` extension of integration's namespace in opposition to non-namespaced extensions which are registered under `/{integration-name}` integration's namespace. Default value is `false`. Extensions without a namespace can potentially override existing endpoints, so it's recommended to use namespaced extensions whenever possible.
 - `extendApiMethods` - overrides an integration's API Client to modify default behavior or add new API endpoints
 - `extendApp` - gives you access to the Express.js app
 - `hooks` - defines lifecycle hooks of API-client

docs/package.json

@@ -18,7 +18,8 @@
     "@microsoft/api-documenter": "^7.13.30",
     "@microsoft/api-extractor": "^7.18.1",
     "@types/node": "^18",
-    "nuxt": "^3.6.2"
+    "nuxt": "^3.6.2",
+    "nuxt-gtag": "^1.1.2"
   },
   "dependencies": {
     "@stackblitz/sdk": "^1.9.0",
@@ -27,4 +28,4 @@
   "resolutions": {
     "@nuxt/content": "^2.8.0"
   }
-}
+}