@hz-9/a5-core 0.2.0-alpha.1

package/dist/interface/http.js

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

package/dist/interface/index.d.ts

@@ -0,0 +1,3 @@
+export * from './base';
+export * from './http';
+export * from './provide-token';

package/dist/interface/index.js

@@ -0,0 +1,20 @@
+"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("./base"), exports);
+__exportStar(require("./http"), exports);
+__exportStar(require("./provide-token"), exports);
+//# sourceMappingURL=index.js.map

package/dist/interface/provide-token.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @public
+ *
+ *  `A5` 全局提供者 Token。
+ *
+ */
+export type A5GlobalProvideToken = `Global.A5.${string}`;
+/**
+ * @public
+ *
+ * `A5` 作用域提供者 Token。
+ *
+ */
+export type A5ScopeProvideToken = `Scope.A5.${string}`;
+/**
+ * @public
+ *
+ * `A5` 配置项路径。
+ *
+ */
+export type A5ModuleConfigPath = `A5.${string}`;

package/dist/interface/provide-token.js

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

package/dist/middleware/a5-console-logger.middleware.d.ts

@@ -0,0 +1,9 @@
+import { Logger, NestMiddleware } from '@nestjs/common';
+import type { FastifyReplyRaw, FastifyRequestRaw } from '../interface/http';
+/**
+ * @public
+ */
+export declare class A5ConsoleLoggerMiddleware implements NestMiddleware {
+    protected logger: Logger;
+    use(req: FastifyRequestRaw, res: FastifyReplyRaw, next: () => void): void;
+}

package/dist/middleware/a5-console-logger.middleware.js

@@ -0,0 +1,58 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.A5ConsoleLoggerMiddleware = void 0;
+const common_1 = require("@nestjs/common");
+/**
+ * @public
+ */
+let A5ConsoleLoggerMiddleware = class A5ConsoleLoggerMiddleware {
+    constructor() {
+        this.logger = new common_1.Logger('HttpRequest');
+    }
+    use(req, res, next) {
+        const { method, headers, httpVersion, socket } = req;
+        const st = Date.now();
+        let bytes = 0;
+        // 保存原始 write 和 end 方法
+        const originalWrite = res.write;
+        const originalEnd = res.end;
+        // eslint-disable-next-line func-names
+        res.write = function (chunk, ...args) {
+            if (chunk) {
+                bytes += Buffer.isBuffer(chunk) ? chunk.length : Buffer.byteLength(chunk);
+            }
+            // @ts-ignore
+            return originalWrite.apply(this, [chunk, ...args]);
+        };
+        // eslint-disable-next-line func-names
+        res.end = function (chunk, ...args) {
+            if (chunk) {
+                bytes += Buffer.isBuffer(chunk) ? chunk.length : Buffer.byteLength(chunk);
+            }
+            // @ts-ignore
+            return originalEnd.apply(this, [chunk, ...args]);
+        };
+        res.on('finish', () => {
+            const { statusCode } = res;
+            const remoteAddr = socket?.remoteAddress || '-';
+            const requestTime = Date.now() - st;
+            const referer = headers.referer || '-';
+            const userAgent = headers['user-agent'] || '-';
+            // Nginx access log 格式
+            this.logger.log(`${remoteAddr} - "${method} ${req.url} HTTP/${httpVersion}" ${statusCode} ${bytes} ${requestTime}ms "${referer}" "${userAgent}"`);
+        });
+        // TODO 如果请求失败了，或各种情况，怎么处理?
+        next();
+    }
+};
+exports.A5ConsoleLoggerMiddleware = A5ConsoleLoggerMiddleware;
+exports.A5ConsoleLoggerMiddleware = A5ConsoleLoggerMiddleware = __decorate([
+    (0, common_1.Injectable)()
+], A5ConsoleLoggerMiddleware);
+//# sourceMappingURL=a5-console-logger.middleware.js.map

package/dist/middleware/index.d.ts

@@ -0,0 +1 @@
+export * from './a5-console-logger.middleware';

package/dist/middleware/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("./a5-console-logger.middleware"), exports);
+//# sourceMappingURL=index.js.map

package/dist/module/config/index.d.ts

@@ -0,0 +1,18 @@
+import type { A5GlobalProvideToken } from '../../interface';
+export * from './interface';
+/**
+ *
+ * @public
+ *
+ *   `A5 Config Module` Config Path
+ *
+ */
+export declare const MODULE_CONFIG_PATH_A5_CONFIG: <T extends string>(str: T) => `A5.config.${T}`;
+/**
+ *
+ * @public
+ *
+ *   `A5 Log Module` Global Provide Token
+ *
+ */
+export declare const GLOBAL_PROVIDE_TOKEN_A5_CONFIG: A5GlobalProvideToken;

package/dist/module/config/index.js

