@hanivanrizky/nestjs-browser-action 0.20.1 → 0.22.0

package/README.md

@@ -10,7 +10,7 @@
   <a href="https://www.npmjs.com/package/@hanivanrizky/nestjs-browser-action" target="_blank"><img src="https://img.shields.io/npm/v/@hanivanrizky/nestjs-browser-action.svg" alt="NPM Version" /></a>
   <a href="https://www.npmjs.com/package/@hanivanrizky/nestjs-browser-action" target="_blank"><img src="https://img.shields.io/npm/l/@hanivanrizky/nestjs-browser-action.svg" alt="Package License" /></a>
   <a href="https://www.npmjs.com/package/@hanivanrizky/nestjs-browser-action" target="_blank"><img src="https://img.shields.io/npm/dm/@hanivanrizky/nestjs-browser-action.svg" alt="NPM Downloads" /></a>
-  <img src="https://img.shields.io/badge/tests-409%20passed-brightgreen.svg" alt="Tests: 409 passed" />
+  <img src="https://img.shields.io/badge/tests-463%20passed-brightgreen.svg" alt="Tests: 463 passed" />
 </p>
 
 > **⚠️ Status: Experimental** — personal use only; API subject to change.
@@ -39,7 +39,8 @@
 - **(.\_.) Remote Chrome**: Connect to remote Chrome instances via CDP (browserURL / browserWSEndpoint)
 - **(>\_<) TLS Fingerprint**: Capture the browser's own TLS/HTTP handshake (ja3/ja4, ciphers, http2 akamai, headers) for use with `nestjs-xpath-parser`'s CycleTLS engine
 - **(☆^O^☆) TypeScript Generics**: Full generic type support for type-safe results
-- **(o_o) Fully Tested**: 409 tests across 39 suites
+- **(o_o) Fully Tested**: 463 tests across 51 suites
+- **(☆^O^☆) Named Browsers & Pages (v0.22+)**: persistent named browser/page pairs with `PageController` — cookies/state carry over across calls, no open/close per scrape
 
 ## Installation
 
@@ -53,21 +54,7 @@ npm install @hanivanrizky/nestjs-browser-action
 
 ## Quick Start
 
-### Import the Module
-
-**Basic usage:**
-
-```typescript
-import { Module } from '@nestjs/common';
-import { BrowserActionModule } from '@hanivanrizky/nestjs-browser-action';
-
-@Module({
-  imports: [BrowserActionModule.forRoot()],
-})
-export class AppModule {}
-```
-
-**With pool and cookie options:**
+### Register a Named Browser + Pages
 
 ```typescript
 import { Module } from '@nestjs/common';
@@ -75,17 +62,14 @@ import { BrowserActionModule } from '@hanivanrizky/nestjs-browser-action';
 
 @Module({
   imports: [
-    BrowserActionModule.forRoot({
-      pool: { min: 2, max: 10 },
-      cookies: { enabled: true, cookiesDir: './cookies' },
-      logLevel: 'log',
-    }),
+    BrowserActionModule.forRoot({ name: 'stealth', cloak: { headless: true } }),
+    BrowserActionModule.forFeature(['products'], 'stealth'),
   ],
 })
 export class AppModule {}
 ```
 
-**Async configuration:**
+**With cookies and async config:**
 
 ```typescript
 import { Module } from '@nestjs/common';
@@ -96,36 +80,41 @@ import { ConfigModule, ConfigService } from '@nestjs/config';
   imports: [
     ConfigModule.forRoot(),
     BrowserActionModule.forRootAsync({
+      name: 'stealth',
       imports: [ConfigModule],
       useFactory: (configService: ConfigService) => ({
-        pool: {
-          min: configService.get<number>('POOL_MIN', 2),
-          max: configService.get<number>('POOL_MAX', 10),
-        },
         cloak: {
           proxy: { server: configService.get<string>('PROXY_URL', '') },
         },
+        cookies: { enabled: true, cookiesDir: './cookies' },
         logLevel: configService.get<string>('LOG_LEVEL', 'log'),
       }),
       inject: [ConfigService],
     }),
+    BrowserActionModule.forFeature(['products'], 'stealth'),
   ],
 })
 export class AppModule {}
 ```
 
