@agentunion/fastaun-browser 0.4.13 → 0.5.1

package/dist/validators.js

@@ -0,0 +1,127 @@
+/**
+ * AID 和 Group ID 格式校验工具。
+ *
+ * 确保发送到服务端的目标标识符符合 AUN 协议规范，拒绝不合法的格式。
+ *
+ * 与 Python SDK aun_core.validators 保持等价（零代码共享，仅规范对齐）。
+ */
+import { ValidationError } from './errors.js';
+import { convertToGroupAid } from './group-id.js';
+// AID name 规范：4-64 字符，仅 [a-z0-9_-]，首字符不为 -，不以 guest 开头
+const AID_NAME_RE = /^[a-z0-9_][a-z0-9_-]{3,63}$/;
+// Group ID 格式（基于服务端实际实现）
+// Legacy 格式：g- 后接 4-32 位小写字母数字
+const GROUP_ID_LEGACY_PATTERN = /^g-[a-z0-9]{4,32}$/;
+// 新格式 base：5 到 64 位小写字母数字
+const GROUP_ID_NEW_BASE_PATTERN = /^[a-z0-9]{5,64}$/;
+// Group name 格式：4-64 字符，首字符 [a-z0-9]，可包含 _-
+const GROUP_NAME_PATTERN = /^[a-z0-9][a-z0-9_-]{3,63}$/;
+// 域名基本格式（简化版，不做完整 DNS 校验）
+const DOMAIN_RE = /^[a-z0-9]([a-z0-9._-]*[a-z0-9])?$/;
+/**
+ * 校验 AID 格式是否合法。
+ *
+ * 格式规范：{name}.{issuer}
+ * - name: 4-64 字节，仅 [a-z0-9_-]，首字符不能是 -，不能以 guest 开头
+ * - issuer: 合法的可注册域名
+ *
+ * @param aid 待校验的 AID（可能是任意类型）
+ * @param paramName 参数名称（用于错误消息）
+ * @returns 规范化后的 AID（转小写、去空格）
+ * @throws ValidationError AID 格式不合法
+ */
+export function validateAIDFormat(aid, paramName = 'aid') {
+    if (aid === null || aid === undefined || (typeof aid === 'string' && aid.trim() === '')) {
+        throw new ValidationError(`${paramName} cannot be empty`);
+    }
+    const aidStr = String(aid).trim().toLowerCase();
+    // 检查是否包含点号（必须有 issuer）
+    if (!aidStr.includes('.')) {
+        throw new ValidationError(`Invalid ${paramName} '${String(aid)}': must be in format '{name}.{issuer}'`);
+    }
+    // 分离 name 和 issuer（仅在第一个点号处分割）
+    const dotIdx = aidStr.indexOf('.');
+    const name = aidStr.slice(0, dotIdx);
+    const issuer = aidStr.slice(dotIdx + 1);
+    // 校验 name 部分
+    if (!name) {
+        throw new ValidationError(`Invalid ${paramName} '${String(aid)}': name part cannot be empty`);
+    }
+    if (!AID_NAME_RE.test(name)) {
+        throw new ValidationError(`Invalid ${paramName} '${String(aid)}': name '${name}' must be 4-64 characters, `
+            + `only [a-z0-9_-], cannot start with '-'`);
+    }
+    if (name.startsWith('guest')) {
+        throw new ValidationError(`Invalid ${paramName} '${String(aid)}': name cannot start with 'guest'`);
+    }
+    // 校验 issuer 部分
+    if (!issuer) {
+        throw new ValidationError(`Invalid ${paramName} '${String(aid)}': issuer part cannot be empty`);
+    }
+    if (!DOMAIN_RE.test(issuer)) {
+        throw new ValidationError(`Invalid ${paramName} '${String(aid)}': issuer '${issuer}' is not a valid domain`);
+    }
+    return aidStr;
+}
+function resolveGroupValidationArgs(defaultParamName, paramNameOrOptions, maybeOptions) {
+    if (typeof paramNameOrOptions === 'string') {
+        return {
+            paramName: paramNameOrOptions || defaultParamName,
+            localIssuer: maybeOptions?.localIssuer ?? '',
+        };
+    }
+    return {
+        paramName: paramNameOrOptions?.paramName ?? defaultParamName,
+        localIssuer: paramNameOrOptions?.localIssuer ?? '',
+    };
+}
+function validateGroupAidParts(raw, groupAid, paramName) {
+    const stripDots = (s) => s.replace(/^\.+|\.+$/g, '');
+    const dotIdx = groupAid.indexOf('.');
+    const base = dotIdx >= 0 ? stripDots(groupAid.slice(0, dotIdx)) : groupAid;
+    const domain = dotIdx >= 0 ? stripDots(groupAid.slice(dotIdx + 1)) : '';
+    if (!base) {
+        throw new ValidationError(`Invalid ${paramName} '${String(raw)}': base part cannot be empty`);
+    }
+    const isValidBase = (GROUP_ID_LEGACY_PATTERN.test(base)
+        || GROUP_ID_NEW_BASE_PATTERN.test(base)
+        || GROUP_NAME_PATTERN.test(base));
+    if (!isValidBase) {
+        throw new ValidationError(`Invalid ${paramName} '${String(raw)}': base '${base}' must be one of: `
+            + `legacy format 'g-[a-z0-9]{4,32}', new format '[a-z0-9]{5,64}', `
+            + `or group name format '[a-z0-9][a-z0-9_-]{3,63}'`);
+    }
+    if (domain && !DOMAIN_RE.test(domain)) {
+        throw new ValidationError(`Invalid ${paramName} '${String(raw)}': domain '${domain}' is not a valid domain`);
+    }
+}
+/**
+ * 校验群组标识并返回目标态 group_aid。
+ */
+export function validateGroupAIDFormat(groupId, paramNameOrOptions = 'group_aid', maybeOptions) {
+    const { paramName, localIssuer } = resolveGroupValidationArgs('group_aid', paramNameOrOptions, maybeOptions);
+    if (groupId === null || groupId === undefined
+        || (typeof groupId === 'string' && groupId.trim() === '')) {
+        throw new ValidationError(`${paramName} cannot be empty`);
+    }
+    const rawText = String(groupId).trim();
+    if (rawText.includes('//')) {
+        throw new ValidationError(`Invalid ${paramName} '${String(groupId)}': empty path segment is not allowed`);
+    }
+    const groupAid = convertToGroupAid(rawText, { localIssuer });
+    if (!groupAid) {
+        throw new ValidationError(`${paramName} cannot be empty`);
+    }
+    validateGroupAidParts(groupId, groupAid, paramName);
+    return groupAid;
+}
+/**
+ * 校验 Group ID 格式是否合法。
+ *
+ * 旧函数名保留兼容，但返回目标态 group_aid。
+ */
+export function validateGroupIDFormat(groupId, paramNameOrOptions = 'group_id', maybeOptions) {
+    const { paramName, localIssuer } = resolveGroupValidationArgs('group_id', paramNameOrOptions, maybeOptions);
+    return validateGroupAIDFormat(groupId, paramName, { localIssuer });
+}
+//# sourceMappingURL=validators.js.map

