@futdevpro/fsm-dynamo 1.16.37 → 1.16.39

package/build/_modules/state-machine/_models/state-machine.control-model.spec.js

@@ -0,0 +1,282 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const rxjs_1 = require("rxjs");
+const state_machine_control_model_1 = require("./state-machine.control-model");
+/** Test state-enum a RAG ingest mintabol. */
+var TestRagState;
+(function (TestRagState) {
+    TestRagState["Idle"] = "idle";
+    TestRagState["Ingesting"] = "ingesting";
+    TestRagState["Embedding"] = "embedding";
+    TestRagState["Ready"] = "ready";
+    TestRagState["Degraded"] = "degraded";
+    TestRagState["Reingesting"] = "reingesting";
+})(TestRagState || (TestRagState = {}));
+/** Default test-config helper. */
+const buildBasicConfig = () => ({
+    initial: TestRagState.Idle,
+    transitions: [
+        { from: TestRagState.Idle, to: TestRagState.Ingesting },
+        { from: TestRagState.Ingesting, to: TestRagState.Embedding },
+        { from: TestRagState.Embedding, to: TestRagState.Ready },
+        { from: TestRagState.Ready, to: TestRagState.Degraded },
+        { from: TestRagState.Degraded, to: TestRagState.Reingesting },
+        { from: TestRagState.Reingesting, to: TestRagState.Ready },
+        // Wildcard array → degraded from any "working" state
+        {
+            from: [TestRagState.Ingesting, TestRagState.Embedding, TestRagState.Reingesting],
+            to: TestRagState.Degraded,
+        },
+    ],
+});
+describe('| DyFM_StateMachine | constructor + sync getters', () => {
+    it('| initial state is set from config.initial', () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        expect(sm.state()).toBe(TestRagState.Idle);
+        expect(sm.stateVersion()).toBe(0);
+    });
+    it('| throws on missing config', () => {
+        expect(() => new state_machine_control_model_1.DyFM_StateMachine(undefined)).toThrowError(/config object required/);
+    });
+    it('| throws on missing config.initial', () => {
+        expect(() => new state_machine_control_model_1.DyFM_StateMachine({ transitions: [] })).toThrowError(/initial must be a string/);
+    });
+    it('| throws on empty transitions array', () => {
+        expect(() => new state_machine_control_model_1.DyFM_StateMachine({ initial: TestRagState.Idle, transitions: [] })).toThrowError(/non-empty array/);
+    });
+});
+describe('| DyFM_StateMachine | state$ observable', () => {
+    it('| emits initial value on subscribe (BehaviorSubject pattern)', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        const firstValue = await (0, rxjs_1.firstValueFrom)(sm.state$);
+        expect(firstValue).toBe(TestRagState.Idle);
+    });
+    it('| emits new state after successful transition', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        const next$ = (0, rxjs_1.firstValueFrom)(sm.state$.pipe((0, rxjs_1.take)(2), (0, rxjs_1.toArray)()));
+        await sm.transition(TestRagState.Ingesting);
+        const emitted = await next$;
+        expect(emitted).toEqual([TestRagState.Idle, TestRagState.Ingesting]);
+    });
+});
+describe('| DyFM_StateMachine | canTransition', () => {
+    it('| true on valid transition path', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        expect(await sm.canTransition(TestRagState.Ingesting)).toBe(true);
+    });
+    it('| false on invalid transition (no matching from→to)', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        // Idle → Ready is NOT in the transition map
+        expect(await sm.canTransition(TestRagState.Ready)).toBe(false);
+    });
+    it('| false when guard returns false', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                { from: TestRagState.Idle, to: TestRagState.Ingesting, guard: (ctx) => ctx?.allow === true },
+            ],
+        });
+        expect(await sm.canTransition(TestRagState.Ingesting, { allow: false })).toBe(false);
+        expect(await sm.canTransition(TestRagState.Ingesting, { allow: true })).toBe(true);
+    });
+});
+describe('| DyFM_StateMachine | transition — happy paths', () => {
+    it('| basic ok flow: state changes, stateVersion++, ok result', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        const result = await sm.transition(TestRagState.Ingesting);
+        expect(result.ok).toBe(true);
+        if (result.ok) {
+            expect(result.from).toBe(TestRagState.Idle);
+            expect(result.to).toBe(TestRagState.Ingesting);
+            expect(result.stateVersion).toBe(1);
+        }
+        expect(sm.state()).toBe(TestRagState.Ingesting);
+        expect(sm.stateVersion()).toBe(1);
+    });
+    it('| full happy-path through ingest → ready', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        await sm.transition(TestRagState.Ingesting);
+        await sm.transition(TestRagState.Embedding);
+        const r3 = await sm.transition(TestRagState.Ready);
+        expect(r3.ok).toBe(true);
+        expect(sm.state()).toBe(TestRagState.Ready);
+        expect(sm.stateVersion()).toBe(3);
+    });
+    it('| wildcard `*` from matches any current state', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                { from: '*', to: TestRagState.Degraded },
+                { from: TestRagState.Idle, to: TestRagState.Ingesting },
+            ],
+        });
+        // Idle → Degraded via wildcard
+        const r1 = await sm.transition(TestRagState.Degraded);
+        expect(r1.ok).toBe(true);
+        expect(sm.state()).toBe(TestRagState.Degraded);
+    });
+    it('| array-from matches multiple sources', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        await sm.transition(TestRagState.Ingesting);
+        // [Ingesting, Embedding, Reingesting] → Degraded
+        const r = await sm.transition(TestRagState.Degraded);
+        expect(r.ok).toBe(true);
+        expect(sm.state()).toBe(TestRagState.Degraded);
+    });
+});
+describe('| DyFM_StateMachine | transition — failure paths', () => {
+    it('| invalid-transition reason when no matching transition', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        // Idle → Ready is not in the map
+        const result = await sm.transition(TestRagState.Ready);
+        expect(result.ok).toBe(false);
+        const f = result;
+        expect(f.reason).toBe('invalid-transition');
+        expect(f.currentState).toBe(TestRagState.Idle);
+        expect(f.attemptedTo).toBe(TestRagState.Ready);
+        expect(sm.state()).toBe(TestRagState.Idle);
+        expect(sm.stateVersion()).toBe(0);
+    });
+    it('| guard-rejected reason when guard returns false; state unchanged', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                { from: TestRagState.Idle, to: TestRagState.Ingesting, guard: (ctx) => ctx?.allow === true },
+            ],
+        });
+        const result = await sm.transition(TestRagState.Ingesting, { allow: false });
+        expect(result.ok).toBe(false);
+        const f = result;
+        expect(f.reason).toBe('guard-rejected');
+        expect(sm.state()).toBe(TestRagState.Idle);
+        expect(sm.stateVersion()).toBe(0);
+    });
+    it('| onLeave called BEFORE state change', async () => {
+        let stateAtOnLeave = null;
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                {
+                    from: TestRagState.Idle,
+                    to: TestRagState.Ingesting,
+                    onLeave: async () => { stateAtOnLeave = sm.state(); },
+                },
+            ],
+        });
+        await sm.transition(TestRagState.Ingesting);
+        expect(stateAtOnLeave).toBe(TestRagState.Idle);
+        expect(sm.state()).toBe(TestRagState.Ingesting);
+    });
+    it('| onEnter called AFTER state change, BEFORE persist', async () => {
+        let stateAtOnEnter = null;
+        let stateAtPersist = null;
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                {
+                    from: TestRagState.Idle,
+                    to: TestRagState.Ingesting,
+                    onEnter: async () => { stateAtOnEnter = sm.state(); },
+                },
+            ],
+            persist: async () => { stateAtPersist = sm.state(); },
+        });
+        await sm.transition(TestRagState.Ingesting);
+        expect(stateAtOnEnter).toBe(TestRagState.Ingesting);
+        expect(stateAtPersist).toBe(TestRagState.Ingesting);
+    });
+    it('| onEnter throw → state reverts + on-enter-failed reason', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                {
+                    from: TestRagState.Idle,
+                    to: TestRagState.Ingesting,
+                    onEnter: async () => { throw new Error('boom-onEnter'); },
+                },
+            ],
+        });
+        const result = await sm.transition(TestRagState.Ingesting);
+        expect(result.ok).toBe(false);
+        const f1 = result;
+        expect(f1.reason).toBe('on-enter-failed');
+        expect(String(f1.error?.message ?? '')).toContain('boom-onEnter');
+        expect(sm.state()).toBe(TestRagState.Idle); // reverted
+        expect(sm.stateVersion()).toBe(0); // reverted
+    });
+    it('| persist throw → state reverts + persist-failed reason', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                { from: TestRagState.Idle, to: TestRagState.Ingesting },
+            ],
+            persist: async () => { throw new Error('boom-persist'); },
+        });
+        const result = await sm.transition(TestRagState.Ingesting);
+        expect(result.ok).toBe(false);
+        const f2 = result;
+        expect(f2.reason).toBe('persist-failed');
+        expect(String(f2.error?.message ?? '')).toContain('boom-persist');
+        expect(sm.state()).toBe(TestRagState.Idle); // reverted
+        expect(sm.stateVersion()).toBe(0);
+    });
+    it('| onLeave throw → state NOT changed + on-leave-failed reason', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                {
+                    from: TestRagState.Idle,
+                    to: TestRagState.Ingesting,
+                    onLeave: async () => { throw new Error('boom-onLeave'); },
+                },
+            ],
+        });
+        const result = await sm.transition(TestRagState.Ingesting);
+        expect(result.ok).toBe(false);
+        const f3 = result;
+        expect(f3.reason).toBe('on-leave-failed');
+        expect(sm.state()).toBe(TestRagState.Idle); // never changed
+        expect(sm.stateVersion()).toBe(0);
+    });
+});
+describe('| DyFM_StateMachine | events$ + mutex', () => {
+    it('| events$ emits on successful transition', async () => {
+        const sm = new state_machine_control_model_1.DyFM_StateMachine(buildBasicConfig());
+        const event$ = (0, rxjs_1.firstValueFrom)(sm.events$);
+        await sm.transition(TestRagState.Ingesting);
+        const event = await event$;
+        expect(event.from).toBe(TestRagState.Idle);
+        expect(event.to).toBe(TestRagState.Ingesting);
+        expect(event.stateVersion).toBe(1);
+        expect(typeof event.timestamp).toBe('number');
+    });
+    it('| concurrent transitions are serialized (mutex)', async () => {
+        let inflightCount = 0;
+        let maxInflight = 0;
+        const sm = new state_machine_control_model_1.DyFM_StateMachine({
+            initial: TestRagState.Idle,
+            transitions: [
+                { from: TestRagState.Idle, to: TestRagState.Ingesting,
+                    onEnter: async () => {
+                        inflightCount++;
+                        if (inflightCount > maxInflight) {
+                            maxInflight = inflightCount;
+                        }
+                        await new Promise((r) => { setTimeout(r, 10); });
+                        inflightCount--;
+                    },
+                },
+                { from: TestRagState.Ingesting, to: TestRagState.Idle },
+            ],
+        });
+        // Fire 3 transitions concurrently — they must serialize
+        await Promise.all([
+            sm.transition(TestRagState.Ingesting),
+            sm.transition(TestRagState.Idle),
+            sm.transition(TestRagState.Ingesting),
+        ]);
+        expect(maxInflight).toBe(1);
+        expect(sm.stateVersion()).toBe(3);
+    });
+});
+//# sourceMappingURL=state-machine.control-model.spec.js.map

