@veap/plugins 0.1.0 → 0.1.3

package/README.md

@@ -1,5 +1,6 @@
-[![CI](https://github.com/veapjs/veap-plugins/actions/workflows/ci.yml/badge.svg)](https://github.com/veapjs/veap-plugins/actions/workflows/ci.yml)
-[![Release](https://github.com/veapjs/veap-plugins/actions/workflows/release.yml/badge.svg)](https://github.com/veapjs/veap-plugins/actions/workflows/release.yml)
+[![CI](https://github.com/veapjs/veap-plugins/actions/workflows/CI.yml/badge.svg)](https://github.com/veapjs/veap-plugins/actions/workflows/CI.yml)
+[![Release](https://github.com/veapjs/veap-plugins/actions/workflows/RELEASE.yml/badge.svg)](https://github.com/veapjs/veap-plugins/actions/workflows/RELEASE.yml)
+[![Version](https://img.shields.io/npm/v/@veap/plugins?style=flat&colorA=000000&colorB=000000)](https://www.npmjs.com/package/@veap/plugins)
 
 # @veap/plugins
 

package/dist/common/index.d.ts

@@ -1,3 +1,4 @@
-export * from "./context";
-export * from "./events";
-export * from "./types";
+export * from "./context.js";
+export * from "./events.js";
+export * from "./tokens.js";
+export * from "./types.js";

package/dist/common/index.js

@@ -1,3 +1,4 @@
-export * from "./context";
-export * from "./events";
-export * from "./types";
+export * from "./context.js";
+export * from "./events.js";
+export * from "./tokens.js";
+export * from "./types.js";

package/dist/common/tokens.d.ts

@@ -0,0 +1,14 @@
+import type { Token } from "@veap/kernel";
+import type { RouterService } from "../router/router.service.js";
+/**
+ * IoC Token for the application plugins array.
+ */
+export declare const APP_PLUGINS: Token<any[]>;
+/**
+ * IoC Token for the virtual RouterService.
+ */
+export declare const ROUTER_SERVICE: Token<RouterService>;
+/**
+ * IoC Token for the main site layout component.
+ */
+export declare const SITE_LAYOUT: Token<any>;

package/dist/common/tokens.js

@@ -0,0 +1,12 @@
+/**
+ * IoC Token for the application plugins array.
+ */
+export const APP_PLUGINS = Symbol.for("veap:kernel:app-plugins");
+/**
+ * IoC Token for the virtual RouterService.
+ */
+export const ROUTER_SERVICE = Symbol.for("veap:router:service");
+/**
+ * IoC Token for the main site layout component.
+ */
+export const SITE_LAYOUT = Symbol.for("veap:router:site-layout");

package/dist/common/types.d.ts

@@ -1,6 +1,15 @@
 import type { UserPermission, UserRole } from "@veap/auth";
 import type { SystemEvent } from "@veap/kernel";
 export type { SystemEvent };
+declare module "@veap/kernel" {
+    interface VeapConfig {
+        /**
+         * Prefix for all administrative routes.
+         * Default: "/app"
+         */
+        privatePath?: string;
+    }
+}
 import type * as React from "react";
 import { z } from "zod";
 export type SidebarGroupType = {
@@ -49,8 +58,7 @@ export interface PluginManifest {
     [key: string]: any;
 }
 /**
- * Shape of the `veap` field in a plugin `package.json`.
- * This replaces the standalone `manifest.json` file.
+ * Shape of the `veap` field in a plugin `package.json`.\n * This replaces the standalone `manifest.json` file.
  */
 export interface VeapPackageMetadata {
     type?: string;
@@ -77,8 +85,7 @@ export interface VeapPackageJson {
     [key: string]: any;
 }
 /**
- * Helper to build a `PluginManifest` from a `package.json` import.
- * Eliminates the need for a standalone `manifest.json` file.
+ * Helper to build a `PluginManifest` from a `package.json` import.\n * Eliminates the need for a standalone `manifest.json` file.
  *
  * @example
  * ```ts

package/dist/common/types.js

@@ -12,8 +12,7 @@ export const PluginManifestSchema = z.object({
     author: z.string().optional(),
 });
 /**
- * Helper to build a `PluginManifest` from a `package.json` import.
- * Eliminates the need for a standalone `manifest.json` file.
+ * Helper to build a `PluginManifest` from a `package.json` import.\n * Eliminates the need for a standalone `manifest.json` file.
  *
  * @example
  * ```ts

package/dist/composition.d.ts

@@ -0,0 +1,15 @@
+import { ServiceProvider } from "@veap/kernel";
+declare module "@veap/kernel" {
+    interface ApplicationBuilder {
+        /**
+         * Registers plugins with the application IoC container and configures PluginsServiceProvider.
+         */
+        withPlugins(plugins: any[]): this;
+    }
+}
+declare class PluginsConfigProvider extends ServiceProvider {
+    private plugins;
+    constructor(container: any, plugins?: any[]);
+    register(): void;
+}
+export { PluginsConfigProvider };

package/dist/composition.js

@@ -0,0 +1,20 @@
+import { ApplicationBuilder, ServiceProvider } from "@veap/kernel";
+import { APP_PLUGINS } from "./common/tokens.js";
+import { PluginsServiceProvider } from "./providers/plugins.provider.js";
+class PluginsConfigProvider extends ServiceProvider {
+    plugins;
+    constructor(container, plugins = []) {
+        super(container);
+        this.plugins = plugins;
+    }
+    register() {
+        this.container.register({ token: APP_PLUGINS, useValue: this.plugins });
+        this.container.register({ token: "AppPlugins", useValue: this.plugins });
+    }
+}
+if (!ApplicationBuilder.prototype.withPlugins) {
+    ApplicationBuilder.prototype.withPlugins = function (plugins) {
+        return this.use((c) => new PluginsConfigProvider(c, plugins)).use(PluginsServiceProvider);
+    };
+}
+export { PluginsConfigProvider };

package/dist/index.d.ts

@@ -1,5 +1,6 @@
-export * from "./common";
-export * from "./migrations";
-export * from "./navigation";
-export * from "./providers";
-export * from "./registry";
+export * from "./common/index.js";
+export * from "./composition.js";
+export * from "./migrations/index.js";
+export * from "./navigation/index.js";
+export * from "./providers/index.js";
+export * from "./registry/index.js";

package/dist/index.js

@@ -1,5 +1,6 @@
-export * from "./common";
-export * from "./migrations";
-export * from "./navigation";
-export * from "./providers";
-export * from "./registry";
+export * from "./common/index.js";
+export * from "./composition.js";
+export * from "./migrations/index.js";
+export * from "./navigation/index.js";
+export * from "./providers/index.js";
+export * from "./registry/index.js";

package/dist/providers/plugins.provider.js

@@ -1,15 +1,16 @@
 import { isDatabaseInitialized } from "@veap/database";
 import { IntlService } from "@veap/intl/server";
-import { APP_PLUGINS, eventBus, ROUTER_SERVICE, ServiceProvider, SITE_LAYOUT, } from "@veap/kernel";
-import { bindPluginsContext } from "../common/context";
-import { runPluginMigrations } from "../migrations";
-import { NavigationService } from "../navigation/navigation.service";
-import { MIGRATION_RUNNER, PLUGIN_REPOSITORY } from "../registry/contracts";
-import { ensurePluginsInitialized, registerPlugins } from "../registry/facade";
-import { KnexMigrationRunner } from "../registry/migration-runner";
-import { ActiveRecordPluginRepository } from "../registry/plugin.repository";
-import { PluginRegistry } from "../registry/registry.service";
-import { RouterService } from "../router/router.service";
+import { eventBus, ServiceProvider } from "@veap/kernel";
+import { bindPluginsContext } from "../common/context.js";
+import { APP_PLUGINS, ROUTER_SERVICE, SITE_LAYOUT } from "../common/tokens.js";
+import { runPluginMigrations } from "../migrations/index.js";
+import { NavigationService } from "../navigation/navigation.service.js";
+import { MIGRATION_RUNNER, PLUGIN_REPOSITORY } from "../registry/contracts.js";
+import { ensurePluginsInitialized, registerPlugins, } from "../registry/facade.js";
+import { KnexMigrationRunner } from "../registry/migration-runner.js";
+import { ActiveRecordPluginRepository } from "../registry/plugin.repository.js";
+import { PluginRegistry } from "../registry/registry.service.js";
+import { RouterService } from "../router/router.service.js";
 export class PluginsServiceProvider extends ServiceProvider {
     config;
     constructor(container, config) {

package/dist/registry/registry.service.d.ts

@@ -1,6 +1,6 @@
 import { type IEventBus, type ILogger } from "@veap/kernel";
-import { type IMigrationRunner, type IPluginRepository } from "./contracts";
 import type { IPlugin } from "../common";
+import { type IMigrationRunner, type IPluginRepository } from "./contracts";
 export declare class PluginRegistry {
     private readonly repository;
     private readonly migrationRunner;

package/dist/router/index.d.ts

@@ -2,12 +2,13 @@
  * @module router
  * @description Virtual Router API for Veap Plugin system.
  */
-export { addRouteRewrite, buildRouteTree, getModulesWithHomepage, getPluginsWithHomepage, getRouteRewrites, matchRoute, } from "./discovery";
-export { handleVeapApiRequest } from "./handler";
-export { matchRoute as matchVirtualRoute } from "./matcher";
-export { ApiEnsuredAuth, ApiSameOrigin, EnsuredAuth, EnsuredGuest, EnsuredUser, runApiPipeline, runPipeline, SameOrigin, SkipSecurity, } from "./middlewares";
-export { RouterErrorBoundary, SoftNavigationInterceptor, VeapRouter, type WithRouterConfig, withRouter, } from "./react";
-export { extractParamName, isCatchAllSegment, isDynamicSegment, isGroupSegment, isOptionalCatchAllSegment, isParallelSlot, type LayoutChainEntry, type MatchResult, type RouteNode, RouteTree, resolveMagicPrefix, segmentMatchesUrlPart, } from "./route-tree";
-export { RouterService } from "./router.service";
-export { discoverRoutes, generateRouteManifest, globToTree, } from "./scanner";
-export { collectApiMiddlewares, collectAuthRequirements, collectMiddlewares, } from "./utils";
+export { ROUTER_SERVICE, SITE_LAYOUT } from "../common/tokens.js";
+export { addRouteRewrite, buildRouteTree, getModulesWithHomepage, getPluginsWithHomepage, getRouteRewrites, matchRoute, } from "./discovery.js";
+export { handleVeapApiRequest } from "./handler.js";
+export { matchRoute as matchVirtualRoute } from "./matcher.js";
+export { ApiEnsuredAuth, ApiSameOrigin, EnsuredAuth, EnsuredGuest, EnsuredUser, runApiPipeline, runPipeline, SameOrigin, SkipSecurity, } from "./middlewares.js";
+export { RouterErrorBoundary, SoftNavigationInterceptor, VeapRouter, type WithRouterConfig, withRouter, } from "./react/index.js";
+export { extractParamName, isCatchAllSegment, isDynamicSegment, isGroupSegment, isOptionalCatchAllSegment, isParallelSlot, type LayoutChainEntry, type MatchResult, type RouteNode, RouteTree, resolveMagicPrefix, segmentMatchesUrlPart, } from "./route-tree.js";
+export { RouterService } from "./router.service.js";
+export { discoverRoutes, generateRouteManifest, globToTree, } from "./scanner.js";
+export { collectApiMiddlewares, collectAuthRequirements, collectMiddlewares, } from "./utils.js";

package/dist/router/index.js

@@ -2,12 +2,13 @@
  * @module router
  * @description Virtual Router API for Veap Plugin system.
  */
-export { addRouteRewrite, buildRouteTree, getModulesWithHomepage, getPluginsWithHomepage, getRouteRewrites, matchRoute, } from "./discovery";
-export { handleVeapApiRequest } from "./handler";
-export { matchRoute as matchVirtualRoute } from "./matcher";
-export { ApiEnsuredAuth, ApiSameOrigin, EnsuredAuth, EnsuredGuest, EnsuredUser, runApiPipeline, runPipeline, SameOrigin, SkipSecurity, } from "./middlewares";
-export { RouterErrorBoundary, SoftNavigationInterceptor, VeapRouter, withRouter, } from "./react";
-export { extractParamName, isCatchAllSegment, isDynamicSegment, isGroupSegment, isOptionalCatchAllSegment, isParallelSlot, RouteTree, resolveMagicPrefix, segmentMatchesUrlPart, } from "./route-tree";
-export { RouterService } from "./router.service";
-export { discoverRoutes, generateRouteManifest, globToTree, } from "./scanner";
-export { collectApiMiddlewares, collectAuthRequirements, collectMiddlewares, } from "./utils";
+export { ROUTER_SERVICE, SITE_LAYOUT } from "../common/tokens.js";
+export { addRouteRewrite, buildRouteTree, getModulesWithHomepage, getPluginsWithHomepage, getRouteRewrites, matchRoute, } from "./discovery.js";
+export { handleVeapApiRequest } from "./handler.js";
+export { matchRoute as matchVirtualRoute } from "./matcher.js";
+export { ApiEnsuredAuth, ApiSameOrigin, EnsuredAuth, EnsuredGuest, EnsuredUser, runApiPipeline, runPipeline, SameOrigin, SkipSecurity, } from "./middlewares.js";
+export { RouterErrorBoundary, SoftNavigationInterceptor, VeapRouter, withRouter, } from "./react/index.js";
+export { extractParamName, isCatchAllSegment, isDynamicSegment, isGroupSegment, isOptionalCatchAllSegment, isParallelSlot, RouteTree, resolveMagicPrefix, segmentMatchesUrlPart, } from "./route-tree.js";
+export { RouterService } from "./router.service.js";
+export { discoverRoutes, generateRouteManifest, globToTree, } from "./scanner.js";
+export { collectApiMiddlewares, collectAuthRequirements, collectMiddlewares, } from "./utils.js";

package/dist/router/middlewares.js

@@ -1,16 +1,14 @@
 import { checkSecurity, getAuthRoutes, getCurrentSession } from "@veap/auth";
-import { AppError, verifySameOrigin } from "@veap/kernel";
-import { headers } from "next/headers";
-import { redirect } from "next/navigation";
+import { AppError, app, REQUEST_CONTEXT, verifySameOrigin, } from "@veap/kernel";
 export const EnsuredGuest = async (ctx, next) => {
     const { user, session } = await getCurrentSession();
     if (user && session) {
-        const headersList = await headers();
-        const referer = headersList.get("referer");
+        const requestContext = await app(REQUEST_CONTEXT);
+        const referer = await requestContext.getHeader("referer");
         if (referer && !referer.includes(ctx.path)) {
-            return redirect(referer);
+            return requestContext.redirect(referer);
         }
-        return redirect("/");
+        return requestContext.redirect("/");
     }
     return await next();
 };
@@ -18,7 +16,8 @@ export const EnsuredUser = async (_ctx, next) => {
     const { user, session } = await getCurrentSession();
     if (!user || !session) {
         const authRoutes = getAuthRoutes();
-        return redirect(authRoutes.signIn);
+        const requestContext = await app(REQUEST_CONTEXT);
+        return requestContext.redirect(authRoutes.signIn);
     }
     return await next();
 };
@@ -38,11 +37,13 @@ export const EnsuredAuth = async (ctx, next) => {
     const { user, session } = await getCurrentSession();
     const authRoutes = getAuthRoutes();
     if (!user || !session) {
-        return redirect(authRoutes.signIn);
+        const requestContext = await app(REQUEST_CONTEXT);
+        return requestContext.redirect(authRoutes.signIn);
     }
     const security = await checkSecurity(session, user, ctx.roles, ctx.permissions, undefined, ctx.path);
     if (!security.satisfied) {
-        return redirect(security.redirect || authRoutes.signIn);
+        const requestContext = await app(REQUEST_CONTEXT);
+        return requestContext.redirect(security.redirect || authRoutes.signIn);
     }
     return await next();
 };
@@ -71,12 +72,27 @@ export const ApiEnsuredAuth = async (_request, context, next) => {
  * Throws AppError.Forbidden if request originates from an untrusted origin.
  */
 export const SameOrigin = async (_ctx, next) => {
-    const headersList = await headers();
-    const origin = headersList.get("origin");
-    const secFetchSite = headersList.get("sec-fetch-site");
-    const secFetchMode = headersList.get("sec-fetch-mode");
+    const requestContext = await app(REQUEST_CONTEXT);
+    const origin = await requestContext.getHeader("origin");
+    const secFetchSite = await requestContext.getHeader("sec-fetch-site");
+    const secFetchMode = await requestContext.getHeader("sec-fetch-mode");
     if (origin || (secFetchSite && secFetchMode !== "navigate")) {
-        if (!verifySameOrigin({ headers: headersList, method: "POST" })) {
+        const host = await requestContext.getHeader("host");
+        const xForwardedHost = await requestContext.getHeader("x-forwarded-host");
+        const headersMap = new Map([
+            ["origin", origin],
+            ["sec-fetch-site", secFetchSite],
+            ["sec-fetch-mode", secFetchMode],
+            ["host", host],
+            ["x-forwarded-host", xForwardedHost],
+        ]);
+        const requestLike = {
+            headers: {
+                get: (name) => headersMap.get(name.toLowerCase()) ?? null,
+            },
+            method: "POST",
+        };
+        if (!verifySameOrigin(requestLike)) {
             throw AppError.Forbidden("Cross-origin request rejected");
         }
     }

package/dist/router/react/soft-navigation.d.ts

@@ -1,4 +1,6 @@
 import * as React from "react";
-export declare function SoftNavigationInterceptor({ children, }: {
+export interface SoftNavigationInterceptorProps {
     children: React.ReactNode;
-}): React.JSX.Element;
+    onNavigate?: (href: string) => void;
+}
+export declare function SoftNavigationInterceptor({ children, onNavigate, }: SoftNavigationInterceptorProps): React.JSX.Element;

package/dist/router/react/soft-navigation.js

@@ -1,9 +1,7 @@
 "use client";
 import { Fragment as _Fragment, jsx as _jsx } from "react/jsx-runtime";
-import { useRouter } from "next/navigation";
 import * as React from "react";
-export function SoftNavigationInterceptor({ children, }) {
-    const router = useRouter();
+export function SoftNavigationInterceptor({ children, onNavigate, }) {
     React.useEffect(() => {
         const handleClick = (e) => {
             // Ignore clicks with modifiers
@@ -22,13 +20,22 @@ export function SoftNavigationInterceptor({ children, }) {
             // Only intercept internal links
             if (href?.startsWith("/") &&
                 !href.startsWith("//") &&
-                anchor.target !== "_blank") {
-                e.preventDefault();
-                router.push(href);
+                anchor.target !== "_blank" &&
+                !anchor.hasAttribute("download") &&
+                anchor.getAttribute("rel") !== "external") {
+                if (onNavigate) {
+                    e.preventDefault();
+                    onNavigate(href);
+                }
+                else if (typeof window !== "undefined") {
+                    e.preventDefault();
+                    window.history.pushState(null, "", href);
+                    window.dispatchEvent(new PopStateEvent("popstate"));
+                }
             }
         };
         document.addEventListener("click", handleClick);
         return () => document.removeEventListener("click", handleClick);
-    }, [router]);
+    }, [onNavigate]);
     return _jsx(_Fragment, { children: children });
 }

package/dist/router/react/with-router.js

@@ -1,5 +1,5 @@
 import { jsx as _jsx } from "react/jsx-runtime";
-import { headers } from "next/headers";
+import { app, REQUEST_CONTEXT } from "@veap/kernel";
 import { buildRouteTree } from "../discovery";
 import { VeapRouter } from "./renderer";
 export function withRouter(Component, configOrPath) {
@@ -10,8 +10,13 @@ export function withRouter(Component, configOrPath) {
             : configOrPath || {};
         let routePath = config.path;
         if (!routePath) {
-            const headersList = await headers();
-            routePath = headersList.get("x-invoke-path") || "/";
+            try {
+                const requestContext = await app(REQUEST_CONTEXT);
+                routePath = (await requestContext.getHeader("x-invoke-path")) || "/";
+            }
+            catch (_e) {
+                routePath = "/";
+            }
         }
         const tree = await buildRouteTree(true);
         return (_jsx(VeapRouter, { tree: tree, path: routePath || "/", searchParams: searchParams, CustomPageComponent: Component, customConfig: config }));

package/dist/router/route-tree.d.ts

@@ -24,7 +24,33 @@
  * ```
  */
 import type { UserPermission, UserRole } from "@veap/auth";
-import type { Metadata } from "next";
+/**
+ * Framework-agnostic metadata shape for route nodes.
+ * Compatible with Next.js Metadata and standard HTML meta tags.
+ */
+export interface VeapMetadata {
+    title?: string | {
+        default: string;
+        template?: string;
+        absolute?: string;
+    };
+    description?: string;
+    keywords?: string | string[];
+    authors?: Array<{
+        name?: string;
+        url?: string;
+    }>;
+    creator?: string;
+    publisher?: string;
+    robots?: any;
+    icons?: any;
+    openGraph?: any;
+    twitter?: any;
+    alternates?: any;
+    other?: Record<string, string | number | (string | number)[]>;
+    [key: string]: any;
+}
+export type Metadata = VeapMetadata;
 import type * as React from "react";
 import type { ApiMiddleware, BreadcrumbValue, VeapMiddleware } from "../common/types";
 /**

package/dist/router/route-tree.js

@@ -186,7 +186,10 @@ function matchRecursive(node, remainingSegments, currentParams, currentChain, cu
             !isOptionalCatchAllSegment(child.segment) &&
             child.segment === currentSegment) {
             const nextChain = hasLayoutChainContent(child)
-                ? [...currentChain, buildChainEntry(child, [...currentMatched, currentSegment])]
+                ? [
+                    ...currentChain,
+                    buildChainEntry(child, [...currentMatched, currentSegment]),
+                ]
                 : currentChain;
             const result = matchRecursive(child, rest, currentParams, nextChain, [...currentMatched, currentSegment], bestPartialMatch);
             if (result)
@@ -205,7 +208,10 @@ function matchRecursive(node, remainingSegments, currentParams, currentChain, cu
         if (isDynamicSegment(child.segment)) {
             const paramName = extractParamName(child.segment);
             const nextChain = hasLayoutChainContent(child)
-                ? [...currentChain, buildChainEntry(child, [...currentMatched, currentSegment])]
+                ? [
+                    ...currentChain,
+                    buildChainEntry(child, [...currentMatched, currentSegment]),
+                ]
                 : currentChain;
             const result = matchRecursive(child, rest, { ...currentParams, [paramName]: currentSegment }, nextChain, [...currentMatched, currentSegment], bestPartialMatch);
             if (result)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@veap/plugins",
-  "version": "0.1.0",
+  "version": "0.1.3",
   "description": "Plugin lifecycle, extension points, and virtual router for Veap",
   "bugs": "https://github.com/veapjs/veap-plugins/issues",
   "repository": {
@@ -56,10 +56,10 @@
     "@dnd-kit/core": "^6.3.1",
     "@dnd-kit/sortable": "^10.0.0",
     "@dnd-kit/utilities": "^3.2.2",
-    "@veap/auth": "0.1.0",
-    "@veap/database": "0.1.0",
-    "@veap/intl": "0.1.0",
-    "@veap/kernel": "0.1.0",
+    "@veap/auth": "0.1.1",
+    "@veap/database": "0.1.1",
+    "@veap/intl": "0.1.2",
+    "@veap/kernel": "0.1.2",
     "chalk": "^5.3.0",
     "ora": "^8.1.1",
     "zod": "^4.6.5"
@@ -68,7 +68,6 @@
     "@iconify/react": "^6.0.2",
     "@veap/ui": "^0.1.0",
     "lucide-react": "^1.55.0",
-    "next": "^16",
     "react": "^19",
     "react-dom": "^19",
     "sonner": "^2.0.8"
@@ -83,9 +82,6 @@
     "lucide-react": {
       "optional": true
     },
-    "next": {
-      "optional": true
-    },
     "react": {
       "optional": true
     },