@veap/plugins 0.1.0 → 0.1.1

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/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.1",
   "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.1",
+    "@veap/kernel": "0.1.1",
     "chalk": "^5.3.0",
     "ora": "^8.1.1",
     "zod": "^4.6.5"