domains007 1.0.1

package/README.md

@@ -0,0 +1,160 @@
+# keep-alive-domains
+
+Base64 编码的 API 域名配置包，用于 Android App 域名容灾。
+
+## 核心思路
+
+> **用 npm + CDN 作为免费、高可用的域名配置分发通道，让 Android App 在域名挂了的时候能自我修复。**
+
+```
+你的操作（域名挂了时）：
+  node encode.js  → 改 domains.json → npm publish
+      │
+      ▼
+  jsdelivr / unpkg CDN 自动更新（1-5分钟）
+      │
+      ▼
+Android App：
+  KeepAliveManager.request { domain -> ... }
+       │
+       ├─ 1. 用域名发起 okhttp 请求
+       ├─ 2. 失败 → CDN 拉取 domains.json
+       ├─ 3. base64 解码 payload → 获得新域名
+       ├─ 4. 新域名重试 → 成功
+       └─ 5. SharedPreferences 缓存
+```
+
+## 为什么这个方案成立
+
+npm + CDN（unpkg / jsdelivr）的基础设施可用性远超你自己某个 API 域名：
+
+| 渠道 | 被墙/挂掉概率 | 速度 | 成本 |
+| ------ | :---------: | ------ | ------ |
+| 你自己的 API 域名 | 高（这就是问题） | — | 服务器成本 |
+| `npmjs.com` | 极低 | 全球 CDN | **免费** |
+| `unpkg.com` | 极低 | Cloudflare | **免费** |
+| `jsdelivr.net` | 极低（国内可用） | 全球 + 国内节点 | **免费** |
+
+App 同时配 3 个 CDN 地址作为 fallback，几乎不可能全挂。
+
+## 项目结构
+
+```
+keep-alive-domains/
+├── package.json        # name, version, 无依赖
+├── domains.json        # ★ 核心：base64 编码的域名配置
+├── index.js            # CommonJS 入口，自动解码
+├── index.mjs           # ESM 入口
+├── index.d.ts          # TypeScript 类型定义
+├── encode.js           # 工具脚本：编码新域名
+├── .npmignore
+└── README.md
+```
+
+## 关键设计
+
+| 设计点 | 实现 |
+| ------ | ------ |
+| **域名不暴露** | `domains.json` 的 `payload` 是 base64 编码的 JSON，CDN 上浏览看不到明文 |
+| **多 CDN 容灾** | jsdelivr + jsdelivr@latest + unpkg，三个地址依次尝试 |
+| **三级降级** | CDN → 本地 SharedPreferences 缓存 → 编译期内置兜底 |
+| **版本比较** | `domains.json` 的 `version` 递增，App 比较后才更新本地缓存 |
+| **Android 单例** | `KeepAliveManager` 是 Kotlin `object`，启动时 init 一次，全局可用 |
+
+## domains.json 设计
+
+```json
+{
+  "version": 1,
+  "updatedAt": "2026-07-25T00:00:00Z",
+  "payload": "eyJwcmltYXJ5Ijoi..."
+}
+```
+
+`payload` 是 base64 编码的 JSON，解码后：
+
+```json
+{
+  "primary": "https://api.example.com",
+  "fallbacks": [
+    "https://api2.example.com",
+    "https://api3.example.com"
+  ]
+}
+```
+
+## Usage (Node.js)
+
+```js
+const domains = require('keep-alive-domains');
+console.log(domains.getPrimary());   // "https://api.example.com"
+console.log(domains.getAll());       // ["https://api.example.com", ...]
+console.log(domains.getFallbacks()); // ["https://api2.example.com", ...]
+console.log(domains.getVersion());   // 1
+```
+
+## 发布步骤
+
+```bash
+# 1. 修改域名
+node encode.js        # 先编辑 encode.js 里的 config 对象，再运行，复制输出
+
+# 2. 更新 domains.json
+#    粘贴上面输出的内容，递增 version
+
+# 3. 发版
+npm version patch     # 1.0.0 → 1.0.1
+npm publish
+```
+
+## Android: Fetch from CDN
+
+```
+https://cdn.jsdelivr.net/npm/keep-alive-domains/domains.json
+https://cdn.jsdelivr.net/npm/keep-alive-domains@latest/domains.json
+https://unpkg.com/keep-alive-domains@latest/domains.json
+```
+
+## 进阶方向
+
+- **签名校验**：对 payload 加 HMAC 签名，App 内置公钥验签，防止 CDN 被劫持篡改
+- **多渠道**：按 `production` / `staging` 区分不同域名
+- **灰度发布**：利用 npm dist-tag（`npm publish --tag beta`）实现按 tag 拉不同版本
+
+## License
+
+MIT
+
+
+┌─────────────────────────────────────────────────────────┐
+│ 你的本地（仅你可见）                                       │
+│                                                         │
+│ 1. 编辑 encode.js                                        │
+│    const config = {                                      │
+│      primary: 'https://你的新域名.com',                    │
+│      fallbacks: [...]                                    │
+│    }                                                     │
+│                                                         │
+│ 2. node encode.js                                       │
+│    → 输出新的 base64 payload                              │
+│                                                         │
+│ 3. 粘贴到 domains.json，version +1                        │
+│                                                         │
+│ 4. npm version patch  &&  npm publish                    │
+│    → 发布到 npmjs.com（domains.json 被打包进去）            │
+│                                                         │
+│ 5. git add . && git commit && git push                   │
+│    → 推送到 Gitee（不含 encode.js / domains.json / README） │
+└─────────────────────────────────────────────────────────┘
+│
+▼
+npmjs.com ──▶ CDN 自动同步 ──▶ Android App 拉取新域名
+
+步骤	命令	说明
+①	编辑 encode.js	改 config 里的域名
+②	node encode.js	生成 base64 payload
+③	粘贴到 domains.json	替换 payload，version 递增
+④	npm version patch	包版本号自动 +1（如 1.0.1 → 1.0.2）
+⑤	npm publish	发布，domains.json 随包上传
+⑥	git add . && git commit && git push	Gitee 只接收骨架代码变化
+关键点：npm publish 看的是本地文件系统，不是 git。所以 domains.json 即使被 .gitignore 排除，它仍然会被 package.json 的 "files": [...] 打包发布到 npm。Gitee 干净，npm 正常用。

