livedomains 0.0.0-stage → 1.0.1

package/README.md

@@ -1,3 +1,112 @@
-# Temporary Holding Version
+# livedomains
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Base64 编码的直播域名配置包，用于 Android App 域名容灾。
+
+## 核心思路
+
+> **用 npm + CDN 作为免费、高可用的域名配置分发通道，让 Android App 在域名挂了的时候能自我修复。**
+
+```text
+域名挂了时（你的操作）：
+  python3 publish.py  →  自动拉接口 → 生成 domains.json → npm publish
+      │
+      ▼
+  jsdelivr / unpkg CDN 自动更新（1-5分钟）
+      │
+      ▼
+Android App：
+  CDN 拉取 domains.json → base64 解码 → 获得新域名 → 切换重试
+```
+
+## 与 domains007 的区别
+
+| 维度 | domains007 | livedomains |
+| ------ | ------ | ------ |
+| 顶级标识 | `channels[产品code]` | `projects[project_key]` |
+| 每项结构 | `{ primary, fallbacks }` | 5 个具名槽位，每个是列表 |
+| 槽位 | 主域名 + fallbacks | primary / payment / activity / ext1 / ext2 |
+
+## 项目结构
+
+```text
+livedomains/
+├── package.json        # name=livedomains, version
+├── domains.json        # ★ 核心：base64 编码的域名配置（发布到 npm）
+├── index.js            # CommonJS 入口，自动解码
+├── index.mjs           # ESM 入口
+├── index.d.ts          # TypeScript 类型定义
+├── publish.py          # 一键发布脚本（本地工具，不入库）
+├── encode.js           # 手动编码脚本
+├── .npmignore
+└── README.md
+```
+
+## domains.json 设计
+
+```json
+{
+  "version": 1,
+  "updatedAt": "2026-10-31T00:00:00.000Z",
+  "payload": "eyJwcm9qZWN0cyI6..."
+}
+```
+
+`payload` 是 base64 编码的 JSON，解码后是多项目结构：
+
+```json
+{
+  "projects": {
+    "k8": {
+      "primary":  ["https://minio-api.shooko.cn"],
+      "payment":  ["https://live-payment.shooko.cn"],
+      "activity": ["https://minio-h5.shooko.cn"],
+      "ext1":     ["https://minio-ext1.shooko.cn"],
+      "ext2":     ["https://minio-ext2.shooko.cn"]
+    }
+  }
+}
+```
+
+每个项目有 5 个语义固定的槽位，每个槽位是一个域名列表（按顺序尝试）：
+
+| 槽位 | 含义 |
+| ------ | ------ |
+| `primary` | 主域名（API） |
+| `payment` | 支付域名 |
+| `activity` | 活动域名（H5） |
+| `ext1` | 扩展位 1 |
+| `ext2` | 扩展位 2 |
+
+## Usage (Node.js)
+
+```js
+const live = require('livedomains');
+console.log(live.getProjectKeys());            // ["k8", ...]
+console.log(live.getProject('k8'));            // { primary, payment, activity, ext1, ext2 }
+console.log(live.getDomains('k8', 'payment')); // ["https://live-payment.shooko.cn"]
+console.log(live.getVersion());                // 1
+```
+
+## 发布流程（一键脚本）
+
+```bash
+cd npm_plan/livedomains
+python3 publish.py           # 交互：打印摘要 → 输入 y 发布
+python3 publish.py --yes     # 跳过确认直接发布
+```
+
+> ⚠️ 当前 `publish.py` 的 `API_URL` 为空占位，待填入真实接口地址后才能拉取发布。
+> 接口返回结构约定：
+> `{"code":200,"msg":"ok","data":{"primary":[],"payment":[],"activity":[],"ext1":[],"ext2":[]}}`
+
+## Android: Fetch from CDN
+
+```text
+https://cdn.jsdelivr.net/npm/livedomains/domains.json
+https://cdn.jsdelivr.net/npm/livedomains@latest/domains.json
+https://unpkg.com/livedomains@latest/domains.json
+```
+
+## License
+
+MIT

package/domains.json