package/dist/validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validators.js","sourceRoot":"","sources":["../src/validators.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -1,2 +1,2 @@
-export declare const VERSION = "0.4.13";
+export declare const VERSION = "0.5.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/version.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,WAAW,CAAC"}
+{"version":3,"file":"version.d.ts","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAGA,eAAO,MAAM,OAAO,UAAU,CAAC"}

package/dist/version.js

@@ -1,5 +1,5 @@
 // AUN SDK 版本号（单一事实来源）。
 // 所有引用点（index.ts / auth.ts / v2/e2ee/encrypt-p2p.ts）统一从此导入，
 // 避免多处独立定义导致版本号不一致。
-export const VERSION = '0.4.13';
+export const VERSION = '0.5.1';
 //# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -1 +1 @@
-{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,4DAA4D;AAC5D,oBAAoB;AACpB,MAAM,CAAC,MAAM,OAAO,GAAG,QAAQ,CAAC"}
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,uBAAuB;AACvB,4DAA4D;AAC5D,oBAAoB;AACpB,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,44 +1,44 @@
-{
-  "name": "@agentunion/fastaun-browser",
-  "version": "0.4.13",
-  "description": "AUN Protocol Core SDK for Browser",
-  "type": "module",
-  "main": "dist/index.js",
-  "types": "dist/index.d.ts",
-  "browser": "dist/index.js",
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "license": "Apache-2.0",
-  "files": [
-    "dist",
-    "_packed_docs",
-    "README.md",
-    "CHANGELOG.md",
-    "LICENSE"
-  ],
-  "scripts": {
-    "build": "tsc && node scripts/fix-esm-imports.mjs && esbuild src/index.ts --bundle --format=esm --outfile=dist/bundle.js --platform=browser --target=es2020",
-    "prepack": "python ../scripts/sync_packed_docs.py js",
-    "test": "vitest run --environment jsdom",
-    "test:unit": "vitest run --environment jsdom tests/unit",
-    "test:integration": "vitest run --environment jsdom --no-file-parallelism --maxWorkers=1 tests/integration",
-    "test:e2e": "npm run build && playwright test --config=playwright.agentid-local.config.ts tests/e2e-browser/v2-p2p.spec.ts tests/e2e-browser/v2-group.spec.ts tests/e2e-browser/v2-thought.spec.ts --reporter=line",
-    "test:e2e:smoke": "npm run build && playwright test --config=playwright.agentid-local.config.ts tests/e2e-browser/v2-p2p.spec.ts --grep \"V2 session 自动初始化\" --reporter=line"
-  },
-  "devDependencies": {
-    "@playwright/test": "^1.59.1",
-    "@types/node": "^22.19.19",
-    "esbuild": "^0.24.0",
-    "fake-indexeddb": "^6.2.5",
-    "jsdom": "^25.0.0",
-    "typescript": "^5.6.0",
-    "vitest": "^2.0.0"
-  },
-  "dependencies": {
-    "@noble/curves": "^2.2.0"
-  }
-}
+{
+  "name": "@agentunion/fastaun-browser",
+  "version": "0.5.1",
+  "description": "AUN Protocol Core SDK for Browser",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "browser": "dist/index.js",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "_packed_docs",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc && node scripts/fix-esm-imports.mjs && esbuild src/index.ts --bundle --format=esm --outfile=dist/bundle.js --platform=browser --target=es2020",
+    "prepack": "python ../scripts/sync_packed_docs.py js",
+    "test": "vitest run --environment jsdom",
+    "test:unit": "vitest run --environment jsdom tests/unit",
+    "test:integration": "vitest run --environment jsdom --no-file-parallelism --maxWorkers=1 tests/integration",
+    "test:e2e": "npm run build && playwright test --config=playwright.agentid-local.config.ts tests/e2e-browser/v2-p2p.spec.ts tests/e2e-browser/v2-group.spec.ts tests/e2e-browser/v2-thought.spec.ts tests/e2e-browser/collab.spec.ts --reporter=line",
+    "test:e2e:smoke": "npm run build && playwright test --config=playwright.agentid-local.config.ts tests/e2e-browser/v2-p2p.spec.ts --grep \"V2 session 自动初始化\" --reporter=line"
+  },
+  "devDependencies": {
+    "@playwright/test": "^1.59.1",
+    "@types/node": "^22.19.19",
+    "esbuild": "^0.24.0",
+    "fake-indexeddb": "^6.2.5",
+    "jsdom": "^25.0.0",
+    "typescript": "^5.6.0",
+    "vitest": "^2.0.0"
+  },
+  "dependencies": {
+    "@noble/curves": "^2.2.0"
+  }
+}