package/domains.json

@@ -0,0 +1,5 @@
+{
+  "version": 1,
+  "updatedAt": "2026-08-14T11:34:38.550Z",
+  "payload": "eyJjaGFubmVscyI6eyJid2NqIjp7InByaW1hcnkiOiJodHRwczovL3dzLTA4MDgtbG9uZ3RpbWUtem4tYndjai15bWFwaS5rbHF0dnhkLmNvbSIsImZhbGxiYWNrcyI6WyJodHRwczovL3dzLTA4MDgtbG9uZ3RpbWUtem4tYndjai15bWFwaS5rbHF0dnhkLmNvbSJdfSwiZHlwaiI6eyJwcmltYXJ5IjoiaHR0cHM6Ly9hcGktb3RoZXIuZXhhbXBsZS5jb20iLCJmYWxsYmFja3MiOlsiaHR0cHM6Ly9hcGktb3RoZXIyLmV4YW1wbGUuY29tIl19LCJwZGQiOnsicHJpbWFyeSI6Imh0dHBzOi8vYXBpLW90aGVyLmV4YW1wbGUuY29tIiwiZmFsbGJhY2tzIjpbImh0dHBzOi8vYXBpLW90aGVyMi5leGFtcGxlLmNvbSJdfSwieGNoYXQiOnsicHJpbWFyeSI6Imh0dHBzOi8vd3MtMDgwOC1sb25ndGltZS16bi14Y2hhdC15bWFwaS5rbHF0dnhkLmNvbSIsImZhbGxiYWNrcyI6WyJodHRwczovL3dzLTA4MDgtbG9uZ3RpbWUtem4teGNoYXQteW1hcGkua2xxdHZ4ZC5jb20iXX0sInhzbSI6eyJwcmltYXJ5IjoiaHR0cHM6Ly9hcGktb3RoZXIuZXhhbXBsZS5jb20iLCJmYWxsYmFja3MiOlsiaHR0cHM6Ly9hcGktb3RoZXIyLmV4YW1wbGUuY29tIl19fX0="
+}

package/index.d.ts

@@ -0,0 +1,39 @@
+declare module 'keep-alive-domains' {
+  /** Single channel domain config */
+  interface ChannelConfig {
+    primary: string;
+    fallbacks: string[];
+  }
+
+  /**
+   * Get config for a specific channel.
+   * @returns null if channel not found
+   */
+  export function getChannel(name: string): ChannelConfig | null;
+
+  /**
+   * Get all channel names.
+   */
+  export function getChannelNames(): string[];
+
+  /**
+   * Get the config version number for cache comparison.
+   */
+  export function getVersion(): number;
+
+  /** Config version */
+  export const version: number;
+
+  /** Last update timestamp (ISO 8601) */
+  export const updatedAt: string;
+
+  /** Raw channels map */
+  export const channels: Record<string, ChannelConfig>;
+
+  const _default: {
+    version: number;
+    updatedAt: string;
+    channels: Record<string, ChannelConfig>;
+  };
+  export default _default;
+}

