@atlantjs/backend 11.0.20 → 11.0.22

package/index.d.ts

@@ -5,6 +5,9 @@ export { NextFunction, Request, RequestHandler, Response } from "express";
 export { HttpContentTypePoint } from "./backend/boundary/forces/thetas/http-content-type.point";
 export { Get, Post, Put, Patch, Delete, } from "./backend/boundary/forces/thetas/http-method.theta";
 export { APP_PORT, LOAD_MODULES, CORS_ALLOWED_ORIGINS, ENVIRONMENT, } from "./backend/stitch/verses";
+export { getBoundary } from "./setup-test/get-boundary";
+export { FakeServer } from "./setup-test/faker-server";
+export { createWorkStub } from "./setup-test/create-work-stub";
 export { ThetaHandlerAbstract } from "./backend/mesh/thetas/theta.handler.abstract";
 export { ProviderAbstract } from "./backend/mesh/providers/provider.abstract";
 export { RepositoryAbstract } from "./backend/mesh/repositories/repository.abstract";

package/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.EmailDeliveryProvider = exports.ForceResponse = exports.StitchesAbstract = exports.initialize = exports.stitchable = exports.toStitch = exports.Server = exports.DefaultErrorHandlerTheta = exports.CorsTheta = exports.BodyParserTheta = exports.DiContainerAbstract = exports.diContainer = exports.startContainer = exports.ValidatorAbstract = exports.ForceAbstract = exports.WorkAbstract = exports.ServiceAbstract = exports.RepositoryAbstract = exports.ProviderAbstract = exports.ThetaHandlerAbstract = exports.ENVIRONMENT = exports.CORS_ALLOWED_ORIGINS = exports.LOAD_MODULES = exports.APP_PORT = exports.Delete = exports.Patch = exports.Put = exports.Post = exports.Get = exports.HttpContentTypePoint = exports.QueryParam = exports.Param = exports.Req = exports.Body = exports.Res = exports.JsonForce = exports.UseBefore = exports.getFromContainer = void 0;
+exports.EmailDeliveryProvider = exports.ForceResponse = exports.StitchesAbstract = exports.initialize = exports.stitchable = exports.toStitch = exports.Server = exports.DefaultErrorHandlerTheta = exports.CorsTheta = exports.BodyParserTheta = exports.DiContainerAbstract = exports.diContainer = exports.startContainer = exports.ValidatorAbstract = exports.ForceAbstract = exports.WorkAbstract = exports.ServiceAbstract = exports.RepositoryAbstract = exports.ProviderAbstract = exports.ThetaHandlerAbstract = exports.createWorkStub = exports.FakeServer = exports.getBoundary = exports.ENVIRONMENT = exports.CORS_ALLOWED_ORIGINS = exports.LOAD_MODULES = exports.APP_PORT = exports.Delete = exports.Patch = exports.Put = exports.Post = exports.Get = exports.HttpContentTypePoint = exports.QueryParam = exports.Param = exports.Req = exports.Body = exports.Res = exports.JsonForce = exports.UseBefore = exports.getFromContainer = void 0;
 require("./backend/stitch/verses/load-verses");
 require("reflect-metadata");
 const setup_1 = require("./setup");