package/build/_modules/state-machine/_models/state-machine.control-model.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state-machine.control-model.spec.js","sourceRoot":"","sources":["../../../../src/_modules/state-machine/_models/state-machine.control-model.spec.ts"],"names":[],"mappings":"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"}

package/build/_modules/state-machine/_models/state-transition-result.interface.d.ts

@@ -1,40 +1,40 @@
-import { DyFM_Error } from '../../../_models/control-models/error.control-model';
-/**
- * Failure reason-ok a `DyFM_StateMachineTransition_Result.reason` mezohoz.
- *
- *  - `invalid-transition`: nincs olyan transition a config-ban ami a jelenlegi
- *    state-bol a kert `to`-ba vezet.
- *  - `guard-rejected`: a transition `guard` callback-je `false`-t adott.
- *  - `on-leave-failed`: a transition `onLeave` callback-je throw-olt; state NEM valtozott.
- *  - `on-enter-failed`: az `onEnter` callback throw-olt az uj state beallitasa utan; state revert-elve a from-ra.
- *  - `persist-failed`: a `persist` callback throw-olt; state revert-elve a from-ra.
- */
-export type DyFM_StateMachineTransition_FailureReason = 'invalid-transition' | 'guard-rejected' | 'on-leave-failed' | 'on-enter-failed' | 'persist-failed';
-/**
- * Sikeres atmenet eredmenye.
- */
-export interface DyFM_StateMachineTransition_SuccessResult<TState extends string> {
-    ok: true;
-    from: TState;
-    to: TState;
-    /** A frissitett state-version szam (>= 1). */
-    stateVersion: number;
-}
-/**
- * Sikertelen atmenet eredmenye.
- */
-export interface DyFM_StateMachineTransition_FailureResult<TState extends string> {
-    ok: false;
-    reason: DyFM_StateMachineTransition_FailureReason;
-    /** A jelenlegi state amikor a sikertelenseg torent. */
-    currentState: TState;
-    /** A megkiserelt cel-state. */
-    attemptedTo: TState;
-    /** Opcionalis hiba ha az atmenet error-ral bukott (pl. on-enter throw, persist throw). */
-    error?: DyFM_Error | Error;
-}
-/**
- * Discriminated union — `ok` flag-gel branchol.
- */
-export type DyFM_StateMachineTransition_Result<TState extends string> = DyFM_StateMachineTransition_SuccessResult<TState> | DyFM_StateMachineTransition_FailureResult<TState>;
+import { DyFM_Error } from '../../../_models/control-models/error.control-model';
+/**
+ * Failure reason-ok a `DyFM_StateMachineTransition_Result.reason` mezohoz.
+ *
+ *  - `invalid-transition`: nincs olyan transition a config-ban ami a jelenlegi
+ *    state-bol a kert `to`-ba vezet.
+ *  - `guard-rejected`: a transition `guard` callback-je `false`-t adott.
+ *  - `on-leave-failed`: a transition `onLeave` callback-je throw-olt; state NEM valtozott.
+ *  - `on-enter-failed`: az `onEnter` callback throw-olt az uj state beallitasa utan; state revert-elve a from-ra.
+ *  - `persist-failed`: a `persist` callback throw-olt; state revert-elve a from-ra.
+ */
+export type DyFM_StateMachineTransition_FailureReason = 'invalid-transition' | 'guard-rejected' | 'on-leave-failed' | 'on-enter-failed' | 'persist-failed';
+/**
+ * Sikeres atmenet eredmenye.
+ */
+export interface DyFM_StateMachineTransition_SuccessResult<TState extends string> {
+    ok: true;
+    from: TState;
+    to: TState;
+    /** A frissitett state-version szam (>= 1). */
+    stateVersion: number;
+}
+/**
+ * Sikertelen atmenet eredmenye.
+ */
+export interface DyFM_StateMachineTransition_FailureResult<TState extends string> {
+    ok: false;
+    reason: DyFM_StateMachineTransition_FailureReason;
+    /** A jelenlegi state amikor a sikertelenseg torent. */
+    currentState: TState;
+    /** A megkiserelt cel-state. */
+    attemptedTo: TState;
+    /** Opcionalis hiba ha az atmenet error-ral bukott (pl. on-enter throw, persist throw). */
+    error?: DyFM_Error | Error;
+}
+/**
+ * Discriminated union — `ok` flag-gel branchol.
+ */
+export type DyFM_StateMachineTransition_Result<TState extends string> = DyFM_StateMachineTransition_SuccessResult<TState> | DyFM_StateMachineTransition_FailureResult<TState>;
 //# sourceMappingURL=state-transition-result.interface.d.ts.map