@@ -0,0 +1,36 @@
+"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 });
+exports.GLOBAL_PROVIDE_TOKEN_A5_CONFIG = exports.MODULE_CONFIG_PATH_A5_CONFIG = void 0;
+__exportStar(require("./interface"), exports);
+/**
+ *
+ * @public
+ *
+ *   `A5 Config Module` Config Path
+ *
+ */
+const MODULE_CONFIG_PATH_A5_CONFIG = (str) => `A5.config.${str}`;
+exports.MODULE_CONFIG_PATH_A5_CONFIG = MODULE_CONFIG_PATH_A5_CONFIG;
+/**
+ *
+ * @public
+ *
+ *   `A5 Log Module` Global Provide Token
+ *
+ */
+exports.GLOBAL_PROVIDE_TOKEN_A5_CONFIG = 'Global.A5.Config';
+//# sourceMappingURL=index.js.map

package/dist/module/config/interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @public
+ *
+ *  `A5 Config Module` 抽象类。
+ *
+ */
+export declare abstract class IA5ConfigModule {
+}

package/dist/module/config/interface.js

@@ -0,0 +1,15 @@
+"use strict";
+// import { LoggerService } from '@nestjs/common'
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IA5ConfigModule = void 0;
+/**
+ *
+ * @public
+ *
+ *  `A5 Config Module` 抽象类。
+ *
+ */
+class IA5ConfigModule {
+}
+exports.IA5ConfigModule = IA5ConfigModule;
+//# sourceMappingURL=interface.js.map

package/dist/module/index.d.ts

@@ -0,0 +1,2 @@
+export * from './config';
+export * from './log';

package/dist/module/index.js

@@ -0,0 +1,19 @@
+"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("./config"), exports);
+__exportStar(require("./log"), exports);
+//# sourceMappingURL=index.js.map

package/dist/module/log/index.d.ts

@@ -0,0 +1,18 @@
+import type { A5GlobalProvideToken } from '../../interface';
+export * from './interface';
+/**
+ *
+ * @public
+ *
+ *   `A5 Log Module` Config Path
+ *
+ */
+export declare const MODULE_CONFIG_PATH_A5_LOG: <T extends string>(str: T) => `A5.log.${T}`;
+/**
+ *
+ * @public
+ *
+ *   `A5 Log Module` Global Provide Token
+ *
+ */
+export declare const GLOBAL_PROVIDE_TOKEN_A5_LOG_LOGGER: A5GlobalProvideToken;

package/dist/module/log/index.js

@@ -0,0 +1,44 @@
+"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 });
+exports.GLOBAL_PROVIDE_TOKEN_A5_LOG_LOGGER = exports.MODULE_CONFIG_PATH_A5_LOG = void 0;
+__exportStar(require("./interface"), exports);
+/**
+ *
+ * @public
+ *
+ *   `A5 Log Module` Config Path
+ *
+ */
+const MODULE_CONFIG_PATH_A5_LOG = (str) => `A5.log.${str}`;
+exports.MODULE_CONFIG_PATH_A5_LOG = MODULE_CONFIG_PATH_A5_LOG;
+/**
+ *
+ * @public
+ *
+ *   `A5 Log Module` Global Provide Token
+ *
+ */
+exports.GLOBAL_PROVIDE_TOKEN_A5_LOG_LOGGER = 'Global.A5.Log.Logger';
+// /**
+//  *
+//  * @public
+//  *
+//  *   `A5 Log Module` Scope Provide Token
+//  *
+//  */
+// export const SCOPE_PROVIDE_TOKEN_A5_LOGGER: A5ScopeProvideToken = 'Scope.A5.Log'
+//# sourceMappingURL=index.js.map

package/dist/module/log/interface.d.ts

@@ -0,0 +1,9 @@
+/**
+ *
+ * @public
+ *
+ *  `A5 Log Module` 抽象类。
+ *
+ */
+export declare abstract class IA5LogModule {
+}

package/dist/module/log/interface.js

@@ -0,0 +1,15 @@
+"use strict";
+// import { LoggerService } from '@nestjs/common'
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IA5LogModule = void 0;
+/**
+ *
+ * @public
+ *
+ *  `A5 Log Module` 抽象类。
+ *
+ */
+class IA5LogModule {
+}
+exports.IA5LogModule = IA5LogModule;
+//# sourceMappingURL=interface.js.map

package/dist/plugins/index.d.ts

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

package/dist/plugins/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("./nanoid"), exports);
+//# sourceMappingURL=index.js.map

package/dist/plugins/nanoid.d.ts

@@ -0,0 +1 @@
+export { nanoid } from 'nanoid';

package/dist/plugins/nanoid.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.nanoid = void 0;
+var nanoid_1 = require("nanoid");
+Object.defineProperty(exports, "nanoid", { enumerable: true, get: function () { return nanoid_1.nanoid; } });
+//# sourceMappingURL=nanoid.js.map

package/dist/test/integration/core/a5-factory.integration.spec.d.ts

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

package/dist/test/integration/core/a5-factory.integration.spec.js