package/index.js

@@ -0,0 +1,76 @@
+/**
+ * keep-alive-domains
+ *
+ * Decodes base64-encoded channel-based domain configuration from domains.json.
+ * Usage:
+ *   const domains = require('keep-alive-domains');
+ *   const ch = domains.getChannel('channel1');
+ *   console.log(ch.primary);      // "https://api.example.com"
+ *   console.log(ch.fallbacks);    // ["https://api2.example.com", ...]
+ */
+
+const raw = require('./domains.json');
+
+function decodeBase64(str) {
+  if (typeof Buffer !== 'undefined') {
+    return Buffer.from(str, 'base64').toString('utf-8');
+  }
+  if (typeof atob !== 'undefined') {
+    return atob(str);
+  }
+  throw new Error('No base64 decoder available');
+}
+
+function parseConfig(rawConfig) {
+  if (!rawConfig || !rawConfig.payload) {
+    throw new Error('Invalid domains.json: missing payload');
+  }
+  try {
+    const decoded = decodeBase64(rawConfig.payload);
+    const config = JSON.parse(decoded);
+    return {
+      version: rawConfig.version,
+      updatedAt: rawConfig.updatedAt,
+      ...config,
+    };
+  } catch (e) {
+    throw new Error('Failed to decode domain config: ' + e.message);
+  }
+}
+
+const config = parseConfig(raw);
+
+/**
+ * Get config for a specific channel.
+ * @param {string} name - channel name, e.g. "channel1"
+ * @returns {{ primary: string, fallbacks: string[] } | null}
+ */
+function getChannel(name) {
+  if (!config.channels || !config.channels[name]) return null;
+  return config.channels[name];
+}
+
+/**
+ * Get all channel names.
+ * @returns {string[]}
+ */
+function getChannelNames() {
+  return Object.keys(config.channels || {});
+}
+
+/**
+ * Get the config version number (for cache comparison).
+ */
+function getVersion() {
+  return config.version;
+}
+
+module.exports = {
+  getChannel,
+  getChannelNames,
+  getVersion,
+  version: config.version,
+  updatedAt: config.updatedAt,
+  // Raw access if needed
+  channels: config.channels || {},
+};

package/index.mjs

@@ -0,0 +1,47 @@
+/**
+ * keep-alive-domains — ESM entry
+ */
+
+import { readFileSync } from 'node:fs';
+import { fileURLToPath } from 'node:url';
+import { dirname, join } from 'node:path';
+
+const __dirname = dirname(fileURLToPath(import.meta.url));
+const raw = JSON.parse(readFileSync(join(__dirname, 'domains.json'), 'utf-8'));
+
+function decodeBase64(str) {
+  return Buffer.from(str, 'base64').toString('utf-8');
+}
+
+function parseConfig(rawConfig) {
+  if (!rawConfig || !rawConfig.payload) {
+    throw new Error('Invalid domains.json: missing payload');
+  }
+  try {
+    const decoded = decodeBase64(rawConfig.payload);
+    const config = JSON.parse(decoded);
+    return { version: rawConfig.version, updatedAt: rawConfig.updatedAt, ...config };
+  } catch (e) {
+    throw new Error('Failed to decode domain config: ' + e.message);
+  }
+}
+
+const config = parseConfig(raw);
+
+export function getChannel(name) {
+  if (!config.channels || !config.channels[name]) return null;
+  return config.channels[name];
+}
+
+export function getChannelNames() {
+  return Object.keys(config.channels || {});
+}
+
+export function getVersion() {
+  return config.version;
+}
+
+export const version = config.version;
+export const updatedAt = config.updatedAt;
+export const channels = config.channels || {};
+export default config;

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "domains007",
+  "version": "1.0.1",
+  "description": "API domain configuration with base64 encoding for Android app failover",
+  "main": "index.js",
+  "module": "index.mjs",
+  "types": "index.d.ts",
+  "files": [
+    "index.js",
+    "index.mjs",
+    "index.d.ts",
+    "domains.json"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://gitee.com/ggkk23/mydomains.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "keep-alive",
+    "domain",
+    "failover",
+    "api",
+    "android"
+  ],
+  "license": "MIT"
+}