package/build/_modules/state-machine/_models/state-transition-result.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=state-transition-result.interface.js.map

package/build/_modules/state-machine/_models/state-transition.interface.d.ts

@@ -1,31 +1,31 @@
-/**
- * Egyetlen atmenet (transition) leiras a `DyFM_StateMachine` transitionMap-jeben.
- *
- * `from` lehet:
- *  - egy konkret state (TState)
- *  - tobb state array-je
- *  - `'*'` wildcard (barmely jelenlegi state)
- *
- * `guard` opcionalis pre-check: ha visszater `false` (vagy resolved-`false` Promise),
- * az atmenet visszautasitva `'guard-rejected'` reason-nel.
- *
- * `onLeave` opcionalis side-effect ami a state-valtas ELOTT fut. Throw-ja
- * `'on-leave-failed'` reason-t valt ki.
- *
- * `onEnter` opcionalis side-effect ami az uj state beallitasa UTAN, de a
- * `persist` callback elott fut. Throw-ja `'on-enter-failed'` reason-t valt ki
- * — ilyenkor a state visszaall (revert).
- */
-export interface DyFM_StateTransition<TState extends string, TContext = unknown> {
-    /** Forras state(ek). Wildcard `'*'` = barmilyen jelenlegi state. */
-    from: TState | TState[] | '*';
-    /** Cel state. */
-    to: TState;
-    /** Optional pre-check; ha `false`-t ad, az atmenet elutasitva. */
-    guard?: (ctx?: TContext) => boolean | Promise<boolean>;
-    /** Optional side-effect a state-valtas ELOTT. */
-    onLeave?: (ctx?: TContext) => Promise<void>;
-    /** Optional side-effect a state-valtas UTAN, a `persist` elott. */
-    onEnter?: (ctx?: TContext) => Promise<void>;
-}
+/**
+ * Egyetlen atmenet (transition) leiras a `DyFM_StateMachine` transitionMap-jeben.
+ *
+ * `from` lehet:
+ *  - egy konkret state (TState)
+ *  - tobb state array-je
+ *  - `'*'` wildcard (barmely jelenlegi state)
+ *
+ * `guard` opcionalis pre-check: ha visszater `false` (vagy resolved-`false` Promise),
+ * az atmenet visszautasitva `'guard-rejected'` reason-nel.
+ *
+ * `onLeave` opcionalis side-effect ami a state-valtas ELOTT fut. Throw-ja
+ * `'on-leave-failed'` reason-t valt ki.
+ *
+ * `onEnter` opcionalis side-effect ami az uj state beallitasa UTAN, de a
+ * `persist` callback elott fut. Throw-ja `'on-enter-failed'` reason-t valt ki
+ * — ilyenkor a state visszaall (revert).
+ */
+export interface DyFM_StateTransition<TState extends string, TContext = unknown> {
+    /** Forras state(ek). Wildcard `'*'` = barmilyen jelenlegi state. */
+    from: TState | TState[] | '*';
+    /** Cel state. */
+    to: TState;
+    /** Optional pre-check; ha `false`-t ad, az atmenet elutasitva. */
+    guard?: (ctx?: TContext) => boolean | Promise<boolean>;
+    /** Optional side-effect a state-valtas ELOTT. */
+    onLeave?: (ctx?: TContext) => Promise<void>;
+    /** Optional side-effect a state-valtas UTAN, a `persist` elott. */
+    onEnter?: (ctx?: TContext) => Promise<void>;
+}
 //# sourceMappingURL=state-transition.interface.d.ts.map

