@epoint-testtech/stage-core 0.0.3-alpha.1 → 0.0.4-alpha.0

package/README.md

@@ -1,20 +1,20 @@
-# @epoint/stage-core
+# @epoint-testtech/stage-core
 
 > Epoint Stage — Playwright 测试框架核心库
 
 ## 安装
 
 ```bash
-npm install @epoint/stage-core
+npm install @epoint-testtech/stage-core
 # 或
-pnpm add @epoint/stage-core
+pnpm add @epoint-testtech/stage-core
 ```
 
 ## 使用
 
 ```typescript
-import { StageContext, StagePath, stageLocator, syncAutoFill } from '@epoint/stage-core';
-import { log } from '@epoint/stage-core/utils';
+import { StageContext, StagePath, stageLocator, syncAutoFill } from '@epoint-testtech/stage-core';
+import { log } from '@epoint-testtech/stage-core/utils';
 
 StageContext.init();
 await syncAutoFill(page);

package/dist/index.d.ts

@@ -8,4 +8,6 @@ export { apiCall, extract } from "./core/stage-api.js";
 export type { ApiVia, ApiCallOptions, ApiResponse, } from "./core/stage-api.js";
 export { renderFlowReportHtml, writeFlowReport, loadRunRecords, writeRunRecord, runRecordFile, } from "./core/stage-report.js";
 export type { FlowRunRecord, FlowRunStepResult, StepRunStatus, WriteReportOptions, } from "./core/stage-report.js";
+export { loadCredentials } from "./utils/credentials-util.js";
+export type { Credential } from "./utils/credentials-util.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,MAAM,EACN,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,gBAAgB,GACjB,MAAM,6BAA6B,CAAC;AACrC,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AACvD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,YAAY,EACV,eAAe,EACf,aAAa,EACb,gBAAgB,EAChB,mBAAmB,GACpB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AACvD,YAAY,EACV,MAAM,EACN,cAAc,EACd,WAAW,GACZ,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,oBAAoB,EACpB,eAAe,EACf,cAAc,EACd,cAAc,EACd,aAAa,GACd,MAAM,wBAAwB,CAAC;AAChC,YAAY,EACV,aAAa,EACb,iBAAiB,EACjB,aAAa,EACb,kBAAkB,GACnB,MAAM,wBAAwB,CAAC;AAChC,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,YAAY,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAC"}

package/dist/index.js

@@ -5,3 +5,4 @@ export { stageLocator } from "./core/stage-locator.js";
 export { runStageFlow } from "./core/stage-flow.js";
 export { apiCall, extract } from "./core/stage-api.js";
 export { renderFlowReportHtml, writeFlowReport, loadRunRecords, writeRunRecord, runRecordFile, } from "./core/stage-report.js";
+export { loadCredentials } from "./utils/credentials-util.js";

package/dist/utils/credentials-util.d.ts

@@ -0,0 +1,34 @@
+/**
+ * @Description: 凭据加载工具 — 读 credentials.json5 数组形态多角色凭据。
+ *               供 glue 项目内 Playwright 测试代码登录切换使用（REQ-ENV-02）。
+ * @Author: taurus
+ * @Date: 2026/06/25
+ */
+/**
+ * 凭据条目（数组形态 credentials.json5 单元素结构）。
+ */
+export type Credential = {
+    /** 登录页 URL（必填） */
+    url: string;
+    /** 登录账号（必填） */
+    username: string;
+    /** 登录密码（必填） */
+    password: string;
+    /** 角色名（可选；用于 Playwright 多角色登录切换） */
+    role?: string;
+    /** 系统名（可选；便于审阅与报告打印） */
+    systemName?: string;
+};
+/**
+ * 从 credentials.json5 读取数组形态凭据，按 role 匹配。
+ *
+ * 适用场景：胶水项目内 Playwright 测试代码登录切换。一个需求可能涉及多系统、
+ * 多角色，credentials.json5 数组每项一个角色。
+ *
+ * @param credentialsPath - credentials.json5 绝对路径。
+ * @param role - 可选角色过滤；不传时返回全部条目。
+ * @returns 匹配的凭据数组（无 role 过滤时返回所有；传 role 后返回 `role === role` 的子集）。
+ * @throws 文件不存在或非数组时抛出可读中文错误。
+ */
+export declare function loadCredentials(credentialsPath: string, role?: string): Credential[];
+//# sourceMappingURL=credentials-util.d.ts.map

package/dist/utils/credentials-util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"credentials-util.d.ts","sourceRoot":"","sources":["../../src/utils/credentials-util.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAKH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG;IACvB,kBAAkB;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,eAAe;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,oCAAoC;IACpC,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,wBAAwB;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,CAAC;AAEF;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAAC,eAAe,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CAUpF"}

package/dist/utils/credentials-util.js

@@ -0,0 +1,30 @@
+/**
+ * @Description: 凭据加载工具 — 读 credentials.json5 数组形态多角色凭据。
+ *               供 glue 项目内 Playwright 测试代码登录切换使用（REQ-ENV-02）。
+ * @Author: taurus
+ * @Date: 2026/06/25
+ */
+import { readFileSync, existsSync } from 'node:fs';
+import JSON5 from 'json5';
+/**
+ * 从 credentials.json5 读取数组形态凭据，按 role 匹配。
+ *
+ * 适用场景：胶水项目内 Playwright 测试代码登录切换。一个需求可能涉及多系统、
+ * 多角色，credentials.json5 数组每项一个角色。
+ *
+ * @param credentialsPath - credentials.json5 绝对路径。
+ * @param role - 可选角色过滤；不传时返回全部条目。
+ * @returns 匹配的凭据数组（无 role 过滤时返回所有；传 role 后返回 `role === role` 的子集）。
+ * @throws 文件不存在或非数组时抛出可读中文错误。
+ */
+export function loadCredentials(credentialsPath, role) {
+    if (!existsSync(credentialsPath)) {
+        throw new Error(`credentials.json5 不存在: ${credentialsPath}`);
+    }
+    const raw = JSON5.parse(readFileSync(credentialsPath, 'utf8'));
+    if (!Array.isArray(raw)) {
+        throw new Error(`credentials.json5 顶层必须是数组形态: ${credentialsPath}`);
+    }
+    const all = raw;
+    return role ? all.filter((c) => c.role === role) : all;
+}

package/dist/utils/index.d.ts

@@ -6,4 +6,6 @@
 export { getRequiredEnvVar, getOptionalEnvVar } from './env-util.js';
 export { log } from './log-util.js';
 export { addTimeStampPrefix, generateTimeStamp } from './time-stamp-util.js';
+export { loadCredentials } from './credentials-util.js';
+export type { Credential } from './credentials-util.js';
 //# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACrE,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AACpC,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAC7E,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,YAAY,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/utils/index.js

@@ -6,3 +6,4 @@
 export { getRequiredEnvVar, getOptionalEnvVar } from './env-util.js';
 export { log } from './log-util.js';
 export { addTimeStampPrefix, generateTimeStamp } from './time-stamp-util.js';
+export { loadCredentials } from './credentials-util.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@epoint-testtech/stage-core",
-  "version": "0.0.3-alpha.1",
+  "version": "0.0.4-alpha.0",
   "description": "Epoint Stage — Playwright 测试框架核心库",
   "type": "module",
   "main": "./dist/index.js",
@@ -32,6 +32,7 @@
   },
   "dependencies": {
     "dotenv": "^17.2.3",
+    "json5": "^2.2.3",
     "winston": "^3.17.0"
   },
   "peerDependencies": {