@dudousxd/nestjs-durable-dashboard 0.44.0 → 0.45.0

package/dist/server/index.d.cts

@@ -239,7 +239,14 @@ declare class RunQueryDraft {
     facetQuery(): RunFacetQuery;
 }
 
-/** JSON API consumed by the control-plane SPA. Mounted at `apiBasePath` (set by RouterModule). */
+/**
+ * JSON API consumed by the control-plane SPA. Mounted at `apiBasePath` (set by RouterModule).
+ *
+ * The filter interceptor (what resolves `@ApplyFilter` into a query) is bound HERE rather than as
+ * the app-wide `APP_INTERCEPTOR` that `FilterModule.forRoot()` registers: a library must not add a
+ * global interceptor to its host, and on an app that already has one this would be the second copy,
+ * running every filter in the app twice.
+ */
 declare class DurableApiController {
     private readonly dashboard;
     private readonly runner;
@@ -448,24 +455,6 @@ interface DurableDashboardOptions {
      * (e.g. an `EntityManager` to look up an admin user).
      */
     dashboardAuth?: DashboardAuthOptions;
-    /**
-     * Who registers `@dudousxd/nestjs-filter`'s core — the console's run filters are written with it.
-     *
-     * - `'bootstrap'` (default): this module calls `FilterModule.forRoot()` itself, so the console
-     *   works in an app that has never heard of the filter library.
-     * - `'host'`: your app already calls `FilterModule.forRoot(...)`; this module registers only its
-     *   own filter and adapter.
-     *
-     * It has to be YOUR call rather than something detected, because `forRoot` is a GLOBAL
-     * registration: called twice, the second one's module options (validation policy, input format,
-     * page-size ceiling) shadow the first's, and the app-wide interceptor is registered twice. There
-     * is no moment at module-definition time when this module could see whether you have called it.
-     *
-     * Only the core is shared. The console's adapter never is: `RunFilter` names its own via
-     * `@Filterable({ adapter })`, so your global adapter (your ORM's) keeps answering for your filters
-     * and the run gateway answers for the console's, in the same process.
-     */
-    filterModule?: 'bootstrap' | 'host';
 }
 /**
  * Async variant of {@link DurableDashboardOptions}. The mount paths and `guards` stay static (the
@@ -480,8 +469,6 @@ interface DurableDashboardAsyncOptions {
     apiBasePath?: string;
     guards?: Type<CanActivate>[];
     imports?: DynamicModule['imports'];
-    /** See {@link DurableDashboardOptions.filterModule}. */
-    filterModule?: 'bootstrap' | 'host';
     /** Providers injected into `useDashboardAuth`, in order. Shared with a `guards` class's own deps. */
     inject?: Array<InjectionToken | OptionalFactoryDependency>;
     /** Build the `dashboardAuth` config from injected deps (or `undefined` to leave the console open). */
@@ -505,8 +492,6 @@ declare class DurableApiModule {
          *  (true whenever `dashboardAuth` was set, or unconditionally for `forRootAsync`, where it's
          *  resolved at runtime and is a no-op if it ends up unconfigured). */
         authMayBeConfigured: boolean;
-        /** See {@link DurableDashboardOptions.filterModule}. */
-        filterModule?: 'bootstrap' | 'host';
     }): DynamicModule;
 }
 /**

package/dist/server/index.d.ts

@@ -239,7 +239,14 @@ declare class RunQueryDraft {
     facetQuery(): RunFacetQuery;
 }
 
-/** JSON API consumed by the control-plane SPA. Mounted at `apiBasePath` (set by RouterModule). */
+/**
+ * JSON API consumed by the control-plane SPA. Mounted at `apiBasePath` (set by RouterModule).
+ *
+ * The filter interceptor (what resolves `@ApplyFilter` into a query) is bound HERE rather than as
+ * the app-wide `APP_INTERCEPTOR` that `FilterModule.forRoot()` registers: a library must not add a
+ * global interceptor to its host, and on an app that already has one this would be the second copy,
+ * running every filter in the app twice.
+ */
 declare class DurableApiController {
     private readonly dashboard;
     private readonly runner;
@@ -448,24 +455,6 @@ interface DurableDashboardOptions {
      * (e.g. an `EntityManager` to look up an admin user).
      */
     dashboardAuth?: DashboardAuthOptions;
-    /**
-     * Who registers `@dudousxd/nestjs-filter`'s core — the console's run filters are written with it.
-     *
-     * - `'bootstrap'` (default): this module calls `FilterModule.forRoot()` itself, so the console
-     *   works in an app that has never heard of the filter library.
-     * - `'host'`: your app already calls `FilterModule.forRoot(...)`; this module registers only its
-     *   own filter and adapter.
-     *
-     * It has to be YOUR call rather than something detected, because `forRoot` is a GLOBAL
-     * registration: called twice, the second one's module options (validation policy, input format,
-     * page-size ceiling) shadow the first's, and the app-wide interceptor is registered twice. There
-     * is no moment at module-definition time when this module could see whether you have called it.
-     *
-     * Only the core is shared. The console's adapter never is: `RunFilter` names its own via
-     * `@Filterable({ adapter })`, so your global adapter (your ORM's) keeps answering for your filters
-     * and the run gateway answers for the console's, in the same process.
-     */
-    filterModule?: 'bootstrap' | 'host';
 }
 /**
  * Async variant of {@link DurableDashboardOptions}. The mount paths and `guards` stay static (the
@@ -480,8 +469,6 @@ interface DurableDashboardAsyncOptions {
     apiBasePath?: string;
     guards?: Type<CanActivate>[];
     imports?: DynamicModule['imports'];
-    /** See {@link DurableDashboardOptions.filterModule}. */
-    filterModule?: 'bootstrap' | 'host';
     /** Providers injected into `useDashboardAuth`, in order. Shared with a `guards` class's own deps. */
     inject?: Array<InjectionToken | OptionalFactoryDependency>;
     /** Build the `dashboardAuth` config from injected deps (or `undefined` to leave the console open). */
@@ -505,8 +492,6 @@ declare class DurableApiModule {
          *  (true whenever `dashboardAuth` was set, or unconditionally for `forRootAsync`, where it's
          *  resolved at runtime and is a no-op if it ends up unconfigured). */
         authMayBeConfigured: boolean;
-        /** See {@link DurableDashboardOptions.filterModule}. */
-        filterModule?: 'bootstrap' | 'host';
     }): DynamicModule;
 }
 /**

package/dist/server/index.js

@@ -220,8 +220,8 @@ DashboardService = _ts_decorate([
 ], DashboardService);
 
 // src/server/durable-api.controller.ts
-import { ApplyFilter, FilterRunner } from "@dudousxd/nestjs-filter";
-import { Body, Controller, Get, Header, NotFoundException, Param, Post, Query, Sse } from "@nestjs/common";
+import { ApplyFilter, ApplyFilterInterceptor, FilterRunner } from "@dudousxd/nestjs-filter";
+import { Body, Controller, Get, Header, NotFoundException, Param, Post, Query, Sse, UseInterceptors } from "@nestjs/common";
 
 // src/server/durable-run.ts
 var DurableRun = class {
@@ -1190,6 +1190,7 @@ _ts_decorate4([
 ], DurableApiController.prototype, "update", null);
 DurableApiController = _ts_decorate4([
   Controller(),
+  UseInterceptors(ApplyFilterInterceptor),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof DashboardService === "undefined" ? Object : DashboardService,
@@ -2138,9 +2139,9 @@ DurableAuthController = _ts_decorate8([
 
 // src/server/durable-dashboard.module.ts
 import "reflect-metadata";
-import { FilterModule } from "@dudousxd/nestjs-filter";
+import { ApplyFilterInterceptor as ApplyFilterInterceptor2, FilterRunner as FilterRunner2 } from "@dudousxd/nestjs-filter";
 import { Module } from "@nestjs/common";
-import { RouterModule } from "@nestjs/core";
+import { ModuleRef, RouterModule } from "@nestjs/core";
 
 // src/server/durable-session.guard.ts
 import { Inject as Inject5, Injectable as Injectable4, UnauthorizedException as UnauthorizedException2 } from "@nestjs/common";
@@ -2286,25 +2287,38 @@ var DurableApiModule = class _DurableApiModule {
     return {
       module: _DurableApiModule,
       imports: [
-        ...options.imports ?? [],
-        // `validation: 'off'`: the run filter's inputs are validated by its own translation — every
-        // field/operator pair either maps onto a `RunQuery` predicate or is rejected by name — so
-        // there is nothing left for class-validator to check, and requiring it would put a peer
-        // dependency on every consumer of this dashboard for no gain.
-        ...options.filterModule === "host" ? [] : [
-          FilterModule.forRoot({
-            validation: "off"
-          })
-        ]
+        ...options.imports ?? []
       ],
       controllers: [
         DurableApiController
       ],
       providers: [
         DashboardService,
-        // The adapter is bound to its own token (never to the global `FILTER_ADAPTER`), which is
-        // what lets the console's filter and the host app's own filters run on different backends
-        // in one process — see `RunFilter`'s `@Filterable({ adapter })`.
+        // `@dudousxd/nestjs-filter` is wired PRIVATELY here rather than through
+        // `FilterModule.forRoot()`, which is a global registration. A library calling that would
+        // fight the host app over one set of module options and register a second app-wide
+        // interceptor — and it cannot tell at module-definition time whether the host already
+        // called it. Everything below is scoped to this module, so the console composes with an app
+        // that uses the filter library, and with one that has never heard of it, identically.
+        //
+        // `validation: 'off'`: the run filter's inputs are validated by their own translation —
+        // every field/operator pair either maps onto a `RunQuery` predicate or is rejected by
+        // name — so there is nothing left for class-validator to check, and requiring it would put
+        // a peer dependency on every consumer of this dashboard for no gain.
+        //
+        // The `null` adapter is the GLOBAL one, deliberately absent: `RunFilter` names its own via
+        // `@Filterable({ adapter })`, so the console runs on the durable run gateway while the host
+        // app's filters keep running on whatever adapter it registered.
+        {
+          provide: FilterRunner2,
+          useFactory: /* @__PURE__ */ __name((moduleRef) => new FilterRunner2(moduleRef, {
+            validation: "off"
+          }, null), "useFactory"),
+          inject: [
+            ModuleRef
+          ]
+        },
+        ApplyFilterInterceptor2,
         RunQueryAdapter,
         {
           provide: RUN_QUERY_ADAPTER,
@@ -2362,9 +2376,6 @@ var DurableDashboardModule = class _DurableDashboardModule {
           ...options.guards ? {
             guards: options.guards
           } : {},
-          ...options.filterModule ? {
-            filterModule: options.filterModule
-          } : {},
           authProvider,
           authMayBeConfigured
         }),