package/build/_modules/state-machine/_models/state-transition.interface.js

@@ -1,3 +1,3 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
 //# sourceMappingURL=state-transition.interface.js.map

package/build/_modules/state-machine/index.d.ts

@@ -1,6 +1,6 @@
-export * from './_models/state-machine.control-model';
-export * from './_models/state-machine-config.interface';
-export * from './_models/state-machine-event.interface';
-export * from './_models/state-transition.interface';
-export * from './_models/state-transition-result.interface';
+export * from './_models/state-machine.control-model';
+export * from './_models/state-machine-config.interface';
+export * from './_models/state-machine-event.interface';
+export * from './_models/state-transition.interface';
+export * from './_models/state-transition-result.interface';
 //# sourceMappingURL=index.d.ts.map

package/build/_modules/state-machine/index.js

@@ -1,10 +1,10 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-// MODELS
-tslib_1.__exportStar(require("./_models/state-machine.control-model"), exports);
-tslib_1.__exportStar(require("./_models/state-machine-config.interface"), exports);
-tslib_1.__exportStar(require("./_models/state-machine-event.interface"), exports);
-tslib_1.__exportStar(require("./_models/state-transition.interface"), exports);
-tslib_1.__exportStar(require("./_models/state-transition-result.interface"), exports);
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+// MODELS
+tslib_1.__exportStar(require("./_models/state-machine.control-model"), exports);
+tslib_1.__exportStar(require("./_models/state-machine-config.interface"), exports);
+tslib_1.__exportStar(require("./_models/state-machine-event.interface"), exports);
+tslib_1.__exportStar(require("./_models/state-transition.interface"), exports);
+tslib_1.__exportStar(require("./_models/state-transition-result.interface"), exports);
 //# sourceMappingURL=index.js.map