@@ -0,0 +1,99 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable @typescript-eslint/consistent-type-definitions */
+const core_1 = require("../../../core");
+const util_1 = require("../../../util");
+const node_console_1 = __importDefault(require("node:console"));
+const common_1 = require("@nestjs/common");
+describe('A5Factory', () => {
+    describe('create', () => {
+        describe('printLogo', () => {
+            const toClearLines = (lines) => lines.map(([text]) => util_1.ColorUtil.clear(text));
+            let logoLines = [];
+            beforeAll(async () => {
+                const logSpy = jest.spyOn(node_console_1.default, 'log').mockImplementation();
+                util_1.LogoUtil.print();
+                // 验证完整的日志输出格式（移除 ANSI 颜色代码后验证）
+                logoLines = toClearLines(logSpy.mock.calls);
+                logSpy.mockRestore();
+            });
+            it('default', async () => {
+                const logSpy = jest.spyOn(process.stdout, 'write').mockImplementation();
+                let AppModule = class AppModule {
+                };
+                AppModule = __decorate([
+                    (0, common_1.Module)({})
+                ], AppModule);
+                const app = await core_1.A5Factory.create(AppModule);
+                expect(app.options.logger).toBeInstanceOf(core_1.A5ConsoleLogger);
+                await app.close();
+                // 验证完整的日志输出格式（移除 ANSI 颜色代码后验证）
+                const lines = toClearLines(logSpy.mock.calls);
+                logSpy.mockRestore();
+                // lines[0]
+                expect(lines.length).toBe(7);
+                expect(lines[0].replace(/\n$/, '')).toBe(logoLines[0]);
+                expect(lines[1].replace(/\n$/, '')).toBe(logoLines[1]);
+                expect(lines[2].replace(/\n$/, '')).toBe(logoLines[2]);
+                expect(lines[3].trimEnd()).toMatch(/WARN \[A5Application \] Not loaded A5 Logger Provider, using 'A5ConsoleLogger'$/);
+                expect(lines[4].trimEnd()).toMatch(/ LOG \[A5Factory     \] Starting A5 application...$/);
+                expect(lines[5].trimEnd()).toMatch(/ LOG \[InstanceLoader\] AppModule dependencies initialized$/);
+                expect(lines[6].trimEnd()).toMatch(/ LOG \[A5Application \] A5 application successfully started$/);
+            });
+            it('true', async () => {
+                const logSpy = jest.spyOn(process.stdout, 'write').mockImplementation();
+                let AppModule = class AppModule {
+                };
+                AppModule = __decorate([
+                    (0, common_1.Module)({})
+                ], AppModule);
+                const app = await core_1.A5Factory.create(AppModule, { printLogo: true });
+                expect(app.options.logger).toBeInstanceOf(core_1.A5ConsoleLogger);
+                await app.close();
+                // 验证完整的日志输出格式（移除 ANSI 颜色代码后验证）
+                const lines = toClearLines(logSpy.mock.calls);
+                logSpy.mockRestore();
+                // lines[0]
+                expect(lines.length).toBe(7);
+                expect(lines[0].replace(/\n$/, '')).toBe(logoLines[0]);
+                expect(lines[1].replace(/\n$/, '')).toBe(logoLines[1]);
+                expect(lines[2].replace(/\n$/, '')).toBe(logoLines[2]);
+                expect(lines[3].trimEnd()).toMatch(/WARN \[A5Application \] Not loaded A5 Logger Provider, using 'A5ConsoleLogger'$/);
+                expect(lines[4].trimEnd()).toMatch(/ LOG \[A5Factory     \] Starting A5 application...$/);
+                expect(lines[5].trimEnd()).toMatch(/ LOG \[InstanceLoader\] AppModule dependencies initialized$/);
+                expect(lines[6].trimEnd()).toMatch(/ LOG \[A5Application \] A5 application successfully started$/);
+            });
+            it('false', async () => {
+                const logSpy = jest.spyOn(process.stdout, 'write').mockImplementation();
+                let AppModule = class AppModule {
+                };
+                AppModule = __decorate([
+                    (0, common_1.Module)({})
+                ], AppModule);
+                const app = await core_1.A5Factory.create(AppModule, {
+                    printLogo: false,
+                });
+                expect(app.options.logger).toBeInstanceOf(core_1.A5ConsoleLogger);
+                await app.close();
+                // 验证完整的日志输出格式（移除 ANSI 颜色代码后验证）
+                const lines = toClearLines(logSpy.mock.calls);
+                logSpy.mockRestore();
+                expect(lines.length).toBe(4);
+                expect(lines[0].trimEnd()).toMatch(/WARN \[A5Application \] Not loaded A5 Logger Provider, using 'A5ConsoleLogger'$/);
+                expect(lines[1].trimEnd()).toMatch(/ LOG \[A5Factory     \] Starting A5 application...$/);
+                expect(lines[2].trimEnd()).toMatch(/ LOG \[InstanceLoader\] AppModule dependencies initialized$/);
+                expect(lines[3].trimEnd()).toMatch(/ LOG \[A5Application \] A5 application successfully started$/);
+            });
+        });
+    });
+});
+//# sourceMappingURL=a5-factory.integration.spec.js.map

package/dist/test/integration/core/with-logger-module.integration.spec.d.ts

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