@@ -0,0 +1,5 @@
+{
+  "version": 2,
+  "updatedAt": "2026-11-04T16:25:05.498234Z",
+  "payload": "eyJwcm9qZWN0cyI6IHsiazhsaXZlIjogeyJwcmltYXJ5IjogW10sICJwYXltZW50IjogW10sICJhY3Rpdml0eSI6IFsiaHR0cHM6Ly9taW5pby1saXZlLnNob29rby5jbiJdLCAiZXh0MSI6IFtdLCAiZXh0MiI6IFtdfX19"
+}

package/index.d.ts

@@ -0,0 +1,45 @@
+declare module 'livedomains' {
+  /** Named domain slots of a project */
+  type SlotName = 'primary' | 'payment' | 'activity' | 'ext1' | 'ext2';
+
+  /** Project domain config: each slot is a list of candidate domains */
+  type ProjectConfig = Record<SlotName, string[]>;
+
+  /**
+   * Get config for a specific project.
+   * @returns null if project not found
+   */
+  export function getProject(key: string): ProjectConfig | null;
+
+  /**
+   * Get all project keys.
+   */
+  export function getProjectKeys(): string[];
+
+  /**
+   * Get the domain list for a specific slot of a project.
+   * @returns null if project or slot not found
+   */
+  export function getDomains(key: string, slot: SlotName): string[] | null;
+
+  /**
+   * 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 projects map */
+  export const projects: Record<string, ProjectConfig>;
+
+  const _default: {
+    version: number;
+    updatedAt: string;
+    projects: Record<string, ProjectConfig>;
+  };
+  export default _default;
+}

package/index.js

@@ -0,0 +1,89 @@
+/**
+ * livedomains
+ *
+ * Decodes base64-encoded project-based domain configuration from domains.json.
+ * Each project has five named slots: primary / payment / activity / ext1 / ext2.
+ * Usage:
+ *   const live = require('livedomains');
+ *   const project = live.getProject('k8live');
+ *   console.log(project.payment);    // ["https://live-payment.shooko.cn"]
+ */
+
+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 project.
+ * @param {string} key - project key, e.g. "k8live"
+ * @returns {{ primary: string[], payment: string[], activity: string[], ext1: string[], ext2: string[] } | null}
+ */
+function getProject(key) {
+  if (!config.projects || !config.projects[key]) return null;
+  return config.projects[key];
+}
+
+/**
+ * Get all project keys.
+ * @returns {string[]}
+ */
+function getProjectKeys() {
+  return Object.keys(config.projects || {});
+}
+
+/**
+ * Get the domain list for a specific slot of a project.
+ * @param {string} key - project key
+ * @param {string} slot - one of "primary" | "payment" | "activity" | "ext1" | "ext2"
+ * @returns {string[] | null}
+ */
+function getDomains(key, slot) {
+  const project = getProject(key);
+  if (!project) return null;
+  return project[slot] || null;
+}
+
+/**
+ * Get the config version number (for cache comparison).
+ */
+function getVersion() {
+  return config.version;
+}
+
+module.exports = {
+  getProject,
+  getProjectKeys,
+  getDomains,
+  getVersion,
+  version: config.version,
+  updatedAt: config.updatedAt,
+  // Raw access if needed
+  projects: config.projects || {},
+};

package/index.mjs

@@ -0,0 +1,53 @@
+/**
+ * livedomains — 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 getProject(key) {
+  if (!config.projects || !config.projects[key]) return null;
+  return config.projects[key];
+}
+
+export function getProjectKeys() {
+  return Object.keys(config.projects || {});
+}
+
+export function getDomains(key, slot) {
+  const project = getProject(key);
+  if (!project) return null;
+  return project[slot] || null;
+}
+
+export function getVersion() {
+  return config.version;
+}
+
+export const version = config.version;
+export const updatedAt = config.updatedAt;
+export const projects = config.projects || {};
+export default config;

package/package.json

@@ -1,6 +1,29 @@
 {
   "name": "livedomains",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "1.0.1",
+  "description": "Base64-encoded live domain configuration (primary/payment/activity/ext1/ext2) 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/381004367/livedomains.git"
+  },
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "keywords": [
+    "keep-alive",
+    "live",
+    "domain",
+    "failover",
+    "android"
+  ],
+  "license": "MIT"
+}