@@ -27,6 +27,12 @@ Object.defineProperty(exports, "APP_PORT", { enumerable: true, get: function ()
 Object.defineProperty(exports, "LOAD_MODULES", { enumerable: true, get: function () { return verses_1.LOAD_MODULES; } });
 Object.defineProperty(exports, "CORS_ALLOWED_ORIGINS", { enumerable: true, get: function () { return verses_1.CORS_ALLOWED_ORIGINS; } });
 Object.defineProperty(exports, "ENVIRONMENT", { enumerable: true, get: function () { return verses_1.ENVIRONMENT; } });
+var get_boundary_1 = require("./setup-test/get-boundary");
+Object.defineProperty(exports, "getBoundary", { enumerable: true, get: function () { return get_boundary_1.getBoundary; } });
+var faker_server_1 = require("./setup-test/faker-server");
+Object.defineProperty(exports, "FakeServer", { enumerable: true, get: function () { return faker_server_1.FakeServer; } });
+var create_work_stub_1 = require("./setup-test/create-work-stub");
+Object.defineProperty(exports, "createWorkStub", { enumerable: true, get: function () { return create_work_stub_1.createWorkStub; } });
 var theta_handler_abstract_1 = require("./backend/mesh/thetas/theta.handler.abstract");
 Object.defineProperty(exports, "ThetaHandlerAbstract", { enumerable: true, get: function () { return theta_handler_abstract_1.ThetaHandlerAbstract; } });
 var provider_abstract_1 = require("./backend/mesh/providers/provider.abstract");

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@atlantjs/backend",
-	"version": "11.0.20",
+	"version": "11.0.22",
 	"main": "index.js",
 	"license": "UNLICENSED",
 	"publishConfig": {
@@ -11,7 +11,7 @@
 		"test": "tests"
 	},
 	"engines": {
-		"node": "22.19.x"
+		"node": "24.16.x"
 	},
 	"repository": {
 		"type": "git",
@@ -34,7 +34,7 @@
 		"@atlantjs/arch": "15.4.2",
 		"@atlantjs/database": "2.1.10",
 		"@atlantjs/parchment": "1.0.28",
-		"@aws-sdk/client-ses": "3.1009.0",
+		"@aws-sdk/client-ses": "3.1057.0",
 		"@types/signale": "^1.4.7",
 		"body-parser": "1.20.2",
 		"cfonts": "^3.3.1",
@@ -53,17 +53,18 @@
 		"resend": "6.9.3",
 		"routing-controllers": "0.10.4",
 		"routing-controllers-openapi": "4.0.0",
-		"signale": "^1.4.0"
+		"signale": "^1.4.0",
+		"supertest": "^7.2.2"
 	},
 	"devDependencies": {
-		"@biomejs/biome": "1.9.4",
+		"@biomejs/biome": "2.4.16",
 		"@types/cookie-parser": "1.4.8",
 		"@types/cors": "2.8.17",
 		"@types/express": "5.0.0",
 		"@types/lodash": "4.17.16",
 		"@types/node": "22.13.5",
 		"copyfiles": "2.4.1",
-		"cross-env": "7.0.3",
+		"cross-env": "10.1.0",
 		"ts-node": "10.9.2",
 		"ts-node-dev": "2.0.0",
 		"tsconfig-paths": "4.2.0",

package/setup/index.d.ts

@@ -2,7 +2,7 @@ import { Newable } from "@atlantjs/arch";
 import { DatabaseConfigAbstract, DatabaseHelperAbstract, DatabaseLiteConfigAbstract } from "@atlantjs/database";
 import express from "express";
 import { interfaces } from "inversify";
-interface ServerProps {
+export interface ServerProps {
     databases?: Array<{
         token: interfaces.ServiceIdentifier<unknown>;
         target: InstanceType<typeof DatabaseHelperAbstract>;
@@ -11,4 +11,3 @@ interface ServerProps {
 }
 export declare function initialize(props: ServerProps): Promise<express.Application | undefined>;
 export declare function synthesizePaths(): void;
-export {};

package/setup-test/create-work-stub.d.ts

@@ -0,0 +1,8 @@
+import { WorkAbstract } from "../backend/mesh/works/work.abstract";
+import { Return } from "@atlantjs/arch";
+declare class WorkStub implements WorkAbstract {
+    execute(...args: unknown[]): Promise<Return<unknown, unknown>>;
+    emitting<ARG>(event: "success" | "failure", arg?: ARG): void;
+}
+export declare function createWorkStub<T extends WorkAbstract>(): WorkStub & T;
+export {};

package/setup-test/create-work-stub.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createWorkStub = createWorkStub;
+const arch_1 = require("@atlantjs/arch");
+class WorkStub {
+    execute(...args) {
+        throw new Error("Method not implemented.");
+    }
+    emitting(event, arg) {
+        this.execute = async () => {
+            if (event === "success") {
+                return (0, arch_1.Success)(arg);
+            }
+            if (arg instanceof arch_1.FailureAbstract || arg instanceof Error)
+                return (0, arch_1.Failure)(arg);
+            throw new Error("Invalid argument provided to emitting method. Expected a FailureAbstract or an Error instance for 'failure' events.");
+        };
+    }
+}
+function createWorkStub() {
+    return new WorkStub();
+}

package/setup-test/faker-server.d.ts

@@ -0,0 +1,9 @@
+import TestAgent from "supertest/lib/agent";
+import e from "express";
+import { ServerProps } from "../setup";
+export declare class FakeServer {
+    private static server;
+    static set(server: e.Application): void;
+    static initialize(props: ServerProps): Promise<void>;
+    static get request(): TestAgent;
+}

package/setup-test/faker-server.js

@@ -0,0 +1,37 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FakeServer = void 0;
+const supertest_1 = __importDefault(require("supertest"));
+const setup_1 = require("../setup");
+class FakeServer {
+    static set(server) {
+        FakeServer.server = (0, supertest_1.default)(server);
+    }
+    static initialize(props) {
+        return new Promise((resolve, reject) => {
+            (0, setup_1.initialize)(props)
+                .then((app) => {
+                if (app) {
+                    FakeServer.set(app);
+                    resolve();
+                }
+                else {
+                    reject(new Error("Failed to initialize the fake server."));
+                }
+            })
+                .catch((error) => {
+                reject(error);
+            });
+        });
+    }
+    static get request() {
+        if (!FakeServer.server) {
+            throw new Error("Server not set. Please call FakerServer.set() before FakerServer.getInstance().");
+        }
+        return FakeServer.server;
+    }
+}
+exports.FakeServer = FakeServer;

package/setup-test/get-boundary.d.ts

@@ -0,0 +1,2 @@
+import { interfaces } from "inversify";
+export declare function getBoundary<T>(stitchPoint: interfaces.ServiceIdentifier<unknown>): T;

package/setup-test/get-boundary.js

@@ -0,0 +1,20 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBoundary = getBoundary;
+const di_container_1 = require("../setup/dependency-injections/di-container");
+function getBoundary(stitchPoint) {
+    let token;
+    if (!di_container_1.diContainer.isBound(stitchPoint)) {
+        // access internal binding keys and find a matching symbol by description
+        // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+        // @ts-ignore
+        const keys = di_container_1.diContainer._bindingDictionary?._map
+            ? // @ts-ignore
+                Array.from(di_container_1.diContainer._bindingDictionary._map.keys())
+            : [];
+        const found = keys.find((k) => String(k) === String(stitchPoint));
+        if (found)
+            token = found;
+    }
+    return di_container_1.diContainer.get(token);
+}

package/setup-test/test-setup.d.ts

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

package/setup-test/test-setup.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+// allow require() to load TypeScript source files during tests
+require("ts-node/register/transpile-only");
+const node_fs_1 = require("node:fs");
+const node_path_1 = require("node:path");
+const dotenv_1 = require("dotenv");
+const setup_1 = require("../setup");
+(0, setup_1.synthesizePaths)();
+const envConfig = (0, dotenv_1.parse)((0, node_fs_1.readFileSync)((0, node_path_1.join)(__dirname, "..", "..", "..", "..", ".env.test")));
+for (const key in envConfig) {
+    if (!envConfig[key].startsWith("$")) {
+        process.env[key] = envConfig[key];
+    }
+}