package/build/_modules/test/_collections/tst-module-settings.const.d.ts

@@ -1,47 +1,47 @@
-import { DyFM_EndpointTypesContainer, DyFM_ServiceEndpointTypesSettings } from '../../../_models/control-models/service-endpoint-settings-base.control-model';
-import { DyFM_Route_Settings } from '../../../_models/interfaces/route-settings.interface';
-/**
- * Routes used by the test module.
- */
-export declare enum DyFM_TestRoute {
-    testGet = "test-get",
-    testPost = "test-post",
-    testPut = "test-put",
-    testPatch = "test-patch",
-    testDelete = "test-delete",
-    getServerStatus = "get-server-status"
-}
-/**
- * Default route settings for the test module.
- */
-export declare const DyFM_testModule_settings: DyFM_Route_Settings<DyFM_TestRoute>;
-/**
- * Map of routes with their full path.
- */
-export declare const DyFM_fullTestRoute: {
-    "test-get": string;
-    "test-post": string;
-    "test-put": string;
-    "test-patch": string;
-    "test-delete": string;
-    "get-server-status": string;
-};
-export interface DyFM_Test_EndpointTypeSettings extends DyFM_ServiceEndpointTypesSettings {
-    [DyFM_TestRoute.testGet]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
-    [DyFM_TestRoute.testPost]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
-    [DyFM_TestRoute.testPut]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
-    [DyFM_TestRoute.testPatch]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
-    [DyFM_TestRoute.testDelete]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
-    [DyFM_TestRoute.getServerStatus]: DyFM_EndpointTypesContainer<{
-        status: 'ready';
-        version: string;
-        upTime: number;
-    }>;
-}
-interface DyFM_Test_Result {
-    url: string;
-    result: string;
-    request: any;
-}
-export {};
+import { DyFM_EndpointTypesContainer, DyFM_ServiceEndpointTypesSettings } from '../../../_models/control-models/service-endpoint-settings-base.control-model';
+import { DyFM_Route_Settings } from '../../../_models/interfaces/route-settings.interface';
+/**
+ * Routes used by the test module.
+ */
+export declare enum DyFM_TestRoute {
+    testGet = "test-get",
+    testPost = "test-post",
+    testPut = "test-put",
+    testPatch = "test-patch",
+    testDelete = "test-delete",
+    getServerStatus = "get-server-status"
+}
+/**
+ * Default route settings for the test module.
+ */
+export declare const DyFM_testModule_settings: DyFM_Route_Settings<DyFM_TestRoute>;
+/**
+ * Map of routes with their full path.
+ */
+export declare const DyFM_fullTestRoute: {
+    "test-get": string;
+    "test-post": string;
+    "test-put": string;
+    "test-patch": string;
+    "test-delete": string;
+    "get-server-status": string;
+};
+export interface DyFM_Test_EndpointTypeSettings extends DyFM_ServiceEndpointTypesSettings {
+    [DyFM_TestRoute.testGet]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
+    [DyFM_TestRoute.testPost]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
+    [DyFM_TestRoute.testPut]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
+    [DyFM_TestRoute.testPatch]: DyFM_EndpointTypesContainer<DyFM_Test_Result, any, any>;
+    [DyFM_TestRoute.testDelete]: DyFM_EndpointTypesContainer<DyFM_Test_Result>;
+    [DyFM_TestRoute.getServerStatus]: DyFM_EndpointTypesContainer<{
+        status: 'ready';
+        version: string;
+        upTime: number;
+    }>;
+}
+interface DyFM_Test_Result {
+    url: string;
+    result: string;
+    request: any;
+}
+export {};
 //# sourceMappingURL=tst-module-settings.const.d.ts.map