-### Inject the Service
+### Inject the Page Controller
 
 ```typescript
 import { Injectable } from '@nestjs/common';
-import { BrowserActionService } from '@hanivanrizky/nestjs-browser-action';
+import {
+  InjectPageController,
+  PageController,
+} from '@hanivanrizky/nestjs-browser-action';
 
 @Injectable()
 export class YourService {
-  constructor(private readonly browserAction: BrowserActionService) {}
+  constructor(
+    @InjectPageController('products', 'stealth')
+    private readonly products: PageController,
+  ) {}
 
   async scrapeProducts() {
-    const result = await this.browserAction.evaluateWebsite({
+    const result = await this.products.evaluateWebsite({
       url: 'https://www.scrapingcourse.com/ecommerce/',
       patterns: [
         {
@@ -157,6 +146,49 @@ export class YourService {
 }
 ```
 
+> Pool mode (`forRoot()`/`forRootAsync()` without `name`, plain
+> `BrowserActionService`) still works but is deprecated — see
+> [Named Browsers & Pages (v0.22+)](#named-browsers--pages-v022) for full
+> details, decorators, and the pool → controller migration table.
+
+## Named Browsers & Pages (v0.22+)
+
+Persistent, named browser + page pairs — an alternative to pool mode for
+workloads that want cookies/localStorage/navigation state to carry over
+between calls (login sessions, authenticated crawls) instead of a fresh
+page opened and closed per scrape. Full details, decorators, auto-recreate
+semantics, and a pool → controller migration table live in
+[Named Browsers & Pages](docs/features/named-browsers.md).
+
+```typescript
+import { Module, Injectable } from '@nestjs/common';
+import {
+  BrowserActionModule,
+  InjectPageController,
+  PageController,
+} from '@hanivanrizky/nestjs-browser-action';
+
+@Module({
+  imports: [
+    BrowserActionModule.forRoot({ name: 'stealth', cloak: { headless: true } }),
+    BrowserActionModule.forFeature(['login', 'search'], 'stealth'),
+  ],
+})
+export class AppModule {}
+
+@Injectable()
+export class MyService {
+  constructor(
+    @InjectPageController('login', 'stealth')
+    private readonly login: PageController,
+  ) {}
+
+  async run() {
+    return this.login.scrape('https://example.com', { title: 'h1' });
+  }
+}
+```
+
 ## Documentation
 
 ### Features
@@ -166,6 +198,7 @@ export class YourService {
 - [Data Cleaning Pipes](docs/features/pipes.md) - Transform extracted data with pipes
 - [Cookie Management](docs/features/cookies.md) - Session persistence
 - [Workflow Actions](docs/methods/workflow.md) - Declarative step-by-step automation
+- [Named Browsers & Pages](docs/features/named-browsers.md) - Persistent named browser/page pairs with `PageController`
 
 ### Reference
 
@@ -331,6 +364,14 @@ pnpm format
 4. Push to the branch (`git push origin feature/yourusername/amazing-feature`)
 5. Open a Pull Request
 
+## Acknowledgments
+
+The [Named Browsers & Pages](#named-browsers--pages-v022) DI pattern
+(`forRoot({ name })` + `forFeature(pages, name)` +
+`@InjectBrowser`/`@InjectPage`/`@InjectPageController`) was inspired by
+[oblakstudio/nestjs-puppeteer](https://github.com/oblakstudio/nestjs-puppeteer).
+Thanks to the maintainers for the clean named-instance design.
+
 ## License
 
 This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

package/dist/browser-action.module-definition.d.ts

@@ -4,4 +4,5 @@ export type BrowserActionModuleOptions = BrowserActionOptions;
 export interface BrowserActionAsyncModuleOptions extends Pick<ModuleMetadata, 'imports'> {
     useFactory: (...args: unknown[]) => Promise<BrowserActionModuleOptions> | BrowserActionModuleOptions;
     inject?: Array<Type | string | symbol>;
+    name?: string;
 }

package/dist/browser-action.module.d.ts

@@ -3,6 +3,9 @@ import { BrowserActionModuleOptions, BrowserActionAsyncModuleOptions } from './b
 export declare class BrowserActionModule {
     static register(options: BrowserActionModuleOptions): DynamicModule;
     static forRoot(options: BrowserActionModuleOptions): DynamicModule;
+    private static forNamedBrowser;
     static forRootAsync(options: BrowserActionAsyncModuleOptions): DynamicModule;
+    private static forNamedBrowserAsync;
+    static forFeature(pages: string[], browserName?: string): DynamicModule;
     onModuleDestroy(): Promise<void>;
 }

package/dist/browser-action.module.js

@@ -15,7 +15,48 @@ const page_service_1 = require("./services/page.service");
 const browser_action_service_1 = require("./services/browser-action.service");
 const cookie_service_1 = require("./services/cookie.service");
 const cleansing_service_1 = require("./services/cleansing.service");
+const named_browser_shutdown_1 = require("./services/named-browser-shutdown");
+const browser_holder_1 = require("./services/browser-holder");
 const constants_1 = require("./constants");
+const tokens_1 = require("./common/tokens");
+const browser_launcher_1 = require("./utils/browser-launcher");
+const logger_util_1 = require("./utils/logger.util");
+const pipe_engine_1 = require("./pipes/pipe-engine");
+const operators_1 = require("./operators");
+const page_session_1 = require("./services/page-session");
+const page_controller_1 = require("./services/page-controller");
+const browser_action_constants_1 = require("./constants/browser-action.constants");
+const POOL_MODE_SERVICES = [
+    browser_pool_service_1.BrowserPoolService,
+    browser_manager_service_1.BrowserManagerService,
+    page_service_1.PageService,
+    browser_action_service_1.BrowserActionService,
+    cookie_service_1.CookieService,
+    cleansing_service_1.CleansingService,
+];
+const POOL_MODE_EXPORTS = [
+    browser_manager_service_1.BrowserManagerService,
+    page_service_1.PageService,
+    browser_action_service_1.BrowserActionService,
+    cookie_service_1.CookieService,
+    cleansing_service_1.CleansingService,
+];
+function resolveLogLevel(logLevel) {
+    return (Array.isArray(logLevel) ? logLevel[0] : logLevel) || 'log';
+}
+async function launchNamedBrowser(options) {
+    const logger = new logger_util_1.LoggerWithLevel('BrowserActionModule', resolveLogLevel(options.logLevel));
+    return options.remote
+        ? await (0, browser_launcher_1.connectRemoteBrowser)(options.remote, logger)
+        : await (0, browser_launcher_1.launchLocalBrowser)(options, undefined, logger);
+}
+function namedBrowserHolderProvider(name) {
+    return {
+        provide: (0, tokens_1.getBrowserHolderToken)(name),
+        useFactory: (browser) => new browser_holder_1.BrowserHolder(browser),
+        inject: [(0, tokens_1.getBrowserToken)(name)],
+    };
+}
 let BrowserActionModule = BrowserActionModule_1 = class BrowserActionModule {
     static register(options) {
         const optionsProvider = {
@@ -29,31 +70,52 @@ let BrowserActionModule = BrowserActionModule_1 = class BrowserActionModule {
         };
     }
     static forRoot(options) {
+        if (options.name)
+            return this.forNamedBrowser(options);
         const optionsProvider = {
             provide: constants_1.BROWSER_ACTION_OPTIONS,
             useValue: options,
         };
         return {
             module: BrowserActionModule_1,
+            providers: [optionsProvider, ...POOL_MODE_SERVICES],
+            exports: [...POOL_MODE_EXPORTS],
+        };
+    }
+    static forNamedBrowser(options) {
+        const name = options.name;
+        (0, tokens_1.claimBrowserName)(name);
+        if (options.remote)
+            (0, browser_launcher_1.validateRemoteOptions)(options.remote);
+        const optionsProvider = {
+            provide: (0, tokens_1.getNamedOptionsToken)(name),
+            useValue: options,
+        };
+        const browserProvider = {
+            provide: (0, tokens_1.getBrowserToken)(name),
+            useFactory: () => launchNamedBrowser(options),
+        };
+        const holderProvider = namedBrowserHolderProvider(name);
+        const shutdownProvider = {
+            provide: `${(0, tokens_1.getBrowserToken)(name)}Shutdown`,
+            useFactory: (holder) => new named_browser_shutdown_1.NamedBrowserShutdown(name, holder, !!options.remote),
+            inject: [(0, tokens_1.getBrowserHolderToken)(name)],
+        };
+        return {
+            module: BrowserActionModule_1,
+            global: true,
             providers: [
                 optionsProvider,
-                browser_pool_service_1.BrowserPoolService,
-                browser_manager_service_1.BrowserManagerService,
-                page_service_1.PageService,
-                browser_action_service_1.BrowserActionService,
-                cookie_service_1.CookieService,
-                cleansing_service_1.CleansingService,
-            ],
-            exports: [
-                browser_manager_service_1.BrowserManagerService,
-                page_service_1.PageService,
-                browser_action_service_1.BrowserActionService,
-                cookie_service_1.CookieService,
-                cleansing_service_1.CleansingService,
+                browserProvider,
+                holderProvider,
+                shutdownProvider,
             ],
+            exports: [browserProvider, holderProvider, optionsProvider],
         };
     }
     static forRootAsync(options) {
+        if (options.name)
+            return this.forNamedBrowserAsync(options);
         const asyncOptionsProvider = {
             provide: constants_1.BROWSER_ACTION_OPTIONS,
             useFactory: async (...args) => {
@@ -64,24 +126,81 @@ let BrowserActionModule = BrowserActionModule_1 = class BrowserActionModule {
         return {
             module: BrowserActionModule_1,
             imports: options.imports || [],
+            providers: [asyncOptionsProvider, ...POOL_MODE_SERVICES],
+            exports: [...POOL_MODE_EXPORTS],
+        };
+    }
+    static forNamedBrowserAsync(options) {
+        const name = options.name;
+        (0, tokens_1.claimBrowserName)(name);
+        const optionsToken = (0, tokens_1.getNamedOptionsToken)(name);
+        const optionsProvider = {
+            provide: optionsToken,
+            useFactory: async (...args) => {
+                const resolved = await options.useFactory(...args);
+                if (resolved.remote)
+                    (0, browser_launcher_1.validateRemoteOptions)(resolved.remote);
+                return resolved;
+            },
+            inject: options.inject || [],
+        };
+        const browserProvider = {
+            provide: (0, tokens_1.getBrowserToken)(name),
+            useFactory: (resolved) => launchNamedBrowser(resolved),
+            inject: [optionsToken],
+        };
+        const holderProvider = namedBrowserHolderProvider(name);
+        const shutdownProvider = {
+            provide: `${(0, tokens_1.getBrowserToken)(name)}Shutdown`,
+            useFactory: (holder, resolved) => new named_browser_shutdown_1.NamedBrowserShutdown(name, holder, !!resolved.remote),
+            inject: [(0, tokens_1.getBrowserHolderToken)(name), optionsToken],
+        };
+        return {
+            module: BrowserActionModule_1,
+            global: true,
+            imports: options.imports || [],
             providers: [
-                asyncOptionsProvider,
-                browser_pool_service_1.BrowserPoolService,
-                browser_manager_service_1.BrowserManagerService,
-                page_service_1.PageService,
-                browser_action_service_1.BrowserActionService,
-                cookie_service_1.CookieService,
-                cleansing_service_1.CleansingService,
-            ],
-            exports: [
-                browser_manager_service_1.BrowserManagerService,
-                page_service_1.PageService,
-                browser_action_service_1.BrowserActionService,
-                cookie_service_1.CookieService,
-                cleansing_service_1.CleansingService,
+                optionsProvider,
+                browserProvider,
+                holderProvider,
+                shutdownProvider,
             ],
+            exports: [browserProvider, holderProvider, optionsProvider],
         };
     }
+    static forFeature(pages, browserName = 'default') {
+        const providers = pages.flatMap((pageName) => {
+            const pageProvider = {
+                provide: (0, tokens_1.getPageToken)(pageName, browserName),
+                useFactory: async (browser) => await browser.newPage(),
+                inject: [(0, tokens_1.getBrowserToken)(browserName)],
+            };
+            const controllerProvider = {
+                provide: (0, tokens_1.getPageControllerToken)(pageName, browserName),
+                useFactory: (holder, page, options) => {
+                    const debugLen = options.debugLogMaxLength ?? browser_action_constants_1.DEFAULT_DEBUG_LOG_MAX_LENGTH;
+                    const logger = new logger_util_1.LoggerWithLevel(`PageController:${browserName}/${pageName}`, resolveLogLevel(options.logLevel));
+                    const pipeEngine = new pipe_engine_1.PipeEngine();
+                    const extraction = new operators_1.ExtractionOperator(pipeEngine, logger);
+                    const container = new operators_1.ContainerOperator(extraction, pipeEngine, logger);
+                    const cleansingService = new cleansing_service_1.CleansingService(options);
+                    const cookieService = new cookie_service_1.CookieService(options);
+                    const workflow = new operators_1.WorkflowOperator(extraction, container, pipeEngine, cleansingService, logger, () => cookieService);
+                    const pagination = new operators_1.PaginationOperator(logger);
+                    const capture = new operators_1.CaptureOperator(logger);
+                    const session = new page_session_1.PageSession(browserName, holder, page, options, logger);
+                    return new page_controller_1.PageController(session, extraction, container, workflow, pagination, capture, logger, debugLen);
+                },
+                inject: [
+                    (0, tokens_1.getBrowserHolderToken)(browserName),
+                    (0, tokens_1.getPageToken)(pageName, browserName),
+                    (0, tokens_1.getNamedOptionsToken)(browserName),
+                ],
+            };
+            return [pageProvider, controllerProvider];
+        });
+        return { module: BrowserActionModule_1, providers, exports: providers };
+    }
     async onModuleDestroy() {
     }
 };

package/dist/browser-action.module.js.map

@@ -1 +1 @@
-{"version":3,"file":"browser-action.module.js","sourceRoot":"","sources":["../src/browser-action.module.ts"],"names":[],"mappings":";;;;;;;;;;AAAA,2CAAyE;AAKzE,0EAAqE;AACrE,gFAA2E;AAC3E,0DAAsD;AACtD,8EAAyE;AACzE,8DAA0D;AAC1D,oEAAgE;AAChE,2CAAqD;AAI9C,IAAM,mBAAmB,2BAAzB,MAAM,mBAAmB;IAC9B,MAAM,CAAC,QAAQ,CAAC,OAAmC;QACjD,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,kCAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE,CAAC,eAAe,CAAC;YAC5B,OAAO,EAAE,EAAE;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,OAAO,CAAC,OAAmC;QAChD,MAAM,eAAe,GAAa;YAChC,OAAO,EAAE,kCAAsB;YAC/B,QAAQ,EAAE,OAAO;SAClB,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,SAAS,EAAE;gBACT,eAAe;gBACf,yCAAkB;gBAClB,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;SACF,CAAC;IACJ,CAAC;IAED,MAAM,CAAC,YAAY,CAAC,OAAwC;QAC1D,MAAM,oBAAoB,GAAa;YACrC,OAAO,EAAE,kCAAsB;YAC/B,UAAU,EAAE,KAAK,EAAE,GAAG,IAAe,EAAE,EAAE;gBACvC,OAAO,MAAM,OAAO,CAAC,UAAU,CAAC,GAAG,IAAI,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,EAAE;SAC7B,CAAC;QAEF,OAAO;YACL,MAAM,EAAE,qBAAmB;YAC3B,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,EAAE;YAC9B,SAAS,EAAE;gBACT,oBAAoB;gBACpB,yCAAkB;gBAClB,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;YACD,OAAO,EAAE;gBACP,+CAAqB;gBACrB,0BAAW;gBACX,6CAAoB;gBACpB,8BAAa;gBACb,oCAAgB;aACjB;SACF,CAAC;IACJ,CAAC;IAED,KAAK,CAAC,eAAe;IAErB,CAAC;CACF,CAAA;AA3EY,kDAAmB;8BAAnB,mBAAmB;IAF/B,IAAA,eAAM,GAAE;IACR,IAAA,eAAM,EAAC,EAAE,CAAC;GACE,mBAAmB,CA2E/B"}
+{"version":3,"file":"browser-action.module.js","sourceRoot":"","sources":["../src/browser-action.module.ts"],"names":[],"mappings":"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"}

package/dist/common/index.d.ts

@@ -0,0 +1 @@
+export * from './tokens';

package/dist/common/index.js

@@ -0,0 +1,18 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./tokens"), exports);
+//# sourceMappingURL=index.js.map

package/dist/common/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/common/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,2CAAyB"}

package/dist/common/tokens.d.ts

@@ -0,0 +1,7 @@
+export declare function getBrowserToken(name: string): string;
+export declare function getPageToken(page: string, name: string): string;
+export declare function getPageControllerToken(page: string, name: string): string;
+export declare function getBrowserHolderToken(name: string): string;
+export declare function getNamedOptionsToken(name: string): string;
+export declare function claimBrowserName(name: string): void;
+export declare function releaseBrowserName(name: string): void;

package/dist/common/tokens.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBrowserToken = getBrowserToken;
+exports.getPageToken = getPageToken;
+exports.getPageControllerToken = getPageControllerToken;
+exports.getBrowserHolderToken = getBrowserHolderToken;
+exports.getNamedOptionsToken = getNamedOptionsToken;
+exports.claimBrowserName = claimBrowserName;
+exports.releaseBrowserName = releaseBrowserName;
+function getBrowserToken(name) {
+    return `${name}BrowserActionBrowser`;
+}
+function getPageToken(page, name) {
+    return `${name}_${page}BrowserActionPage`;
+}
+function getPageControllerToken(page, name) {
+    return `${name}_${page}BrowserActionPageController`;
+}
+function getBrowserHolderToken(name) {
+    return `${getBrowserToken(name)}Holder`;
+}
+function getNamedOptionsToken(name) {
+    return `BROWSER_ACTION_OPTIONS:${name}`;
+}
+const registeredBrowserNames = new Set();
+function claimBrowserName(name) {
+    if (registeredBrowserNames.has(name)) {
+        throw new Error(`BrowserActionModule: a browser with name "${name}" is already registered. ` +
+            `Each forRoot()/forRootAsync() call must use a unique \`name\`.`);
+    }
+    registeredBrowserNames.add(name);
+}
+function releaseBrowserName(name) {
+    registeredBrowserNames.delete(name);
+}
+//# sourceMappingURL=tokens.js.map

package/dist/common/tokens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tokens.js","sourceRoot":"","sources":["../../src/common/tokens.ts"],"names":[],"mappings":";;AAAA,0CAEC;AAED,oCAEC;AAED,wDAEC;AAED,sDAEC;AAED,oDAEC;AASD,4CAQC;AAED,gDAEC;AAvCD,SAAgB,eAAe,CAAC,IAAY;IAC1C,OAAO,GAAG,IAAI,sBAAsB,CAAC;AACvC,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY,EAAE,IAAY;IACrD,OAAO,GAAG,IAAI,IAAI,IAAI,mBAAmB,CAAC;AAC5C,CAAC;AAED,SAAgB,sBAAsB,CAAC,IAAY,EAAE,IAAY;IAC/D,OAAO,GAAG,IAAI,IAAI,IAAI,6BAA6B,CAAC;AACtD,CAAC;AAED,SAAgB,qBAAqB,CAAC,IAAY;IAChD,OAAO,GAAG,eAAe,CAAC,IAAI,CAAC,QAAQ,CAAC;AAC1C,CAAC;AAED,SAAgB,oBAAoB,CAAC,IAAY;IAC/C,OAAO,0BAA0B,IAAI,EAAE,CAAC;AAC1C,CAAC;AAOD,MAAM,sBAAsB,GAAG,IAAI,GAAG,EAAU,CAAC;AAEjD,SAAgB,gBAAgB,CAAC,IAAY;IAC3C,IAAI,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC;QACrC,MAAM,IAAI,KAAK,CACb,6CAA6C,IAAI,2BAA2B;YAC1E,gEAAgE,CACnE,CAAC;IACJ,CAAC;IACD,sBAAsB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AACnC,CAAC;AAED,SAAgB,kBAAkB,CAAC,IAAY;IAC7C,sBAAsB,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC"}

package/dist/decorators/index.d.ts

@@ -1,2 +1,3 @@
 export * from './inject-browser.decorator';
 export * from './inject-page.decorator';
+export * from './inject-page-controller.decorator';

package/dist/decorators/index.js

@@ -16,4 +16,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./inject-browser.decorator"), exports);
 __exportStar(require("./inject-page.decorator"), exports);
+__exportStar(require("./inject-page-controller.decorator"), exports);
 //# sourceMappingURL=index.js.map

package/dist/decorators/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/decorators/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,6DAA2C;AAC3C,0DAAwC;AACxC,qEAAmD"}

package/dist/decorators/inject-browser.decorator.d.ts

@@ -1 +1,2 @@
-export declare const InjectBrowser: () => PropertyDecorator & ParameterDecorator;
+import { Inject } from '@nestjs/common';
+export declare const InjectBrowser: (name?: string) => ReturnType<typeof Inject>;

package/dist/decorators/inject-browser.decorator.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InjectBrowser = void 0;
 const common_1 = require("@nestjs/common");
-const InjectBrowser = () => (0, common_1.Inject)('BROWSER_INSTANCE');
+const tokens_1 = require("../common/tokens");
+const InjectBrowser = (name = 'default') => (0, common_1.Inject)((0, tokens_1.getBrowserToken)(name));
 exports.InjectBrowser = InjectBrowser;
 //# sourceMappingURL=inject-browser.decorator.js.map

package/dist/decorators/inject-browser.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-browser.decorator.js","sourceRoot":"","sources":["../../src/decorators/inject-browser.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAEjC,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,IAAA,eAAM,EAAC,kBAAkB,CAAC,CAAC;AAAjD,QAAA,aAAa,iBAAoC"}
+{"version":3,"file":"inject-browser.decorator.js","sourceRoot":"","sources":["../../src/decorators/inject-browser.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,6CAAmD;AAM5C,MAAM,aAAa,GAAG,CAAC,IAAI,GAAG,SAAS,EAA6B,EAAE,CAC3E,IAAA,eAAM,EAAC,IAAA,wBAAe,EAAC,IAAI,CAAC,CAAC,CAAC;AADnB,QAAA,aAAa,iBACM"}

package/dist/decorators/inject-page-controller.decorator.d.ts

@@ -0,0 +1,2 @@
+import { Inject } from '@nestjs/common';
+export declare const InjectPageController: (page: string, name?: string) => ReturnType<typeof Inject>;

package/dist/decorators/inject-page-controller.decorator.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InjectPageController = void 0;
+const common_1 = require("@nestjs/common");
+const tokens_1 = require("../common/tokens");
+const InjectPageController = (page, name = 'default') => (0, common_1.Inject)((0, tokens_1.getPageControllerToken)(page, name));
+exports.InjectPageController = InjectPageController;
+//# sourceMappingURL=inject-page-controller.decorator.js.map

package/dist/decorators/inject-page-controller.decorator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inject-page-controller.decorator.js","sourceRoot":"","sources":["../../src/decorators/inject-page-controller.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,6CAA0D;AAMnD,MAAM,oBAAoB,GAAG,CAClC,IAAY,EACZ,IAAI,GAAG,SAAS,EACW,EAAE,CAAC,IAAA,eAAM,EAAC,IAAA,+BAAsB,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAH9D,QAAA,oBAAoB,wBAG0C"}

package/dist/decorators/inject-page.decorator.d.ts

@@ -1 +1,2 @@
-export declare const InjectPage: () => PropertyDecorator & ParameterDecorator;
+import { Inject } from '@nestjs/common';
+export declare const InjectPage: (page: string, name?: string) => ReturnType<typeof Inject>;

package/dist/decorators/inject-page.decorator.js

@@ -2,6 +2,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InjectPage = void 0;
 const common_1 = require("@nestjs/common");
-const InjectPage = () => (0, common_1.Inject)('PAGE_INSTANCE');
+const tokens_1 = require("../common/tokens");
+const InjectPage = (page, name = 'default') => (0, common_1.Inject)((0, tokens_1.getPageToken)(page, name));
 exports.InjectPage = InjectPage;
 //# sourceMappingURL=inject-page.decorator.js.map

package/dist/decorators/inject-page.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"inject-page.decorator.js","sourceRoot":"","sources":["../../src/decorators/inject-page.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AAEjC,MAAM,UAAU,GAAG,GAAG,EAAE,CAAC,IAAA,eAAM,EAAC,eAAe,CAAC,CAAC;AAA3C,QAAA,UAAU,cAAiC"}
+{"version":3,"file":"inject-page.decorator.js","sourceRoot":"","sources":["../../src/decorators/inject-page.decorator.ts"],"names":[],"mappings":";;;AAAA,2CAAwC;AACxC,6CAAgD;AAMzC,MAAM,UAAU,GAAG,CACxB,IAAY,EACZ,IAAI,GAAG,SAAS,EACW,EAAE,CAAC,IAAA,eAAM,EAAC,IAAA,qBAAY,EAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC;AAHpD,QAAA,UAAU,cAG0C"}

package/dist/examples/named-browser-example.d.ts

@@ -0,0 +1 @@
+export {};