@odg/chemical-x 1.29.0 → 2.0.0

package/dist/crawler/Browser.d.ts

@@ -1,12 +1,12 @@
-import { type GetterAccessInterface } from "../Interfaces";
-import { type BrowserChemicalXInterface, type ContextChemicalXInterface, type ContextEngineInterface, type ContextOptionsLibraryInterface, type PageEngineInterface, CreateContextFactoryType, CreatePageFactoryType, type BrowserEngineInterface } from ".";
-export declare class Browser<BrowserEngineType extends BrowserEngineInterface, ContextEngineType extends ContextEngineInterface, PageEngineType extends PageEngineInterface> implements GetterAccessInterface, BrowserChemicalXInterface<BrowserEngineType, ContextEngineType> {
-    readonly $browserInstance: BrowserEngineType;
+import type { GetterAccessInterface } from "../Interfaces";
+import { CreateContextFactoryType, CreatePageFactoryType, type BrowserChemicalXInterface, type BrowserEngineInterface, type ContextChemicalXInterface, type ContextEngineInterface, type ContextOptionsLibraryInterface, type PageEngineInterface } from ".";
+export declare class Browser<BrowserClassEngine extends BrowserEngineInterface, ContextClassEngine extends ContextEngineInterface, PageClassEngine extends PageEngineInterface> implements GetterAccessInterface, BrowserChemicalXInterface<BrowserClassEngine, ContextClassEngine> {
+    readonly $browserInstance: BrowserClassEngine;
     private readonly $newContext;
     private readonly $newPage;
-    constructor($browserInstance: BrowserEngineType, $newContext: CreateContextFactoryType<ContextEngineType, PageEngineType>, $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextEngineType>, PageEngineType>);
+    constructor($browserInstance: BrowserClassEngine, $newContext: CreateContextFactoryType<ContextClassEngine, PageClassEngine>, $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextClassEngine>, PageClassEngine>);
     defaultContextOptions(): Promise<ContextOptionsLibraryInterface>;
-    newContext(options?: ContextOptionsLibraryInterface): Promise<ContextChemicalXInterface<ContextEngineType> & ContextEngineType>;
-    contexts(): Array<ContextChemicalXInterface<ContextEngineType> & ContextEngineType>;
+    newContext(options?: ContextOptionsLibraryInterface): Promise<ContextChemicalXInterface<ContextClassEngine> & ContextClassEngine>;
+    contexts(): Array<ContextChemicalXInterface<ContextClassEngine> & ContextClassEngine>;
     __get(key: PropertyKey): unknown;
 }

package/dist/crawler/Browser.js

@@ -51,7 +51,7 @@ let Browser = class Browser {
 };
 exports.Browser = Browser;
 exports.Browser = Browser = __decorate([
-    (0, Decorators_1.getAccessDecorator)(),
+    Decorators_1.ODGDecorators.getterAccess(),
     __metadata("design:paramtypes", [Object, Function, Function])
 ], Browser);
 //# sourceMappingURL=Browser.js.map

package/dist/crawler/Browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"Browser.js","sourceRoot":"","sources":["../../src/crawler/Browser.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oDAAyD;AAUlD,IAAM,OAAO,GAAb,MAAM,OAAO;IAOI;IACC;IACA;IAHrB,YACoB,gBAAmC,EAClC,WAAwE,EACxE,QAA6F;QAF9F,qBAAgB,GAAhB,gBAAgB,CAAmB;QAClC,gBAAW,GAAX,WAAW,CAA6D;QACxE,aAAQ,GAAR,QAAQ,CAAqF;IAGlH,CAAC;IAEM,KAAK,CAAC,qBAAqB;QAC9B,OAAO,EACN,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,UAAU,CACnB,OAAwC;QAExC,MAAM,WAAW,GAAG,CAChB,IAAI,CAAC,gBAAgB,CAAC,UAAU;eAC7B,IAAI,CAAC,gBAAgB,CAAC,6BAA6B;eACnD,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CACY,CAAC;QAE9D,OAAO,IAAI,CAAC,WAAW,CACnB,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1C,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE;YACrC,GAAG,OAAO;SACb,CAAC,EACF,IAAI,CAAC,QAAQ,CACoD,CAAC;IAC1E,CAAC;IAEM,QAAQ;QACX,MAAM,cAAc,GAAG,UAAU,IAAI,IAAI,CAAC,gBAAgB;eACnD,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,KAAK,UAAU;eACnD,IAAI,CAAC,gBAAgB,CAAC,QAAsC,EAAE,CAAC;QACvE,MAAM,QAAQ,GAAG,cAAc,IAAI,EAAE,CAAC;QAEtC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAC7C,OAAO,EACP,IAAI,CAAC,QAAQ,CACoD,CAAC,CAAC;IAC3E,CAAC;IAEM,KAAK,CAAC,GAAgB;QACzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,aAAa,GAAI,IAAI,CAAC,gBAAiD,CAAC,GAAG,CAAC,CAAC;QAEnF,OAAO,OAAO,aAAa,KAAK,UAAU;YACtC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;CAEJ,CAAA;AA7DY,0BAAO;kBAAP,OAAO;IADnB,IAAA,+BAAkB,GAAE;;GACR,OAAO,CA6DnB"}
+{"version":3,"file":"Browser.js","sourceRoot":"","sources":["../../src/crawler/Browser.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,oDAAoD;AAc7C,IAAM,OAAO,GAAb,MAAM,OAAO;IAOI;IACC;IACA;IAHrB,YACoB,gBAAoC,EACnC,WAA0E,EAC1E,QAGhB;QALe,qBAAgB,GAAhB,gBAAgB,CAAoB;QACnC,gBAAW,GAAX,WAAW,CAA+D;QAC1E,aAAQ,GAAR,QAAQ,CAGxB;IAGL,CAAC;IAEM,KAAK,CAAC,qBAAqB;QAC9B,OAAO,EACN,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,UAAU,CACnB,OAAwC;QAExC,MAAM,WAAW,GAAG,CAChB,IAAI,CAAC,gBAAgB,CAAC,UAAU;eAC7B,IAAI,CAAC,gBAAgB,CAAC,6BAA6B;eACnD,IAAI,CAAC,gBAAgB,CAAC,oBAAoB,CACa,CAAC;QAE/D,OAAO,IAAI,CAAC,WAAW,CACnB,MAAM,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,EAAE;YAC1C,GAAG,MAAM,IAAI,CAAC,qBAAqB,EAAE;YACrC,GAAG,OAAO;SACb,CAAC,EACF,IAAI,CAAC,QAAQ,CACsD,CAAC;IAC5E,CAAC;IAEM,QAAQ;QACX,MAAM,cAAc,GAAG,UAAU,IAAI,IAAI,CAAC,gBAAgB;eACnD,OAAO,IAAI,CAAC,gBAAgB,CAAC,QAAQ,KAAK,UAAU;eACnD,IAAI,CAAC,gBAAgB,CAAC,QAAuC,EAAE,CAAC;QACxE,MAAM,QAAQ,GAAG,cAAc,IAAI,EAAE,CAAC;QAEtC,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,IAAI,CAAC,WAAW,CAC7C,OAAO,EACP,IAAI,CAAC,QAAQ,CACsD,CAAC,CAAC;IAC7E,CAAC;IAEM,KAAK,CAAC,GAAgB;QACzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,aAAa,GAAI,IAAI,CAAC,gBAAiD,CAAC,GAAG,CAAC,CAAC;QAEnF,OAAO,OAAO,aAAa,KAAK,UAAU;YACtC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;CAEJ,CAAA;AAhEY,0BAAO;kBAAP,OAAO;IADnB,0BAAa,CAAC,YAAY,EAAE;;GAChB,OAAO,CAgEnB"}

package/dist/crawler/BrowserManager.d.ts

@@ -1,9 +1,9 @@
-import { type BrowserChemicalXInterface, type BrowserEngineInterface, type ContextChemicalXInterface, type ContextEngineInterface, type CreateBrowserFactoryType, type CreateContextFactoryType, type CreatePageFactoryType, type PageEngineInterface } from "..";
-export declare class BrowserManager<BrowserEngineType extends BrowserEngineInterface, ContextEngineType extends ContextEngineInterface, PageEngineType extends PageEngineInterface> {
+import type { BrowserChemicalXInterface, BrowserEngineInterface, ContextChemicalXInterface, ContextEngineInterface, CreateBrowserFactoryType, CreateContextFactoryType, CreatePageFactoryType, PageEngineInterface } from "..";
+export declare class BrowserManager<BrowserClassEngine extends BrowserEngineInterface, ContextClassEngine extends ContextEngineInterface, PageClassEngine extends PageEngineInterface> {
     private readonly $newBrowser;
     private readonly $newContext;
     private readonly $newPage;
-    constructor($newBrowser: CreateBrowserFactoryType<BrowserEngineType, ContextEngineType, PageEngineType>, $newContext: CreateContextFactoryType<ContextEngineType, PageEngineType>, $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextEngineType>, PageEngineType>);
-    newBrowser(browser: () => Promise<BrowserEngineType>): Promise<BrowserChemicalXInterface<BrowserEngineType, ContextEngineType> & BrowserEngineType>;
-    newPersistentContext(context: () => Promise<ContextEngineType>): Promise<ContextChemicalXInterface<ContextEngineType> & ContextEngineType>;
+    constructor($newBrowser: CreateBrowserFactoryType<BrowserClassEngine, ContextClassEngine, PageClassEngine>, $newContext: CreateContextFactoryType<ContextClassEngine, PageClassEngine>, $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextClassEngine>, PageClassEngine>);
+    newBrowser(browser: () => Promise<BrowserClassEngine>): Promise<BrowserChemicalXInterface<BrowserClassEngine, ContextClassEngine> & BrowserClassEngine>;
+    newPersistentContext(context: () => Promise<ContextClassEngine>): Promise<ContextChemicalXInterface<ContextClassEngine> & ContextClassEngine>;
 }

package/dist/crawler/BrowserManager.js.map

@@ -1 +1 @@
-{"version":3,"file":"BrowserManager.js","sourceRoot":"","sources":["../../src/crawler/BrowserManager.ts"],"names":[],"mappings":";;;AAWA,MAAa,cAAc;IAOF;IACA;IACA;IAHrB,YACqB,WAA2F,EAC3F,WAAwE,EACxE,QAA6F;QAF7F,gBAAW,GAAX,WAAW,CAAgF;QAC3F,gBAAW,GAAX,WAAW,CAA6D;QACxE,aAAQ,GAAR,QAAQ,CAAqF;IAElH,CAAC;IAEM,KAAK,CAAC,UAAU,CACnB,OAAyC;QAEzC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAEnD,CAAC;IAC1B,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAC7B,OAAyC;QAEzC,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,QAAQ,CAEjC,CAAC;IAC1B,CAAC;CAEJ;AA7BD,wCA6BC"}
+{"version":3,"file":"BrowserManager.js","sourceRoot":"","sources":["../../src/crawler/BrowserManager.ts"],"names":[],"mappings":";;;AAWA,MAAa,cAAc;IAOF;IACA;IACA;IAHrB,YACqB,WAA8F,EAC9F,WAA0E,EAC1E,QAGhB;QALgB,gBAAW,GAAX,WAAW,CAAmF;QAC9F,gBAAW,GAAX,WAAW,CAA+D;QAC1E,aAAQ,GAAR,QAAQ,CAGxB;IAEL,CAAC;IAEM,KAAK,CAAC,UAAU,CACnB,OAA0C;QAE1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,QAAQ,CAGlD,CAAC;IAC3B,CAAC;IAEM,KAAK,CAAC,oBAAoB,CAC7B,OAA0C;QAE1C,OAAO,IAAI,CAAC,WAAW,CAAC,MAAM,OAAO,EAAE,EAAE,IAAI,CAAC,QAAQ,CAEhC,CAAC;IAC3B,CAAC;CAEJ;AAjCD,wCAiCC"}

package/dist/crawler/Context.d.ts

@@ -1,10 +1,10 @@
-import { type PageOptionsLibraryInterface, type ContextChemicalXInterface, type ContextEngineInterface, type CreatePageFactoryType, type GetterAccessInterface, type PageChemicalXInterface, type PageEngineInterface } from "..";
-export declare class Context<ContextEngineType extends ContextEngineInterface, PageEngineType extends PageEngineInterface> implements GetterAccessInterface, ContextChemicalXInterface<ContextEngineType> {
-    readonly $contextInstance: ContextEngineType;
-    readonly $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextEngineType>, PageEngineType>;
-    constructor($contextInstance: ContextEngineType, $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextEngineType>, PageEngineType>);
+import { type ContextChemicalXInterface, type ContextEngineInterface, type CreatePageFactoryType, type GetterAccessInterface, type PageChemicalXInterface, type PageEngineInterface, type PageOptionsLibraryInterface } from "..";
+export declare class Context<ContextClassEngine extends ContextEngineInterface, PageClassEngine extends PageEngineInterface> implements GetterAccessInterface, ContextChemicalXInterface<ContextClassEngine> {
+    readonly $contextInstance: ContextClassEngine;
+    readonly $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextClassEngine>, PageClassEngine>;
+    constructor($contextInstance: ContextClassEngine, $newPage: CreatePageFactoryType<ContextChemicalXInterface<ContextClassEngine>, PageClassEngine>);
     defaultPageOptions(): Promise<PageOptionsLibraryInterface>;
-    newPage(options?: Record<string, unknown>): Promise<PageChemicalXInterface<PageEngineType> & PageEngineType>;
-    pages(): Array<PageChemicalXInterface<PageEngineType> & PageEngineType>;
+    newPage(options?: Record<string, unknown>): Promise<PageChemicalXInterface<PageClassEngine> & PageClassEngine>;
+    pages(): Array<PageChemicalXInterface<PageClassEngine> & PageClassEngine>;
     __get(key: PropertyKey): unknown;
 }

package/dist/crawler/Context.js

@@ -10,7 +10,7 @@ var __metadata = (this && this.__metadata) || function (k, v) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Context = void 0;
-const Decorators_1 = require("../Support/Decorators");
+const __1 = require("..");
 let Context = class Context {
     $contextInstance;
     $newPage;
@@ -43,7 +43,7 @@ let Context = class Context {
 };
 exports.Context = Context;
 exports.Context = Context = __decorate([
-    (0, Decorators_1.getAccessDecorator)(),
+    __1.ODGDecorators.getterAccess(),
     __metadata("design:paramtypes", [Object, Function])
 ], Context);
 //# sourceMappingURL=Context.js.map

package/dist/crawler/Context.js.map

@@ -1 +1 @@
-{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../src/crawler/Context.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,oDAAyD;AAalD,IAAM,OAAO,GAAb,MAAM,OAAO;IAMI;IACA;IAFpB,YACoB,gBAAmC,EACnC,QAA6F;QAD7F,qBAAgB,GAAhB,gBAAgB,CAAmB;QACnC,aAAQ,GAAR,QAAQ,CAAqF;IAGjH,CAAC;IAEM,KAAK,CAAC,kBAAkB;QAC3B,OAAO,EACN,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,OAAO,CAChB,OAAiC;QAEjC,OAAO,IAAI,CAAC,QAAQ,CAChB,IAAI,EACJ,MAAO,IAAI,CAAC,gBAAgB,CAAC,OAA4D,CACrF,IAAI,CAAC,gBAAgB,EACrB;YACI,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE;YAClC,GAAG,OAAO;SACb,CACJ,CACuD,CAAC;IACjE,CAAC;IAEM,KAAK;QACR,MAAM,KAAK,GAAI,IAAI,CAAC,gBAAgB,CAAC,KAAgC,EAAE,CAAC;QAExE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CACpC,IAAI,EACJ,IAAI,CACoD,CAAC,CAAC;IAClE,CAAC;IAEM,KAAK,CAAC,GAAgB;QACzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,aAAa,GAAI,IAAI,CAAC,gBAAiD,CAAC,GAAG,CAAC,CAAC;QAEnF,OAAO,OAAO,aAAa,KAAK,UAAU;YACtC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;CAEJ,CAAA;AArDY,0BAAO;kBAAP,OAAO;IADnB,IAAA,+BAAkB,GAAE;;GACR,OAAO,CAqDnB"}
+{"version":3,"file":"Context.js","sourceRoot":"","sources":["../../src/crawler/Context.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0BASY;AAGL,IAAM,OAAO,GAAb,MAAM,OAAO;IAMI;IACA;IAFpB,YACoB,gBAAoC,EACpC,QAA+F;QAD/F,qBAAgB,GAAhB,gBAAgB,CAAoB;QACpC,aAAQ,GAAR,QAAQ,CAAuF;IAGnH,CAAC;IAEM,KAAK,CAAC,kBAAkB;QAC3B,OAAO,EACN,CAAC;IACN,CAAC;IAEM,KAAK,CAAC,OAAO,CAChB,OAAiC;QAEjC,OAAO,IAAI,CAAC,QAAQ,CAChB,IAAI,EACJ,MAAO,IAAI,CAAC,gBAAgB,CAAC,OAA6D,CACtF,IAAI,CAAC,gBAAgB,EACrB;YACI,GAAG,MAAM,IAAI,CAAC,kBAAkB,EAAE;YAClC,GAAG,OAAO;SACb,CACJ,CACyD,CAAC;IACnE,CAAC;IAEM,KAAK;QACR,MAAM,KAAK,GAAI,IAAI,CAAC,gBAAgB,CAAC,KAAiC,EAAE,CAAC;QAEzE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CACpC,IAAI,EACJ,IAAI,CACsD,CAAC,CAAC;IACpE,CAAC;IAEM,KAAK,CAAC,GAAgB;QACzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,aAAa,GAAI,IAAI,CAAC,gBAAiD,CAAC,GAAG,CAAC,CAAC;QAEnF,OAAO,OAAO,aAAa,KAAK,UAAU;YACtC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,gBAAgB,CAAC;YAC3C,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,gBAAgB,EAAE,GAAG,CAAC,CAAC;IAClD,CAAC;CAEJ,CAAA;AArDY,0BAAO;kBAAP,OAAO;IADnB,iBAAa,CAAC,YAAY,EAAE;;GAChB,OAAO,CAqDnB"}

package/dist/crawler/Handlers/BaseHandler.d.ts

@@ -1,12 +1,13 @@
 import { Exception } from "@odg/exception";
 import { RetryAction } from "../../Enums";
-import { type HandlerFunction, type HandlerInterface, type HandlerSolutionType } from "../../Interfaces";
-import { type PageEngineInterface } from "../@types";
-export declare abstract class BaseHandler<SelectorBaseType, PageEngineType extends PageEngineInterface> implements HandlerInterface {
-    readonly page: PageEngineType;
-    readonly $$s: SelectorBaseType;
+import type { HandlerFunction, HandlerInterface, HandlerSolutionType } from "../../Interfaces";
+import type { PageEngineInterface } from "../@types";
+import type { SelectorType } from "../Selectors/SelectorsType";
+export declare abstract class BaseHandler<PageClassEngine extends PageEngineInterface> implements HandlerInterface {
     currentAttempt: number;
-    constructor(page: PageEngineType, $$s: SelectorBaseType);
+    page?: PageClassEngine;
+    abstract readonly $$s: Record<number | string | symbol, SelectorType>;
+    setPage(page: PageClassEngine): this;
     /**
      * Called if the handler completes successfully.
      *
@@ -27,7 +28,7 @@ export declare abstract class BaseHandler<SelectorBaseType, PageEngineType exten
      *
      * Return a `RetryAction` to control the retry behavior.
      *
-     * @param {Exception} exception Exception
+     * @param {Exception} exception Exception that caused the retry.
      * @param {number} attempt The current attempt number.
      * @returns {Promise<RetryAction>} The action to take before the next retry.
      */

package/dist/crawler/Handlers/BaseHandler.js

@@ -5,12 +5,11 @@ const exception_1 = require("@odg/exception");
 const _enums_1 = require("../../Enums");
 const _helpers_1 = require("../../Helpers");
 class BaseHandler {
-    page;
-    $$s;
     currentAttempt = 0;
-    constructor(page, $$s) {
+    page;
+    setPage(page) {
         this.page = page;
-        this.$$s = $$s;
+        return this;
     }
     /**
      * Executes the handler with retry, failure, and finish logic.

package/dist/crawler/Handlers/BaseHandler.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseHandler.js","sourceRoot":"","sources":["../../../src/crawler/Handlers/BaseHandler.ts"],"names":[],"mappings":";;;AAAA,8CAA6D;AAE7D,mCAAqC;AACrC,uCAAiC;AASjC,MAAsB,WAAW;IAQT;IACA;IAJb,cAAc,GAAW,CAAC,CAAC;IAElC,YACoB,IAAoB,EACpB,GAAqB;QADrB,SAAI,GAAJ,IAAI,CAAgB;QACpB,QAAG,GAAH,GAAG,CAAkB;IAEzC,CAAC;IAkDD;;;;OAIG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC;YACD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAE5D,IAAI,eAAe,YAAY,qBAAS,EAAE,CAAC;gBACvC,MAAM,eAAe,CAAC;YAC1B,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,4BAAgB,CAAC,cAAc,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;YAErF,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;YAC/B,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;;gBAC3C,MAAM,SAAS,CAAC;QACzB,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe;QACxB,OAAO,oBAAW,CAAC,OAAO,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAChC,MAAM,eAAe,GAAG,MAAM,IAAA,gBAAK,EAAC;YAChC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACjB,EAAE,IAAI,CAAC,cAAc,CAAC;gBACtB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;gBAChD,IAAI,WAAW,YAAY,qBAAS,EAAE,CAAC;oBACnC,OAAO,WAAW,CAAC;gBACvB,CAAC;gBAED,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;YACD,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE;YAC3B,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,eAAe,KAAK,oBAAW,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,eAAe,CAAC;IAC3B,CAAC;CAoBJ;AAvID,kCAuIC"}
+{"version":3,"file":"BaseHandler.js","sourceRoot":"","sources":["../../../src/crawler/Handlers/BaseHandler.ts"],"names":[],"mappings":";;;AAAA,8CAA6D;AAE7D,mCAAqC;AACrC,uCAAiC;AAUjC,MAAsB,WAAW;IAItB,cAAc,GAAW,CAAC,CAAC;IAE3B,IAAI,CAAmB;IAIvB,OAAO,CAAC,IAAqB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,OAAO,IAAI,CAAC;IAChB,CAAC;IAkDD;;;;OAIG;IACI,KAAK,CAAC,OAAO;QAChB,IAAI,CAAC;YACD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;YAE5D,IAAI,eAAe,YAAY,qBAAS,EAAE,CAAC;gBACvC,MAAM,eAAe,CAAC;YAC1B,CAAC;YAED,MAAM,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAC3B,CAAC;QAAC,OAAO,KAAc,EAAE,CAAC;YACtB,MAAM,SAAS,GAAG,4BAAgB,CAAC,cAAc,CAAC,KAAK,EAAE,0BAA0B,CAAC,CAAC;YAErF,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,SAAS,CAAC,CAAC;YAE/B,IAAI,IAAI,CAAC,OAAO;gBAAE,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;;gBAC3C,MAAM,SAAS,CAAC;QACzB,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,eAAe;QACxB,OAAO,oBAAW,CAAC,OAAO,CAAC;IAC/B,CAAC;IAEO,KAAK,CAAC,sBAAsB;QAChC,MAAM,eAAe,GAAG,MAAM,IAAA,gBAAK,EAAC;YAChC,QAAQ,EAAE,KAAK,IAAI,EAAE;gBACjB,EAAE,IAAI,CAAC,cAAc,CAAC;gBACtB,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,cAAc,EAAE,CAAC;gBAEhD,IAAI,WAAW,YAAY,qBAAS,EAAE,CAAC;oBACnC,OAAO,WAAW,CAAC;gBACvB,CAAC;gBAED,OAAO,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAClC,CAAC;YACD,KAAK,EAAE,MAAM,IAAI,CAAC,OAAO,EAAE;YAC3B,KAAK,EAAE,MAAM,IAAI,CAAC,KAAK,EAAE,EAAE;YAC3B,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE,IAAI,CAAC,IAAI,CAAC;SAClC,CAAC,CAAC;QAEH,IAAI,eAAe,KAAK,oBAAW,CAAC,KAAK,EAAE,CAAC;YACxC,OAAO,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACzC,CAAC;QAED,OAAO,eAAe,CAAC;IAC3B,CAAC;CAoBJ;AA5ID,kCA4IC"}

package/dist/crawler/Interfaces/HandlerInterface.d.ts

@@ -1,22 +1,41 @@
-import { type Exception } from "@odg/exception";
-import { type RetryAction } from "../../Enums";
-import { type AttemptableInterface } from "../../Interfaces/AttemptableFlow";
+import type { Exception } from "@odg/exception";
+import type { RetryAction } from "../../Enums";
+import type { AttemptableInterface } from "../../Interfaces/AttemptableFlow";
 /**
- * Defines the possible outcomes for a handler's execution, guiding the retry mechanism.
+ * Represents the possible return types from a handler function's execution.
  *
- * ```
- * - `RetryAction.Retry`: When returned by a handler function, it forces a re-run of the entire
- *   handler execution from the beginning. This action *does not* trigger the handler's `retrying`
- *   method. resetting the attempt count and starting all over again
+ * This type union defines the allowed outcomes that can be returned by a handler,
+ * which guide the retry mechanism and control flow of the handler execution cycle.
  *
- * - `RetryAction.Resolve`: When returned by a handler function, it signals that the handler has
- *   successfully completed its task, and no further retries or error handling are needed for this
- *   specific execution.
+ * Handler functions can return the following values:
  *
- * - `Exception Instance`: When returned by a handler function, it indicates that an error has occurred,
- *   causing the immediate interruption of the execution with the provided exception. This bypasses
- *   any further retries for the current handler execution cycle.
- * ```
+ * - **`Exception`**: When an `Exception` instance is returned (not thrown), it indicates
+ * that an error occurred and the process must be interrupted. No further retries will be
+ * performed, and the handler will terminate with the returned error. This has the same
+ * utility as `RetryAction.Throw`, but `RetryAction.Throw` cannot be used in this context
+ * because no error has occurred yet - the return itself indicates the error condition.
+ *
+ * - **`RetryAction.Retry`**: Forces a retry by restarting the entire handler execution from
+ * the beginning. When this action is returned, the attempt counter is reset, so if you
+ * configured 3 attempts and return `RetryAction.Retry`, it will start counting the 3 attempts
+ * from zero again. Additionally, this action does *not* call the `retrying` method, which is
+ * normally called on all retry attempts. **Warning**: This is discouraged as improper use can
+ * lead to infinite loops.
+ *
+ * - **`RetryAction.Resolve`**: Indicates that the handler completed successfully. The expected
+ * condition was met, and the code can proceed to the next step of the robot workflow.
+ *
+ * The following `RetryAction` values are explicitly **not supported** and are excluded
+ * from this type:
+ *
+ * - **`RetryAction.Throw`**: Not supported in Handler Solutions. Use returning an `Exception`
+ * instance instead when you need to signal an error condition.
+ *
+ * - **`RetryAction.Default`**: Not supported in Handler Solutions. To simulate retry behavior
+ * when an error condition is detected, throw an exception instead (e.g., `throw new Exception("Page did not load")`).
+ * This will attempt the number of times configured in the `attempt` method. If all attempts
+ * fail and the same condition occurs again, it will terminate with that error or any other
+ * error that may have occurred.
  */
 export type HandlerSolutionType = Exception | Exclude<RetryAction, RetryAction.Default | RetryAction.Throw>;
 /**

package/dist/crawler/Interfaces/PageInterface.d.ts

@@ -1,3 +1,3 @@
-import { type AttemptableInterface } from "../../Interfaces";
+import type { AttemptableInterface } from "../../Interfaces";
 export interface PageInterface extends AttemptableInterface {
 }

package/dist/crawler/Interfaces/index.d.ts

@@ -1,2 +1,2 @@
 export type * from "./PageInterface";
-export * from "./HandlerInterface";
+export type * from "./HandlerInterface";

package/dist/crawler/Interfaces/index.js

@@ -1,18 +1,3 @@
 "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("./HandlerInterface"), exports);
 //# sourceMappingURL=index.js.map

package/dist/crawler/Interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/crawler/Interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,qDAAmC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/crawler/Interfaces/index.ts"],"names":[],"mappings":""}

package/dist/crawler/Page.d.ts

@@ -1,8 +1,8 @@
 import { ContextChemicalXInterface, ContextEngineInterface, type GetterAccessInterface, type PageChemicalXInterface, type PageEngineInterface } from "..";
-export declare class Page<ContextEngineType extends ContextEngineInterface, PageEngineType extends PageEngineInterface> implements GetterAccessInterface, PageChemicalXInterface<PageEngineType> {
-    readonly $context: ContextChemicalXInterface<ContextEngineType>;
-    readonly $pageInstance: PageEngineType;
-    constructor($context: ContextChemicalXInterface<ContextEngineType>, $pageInstance: PageEngineType);
-    context(): ContextChemicalXInterface<ContextEngineType>;
+export declare class Page<ContextClassEngine extends ContextEngineInterface, PageClassEngine extends PageEngineInterface> implements GetterAccessInterface, PageChemicalXInterface<PageClassEngine> {
+    readonly $context: ContextChemicalXInterface<ContextClassEngine>;
+    readonly $pageInstance: PageClassEngine;
+    constructor($context: ContextChemicalXInterface<ContextClassEngine>, $pageInstance: PageClassEngine);
+    context(): ContextChemicalXInterface<ContextClassEngine> & ContextClassEngine;
     __get(key: PropertyKey): unknown;
 }

package/dist/crawler/Page.js

@@ -33,7 +33,7 @@ let Page = class Page {
 };
 exports.Page = Page;
 exports.Page = Page = __decorate([
-    (0, __1.getAccessDecorator)(),
+    __1.ODGDecorators.getterAccess(),
     __metadata("design:paramtypes", [Object, Object])
 ], Page);
 //# sourceMappingURL=Page.js.map

package/dist/crawler/Page.js.map

@@ -1 +1 @@
-{"version":3,"file":"Page.js","sourceRoot":"","sources":["../../src/crawler/Page.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0BAMY;AAGL,IAAM,IAAI,GAAV,MAAM,IAAI;IAMO;IACA;IAFpB,YACoB,QAAsD,EACtD,aAA6B;QAD7B,aAAQ,GAAR,QAAQ,CAA8C;QACtD,kBAAa,GAAb,aAAa,CAAgB;IAGjD,CAAC;IAEM,OAAO;QACV,OAAO,IAAI,CAAC,QAAQ,CAAC;IACzB,CAAC;IAEM,KAAK,CAAC,GAAgB;QACzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,aAAa,GAAI,IAAI,CAAC,aAA8C,CAAC,GAAG,CAAC,CAAC;QAEhF,OAAO,OAAO,aAAa,KAAK,UAAU;YACtC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;YACxC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;CAEJ,CAAA;AA5BY,oBAAI;eAAJ,IAAI;IADhB,IAAA,sBAAkB,GAAE;;GACR,IAAI,CA4BhB"}
+{"version":3,"file":"Page.js","sourceRoot":"","sources":["../../src/crawler/Page.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,0BAOY;AAGL,IAAM,IAAI,GAAV,MAAM,IAAI;IAMO;IACA;IAFpB,YACoB,QAAuD,EACvD,aAA8B;QAD9B,aAAQ,GAAR,QAAQ,CAA+C;QACvD,kBAAa,GAAb,aAAa,CAAiB;IAGlD,CAAC;IAEM,OAAO;QACV,OAAO,IAAI,CAAC,QAA8E,CAAC;IAC/F,CAAC;IAEM,KAAK,CAAC,GAAgB;QACzB,IAAI,GAAG,IAAI,IAAI,EAAE,CAAC;YACd,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;QAClC,CAAC;QAED,MAAM,aAAa,GAAI,IAAI,CAAC,aAA8C,CAAC,GAAG,CAAC,CAAC;QAEhF,OAAO,OAAO,aAAa,KAAK,UAAU;YACtC,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,CAAC;YACxC,CAAC,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,EAAE,GAAG,CAAC,CAAC;IAC/C,CAAC;CAEJ,CAAA;AA5BY,oBAAI;eAAJ,IAAI;IADhB,iBAAa,CAAC,YAAY,EAAE;;GAChB,IAAI,CA4BhB"}

package/dist/crawler/Pages/BasePage.d.ts

@@ -1,10 +1,8 @@
-import { type Exception } from "@odg/exception";
-import { type PageInterface, type RetryAction } from "../..";
-import { type PageEngineInterface } from "../index";
-import { type SelectorType } from "../Selectors/SelectorsType";
-export declare abstract class BasePage<SelectorBaseType, PageClassEngine extends PageEngineInterface> implements PageInterface {
-    readonly page: PageClassEngine;
-    readonly $$s: SelectorBaseType;
+import type { Exception } from "@odg/exception";
+import type { PageInterface, RetryAction } from "../..";
+import type { PageEngineInterface } from "../index";
+import type { SelectorType } from "../Selectors/SelectorsType";
+export declare abstract class BasePage<PageClassEngine extends PageEngineInterface> implements PageInterface {
     /**
      * Current attempt number
      *
@@ -12,26 +10,21 @@ export declare abstract class BasePage<SelectorBaseType, PageClassEngine extends
      * @memberof BasePage
      */
     currentAttempt: number;
-    constructor(page: PageClassEngine, $$s: SelectorBaseType);
+    page?: PageClassEngine;
     /**
-     * Pre Start Page
+     * Selector of this page
      *
-     * @deprecated removed (Empty function)
+     * @type {SelectorType}
      * @memberof BasePage
      */
-    preStart(): Promise<void>;
+    abstract readonly $s?: SelectorType;
+    abstract readonly $$s?: Record<number | string | symbol, SelectorType>;
+    setPage(page: PageClassEngine): this;
     success?(): Promise<void>;
-    finish?(exception?: Exception | undefined): Promise<void>;
+    finish?(exception?: Exception): Promise<void>;
     failure?(exception: Exception): Promise<void>;
     retrying?(exception: Exception, attempt: number): Promise<RetryAction>;
     sleep?(): Promise<number>;
-    /**
-     * Selector of this page
-     *
-     * @type {SelectorType}
-     * @memberof BasePage
-     */
-    abstract readonly $s: SelectorType;
     abstract execute(): Promise<void>;
     abstract attempt(): Promise<number>;
 }

package/dist/crawler/Pages/BasePage.js

@@ -2,8 +2,6 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.BasePage = void 0;
 class BasePage {
-    page;
-    $$s;
     /**
      * Current attempt number
      *
@@ -11,18 +9,10 @@ class BasePage {
      * @memberof BasePage
      */
     currentAttempt = 0;
-    constructor(page, $$s) {
+    page;
+    setPage(page) {
         this.page = page;
-        this.$$s = $$s;
-    }
-    /**
-     * Pre Start Page
-     *
-     * @deprecated removed (Empty function)
-     * @memberof BasePage
-     */
-    async preStart() {
-        // Deprecated AttemptableFlow implement currentAttempt Count
+        return this;
     }
 }
 exports.BasePage = BasePage;

package/dist/crawler/Pages/BasePage.js.map

@@ -1 +1 @@
-{"version":3,"file":"BasePage.js","sourceRoot":"","sources":["../../../src/crawler/Pages/BasePage.ts"],"names":[],"mappings":";;;AAMA,MAAsB,QAAQ;IAWN;IACA;IAVpB;;;;;OAKG;IACI,cAAc,GAAW,CAAC,CAAC;IAElC,YACoB,IAAqB,EACrB,GAAqB;QADrB,SAAI,GAAJ,IAAI,CAAiB;QACrB,QAAG,GAAH,GAAG,CAAkB;IAEzC,CAAC;IAED;;;;;OAKG;IACI,KAAK,CAAC,QAAQ;QACjB,4DAA4D;IAChE,CAAC;CAyBJ;AAjDD,4BAiDC"}
+{"version":3,"file":"BasePage.js","sourceRoot":"","sources":["../../../src/crawler/Pages/BasePage.ts"],"names":[],"mappings":";;;AAMA,MAAsB,QAAQ;IAI1B;;;;;OAKG;IACI,cAAc,GAAW,CAAC,CAAC;IAE3B,IAAI,CAAmB;IAYvB,OAAO,CAAC,IAAqB;QAChC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QAEjB,OAAO,IAAI,CAAC;IAChB,CAAC;CAgBJ;AA5CD,4BA4CC"}

package/dist/crawler/Pages/Components/BaseComponentPage.d.ts

@@ -1,4 +1,4 @@
-import { type PageEngineInterface } from "../../index";
+import type { PageEngineInterface } from "../../index";
 import { BasePage } from "../BasePage";
-export declare abstract class BaseComponentPage<SelectorBaseType, PageClassEngine extends PageEngineInterface> extends BasePage<SelectorBaseType, PageClassEngine> {
+export declare abstract class BaseComponentPage<PageClassEngine extends PageEngineInterface> extends BasePage<PageClassEngine> {
 }

package/dist/crawler/Pages/Components/BaseComponentPage.js.map

@@ -1 +1 @@
-{"version":3,"file":"BaseComponentPage.js","sourceRoot":"","sources":["../../../../src/crawler/Pages/Components/BaseComponentPage.ts"],"names":[],"mappings":";;;AACA,0CAAuC;AAEvC,MAAsB,iBAGpB,SAAQ,mBAA2C;CAEpD;AALD,8CAKC"}
+{"version":3,"file":"BaseComponentPage.js","sourceRoot":"","sources":["../../../../src/crawler/Pages/Components/BaseComponentPage.ts"],"names":[],"mappings":";;;AACA,0CAAuC;AAEvC,MAAsB,iBAEpB,SAAQ,mBAAyB;CAElC;AAJD,8CAIC"}

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 export * from "./Support";
 export * from "./Helpers/index";
 export * from "./crawler/index";
-export * from "./Interfaces";
+export type * from "./Interfaces";
 export * from "./Exceptions";
 export * from "./Enums";

package/dist/index.js

@@ -17,7 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./Support"), exports);
 __exportStar(require("./Helpers/index"), exports);
 __exportStar(require("./crawler/index"), exports);
-__exportStar(require("./Interfaces"), exports);
 __exportStar(require("./Exceptions"), exports);
 __exportStar(require("./Enums"), exports);
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAE1B,kDAAgC;AAEhC,kDAAgC;AAEhC,+CAA6B;AAE7B,+CAA6B;AAE7B,0CAAwB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,4CAA0B;AAE1B,kDAAgC;AAEhC,kDAAgC;AAIhC,+CAA6B;AAE7B,0CAAwB"}