create-windy 0.2.6 → 0.2.8

package/template/packages/license-sdk/src/installation.test.ts

@@ -1,241 +0,0 @@
-import { describe, expect, test } from "bun:test";
-import { licenseVersionKey, type LicenseV1Claims } from "@windy/shared";
-import { LicenseInstaller } from "./installation.js";
-import type { AtomicLicenseStore } from "./storage.js";
-import { MemoryAtomicLicenseStore } from "./storage.js";
-import { createSignedLicenseV1 } from "./test-fixtures.js";
-
-function claims(overrides: Partial<LicenseV1Claims> = {}): LicenseV1Claims {
-  return {
-    licenseId: "license_1",
-    productCode: "windy-platform",
-    customer: { id: "customer_1", code: "C-1", name: "客户一" },
-    project: { id: "project_1", code: "P-1", name: "项目一" },
-    contract: { id: "contract_1", contractNumber: "HT-1", version: "1" },
-    machineCode: "machine_1",
-    issuedAt: "2026-07-10T00:00:00.000Z",
-    expiresAt: "2030-07-10T00:00:00.000Z",
-    licenseVersion: {
-      key: licenseVersionKey("standard"),
-      name: "普通付费版",
-    },
-    ...overrides,
-  };
-}
-
-function installer(
-  store: AtomicLicenseStore,
-  publicKeys: Record<string, string>,
-  trustedReplacementAuthority?: ConstructorParameters<
-    typeof LicenseInstaller
-  >[0]["trustedReplacementAuthority"],
-  trustedInvalidCurrentRecoveryAuthority?: ConstructorParameters<
-    typeof LicenseInstaller
-  >[0]["trustedInvalidCurrentRecoveryAuthority"],
-): LicenseInstaller {
-  return new LicenseInstaller({
-    store,
-    productCode: "windy-platform",
-    machineCode: "machine_1",
-    publicKeys,
-    now: new Date("2026-08-01T00:00:00.000Z"),
-    trustedReplacementAuthority,
-    trustedInvalidCurrentRecoveryAuthority,
-  });
-}
-
-describe("LicenseInstaller", () => {
-  test("签发时间更新的 License 立即替换，即使新到期时间更短", async () => {
-    const current = createSignedLicenseV1(claims(), "key_current");
-    const candidate = createSignedLicenseV1(
-      claims({
-        licenseId: "license_2",
-        issuedAt: "2026-07-20T00:00:00.000Z",
-        expiresAt: "2027-07-20T00:00:00.000Z",
-        licenseVersion: {
-          key: licenseVersionKey("advanced"),
-          name: "高级付费版",
-        },
-      }),
-      "key_candidate",
-    );
-    const store = new MemoryAtomicLicenseStore(JSON.stringify(current.license));
-
-    const result = await installer(store, {
-      key_current: current.publicKeyPem,
-      key_candidate: candidate.publicKeyPem,
-    }).install(JSON.stringify(candidate.license));
-
-    expect(result.status).toBe("installed");
-    expect(result.license?.claims.expiresAt).toBe("2027-07-20T00:00:00.000Z");
-    expect(JSON.parse((await store.readCurrent())!).claims.licenseId).toBe(
-      "license_2",
-    );
-  });
-
-  test("历史 License 不能覆盖签发时间更晚的当前 License", async () => {
-    const current = createSignedLicenseV1(
-      claims({
-        licenseId: "license_new",
-        issuedAt: "2026-07-20T00:00:00.000Z",
-      }),
-      "key_current",
-    );
-    const old = createSignedLicenseV1(
-      claims({
-        licenseId: "license_old",
-        issuedAt: "2026-07-10T00:00:00.000Z",
-      }),
-      "key_old",
-    );
-    const original = JSON.stringify(current.license);
-    const store = new MemoryAtomicLicenseStore(original);
-
-    const result = await installer(store, {
-      key_current: current.publicKeyPem,
-      key_old: old.publicKeyPem,
-    }).install(JSON.stringify(old.license));
-
-    expect(result).toMatchObject({
-      status: "rejected",
-      failures: ["license-not-newer"],
-    });
-    expect(await store.readCurrent()).toBe(original);
-  });
-
-  test("篡改 signed issuedAt 不能伪装成新 License", async () => {
-    const current = createSignedLicenseV1(claims(), "key_current");
-    const candidate = createSignedLicenseV1(
-      claims({ licenseId: "license_2", issuedAt: "2026-07-05T00:00:00.000Z" }),
-      "key_candidate",
-    );
-    const original = JSON.stringify(current.license);
-    const store = new MemoryAtomicLicenseStore(original);
-    const tampered = {
-      ...candidate.license,
-      claims: {
-        ...candidate.license.claims,
-        issuedAt: "2026-07-20T00:00:00.000Z",
-      },
-    };
-
-    const result = await installer(store, {
-      key_current: current.publicKeyPem,
-      key_candidate: candidate.publicKeyPem,
-    }).install(JSON.stringify(tampered));
-
-    expect(result.failures).toEqual(["invalid-signature"]);
-    expect(await store.readCurrent()).toBe(original);
-  });
-
-  test("可信替换关系可显式授权非递增 issuedAt 的替换", async () => {
-    const current = createSignedLicenseV1(
-      claims({
-        licenseId: "license_current",
-        issuedAt: "2026-07-20T00:00:00.000Z",
-      }),
-      "key_current",
-    );
-    const replacement = createSignedLicenseV1(
-      claims({
-        licenseId: "license_replacement",
-        issuedAt: "2026-07-19T00:00:00.000Z",
-      }),
-      "key_replacement",
-    );
-    const store = new MemoryAtomicLicenseStore(JSON.stringify(current.license));
-
-    const result = await installer(
-      store,
-      {
-        key_current: current.publicKeyPem,
-        key_replacement: replacement.publicKeyPem,
-      },
-      ({ current: installed, candidate }) =>
-        installed.claims.licenseId === "license_current" &&
-        candidate.claims.licenseId === "license_replacement",
-    ).install(JSON.stringify(replacement.license));
-
-    expect(result.status).toBe("installed");
-  });
-
-  test("未知公钥和写入失败都不覆盖当前 License", async () => {
-    const current = createSignedLicenseV1(claims(), "key_current");
-    const candidate = createSignedLicenseV1(
-      claims({ licenseId: "license_2", issuedAt: "2026-07-20T00:00:00.000Z" }),
-      "key_unknown",
-    );
-    const original = JSON.stringify(current.license);
-    const unknownKeyStore = new MemoryAtomicLicenseStore(original);
-
-    const unknownKeyResult = await installer(unknownKeyStore, {
-      key_current: current.publicKeyPem,
-    }).install(JSON.stringify(candidate.license));
-    expect(unknownKeyResult.failures).toContain("unknown-public-key");
-    expect(await unknownKeyStore.readCurrent()).toBe(original);
-
-    const failingStore = new FailingAtomicStore(original, false);
-    const storageResult = await installer(failingStore, {
-      key_current: current.publicKeyPem,
-      key_unknown: candidate.publicKeyPem,
-    }).install(JSON.stringify(candidate.license));
-    expect(storageResult.failures).toEqual(["storage-failure"]);
-    expect(await failingStore.readCurrent()).toBe(original);
-  });
-
-  test("提交完成后适配器报错时通过回读确认新文件完整", async () => {
-    const candidate = createSignedLicenseV1(claims(), "key_candidate");
-    const store = new FailingAtomicStore(undefined, true);
-
-    const result = await installer(store, {
-      key_candidate: candidate.publicKeyPem,
-    }).install(JSON.stringify(candidate.license));
-
-    expect(result.status).toBe("installed");
-    expect(JSON.parse((await store.readCurrent())!).claims.licenseId).toBe(
-      "license_1",
-    );
-  });
-
-  test("损坏 current 只在可信恢复授权后由同一安装器原子替换", async () => {
-    const candidate = createSignedLicenseV1(claims(), "key_candidate");
-    const store = new MemoryAtomicLicenseStore("{broken");
-    const publicKeys = { key_candidate: candidate.publicKeyPem };
-
-    const rejected = await installer(store, publicKeys).install(
-      JSON.stringify(candidate.license),
-    );
-    expect(rejected.failures).toEqual(["current-license-invalid"]);
-    expect(await store.readCurrent()).toBe("{broken");
-
-    const recovered = await installer(
-      store,
-      publicKeys,
-      undefined,
-      ({ rawCurrent, candidate: verifiedCandidate }) =>
-        rawCurrent === "{broken" &&
-        verifiedCandidate.claims.licenseId === "license_1",
-    ).install(JSON.stringify(candidate.license));
-
-    expect(recovered.status).toBe("installed");
-    expect(JSON.parse((await store.readCurrent())!).claims.licenseId).toBe(
-      "license_1",
-    );
-  });
-});
-
-class FailingAtomicStore implements AtomicLicenseStore {
-  constructor(
-    private value: string | undefined,
-    private readonly commitBeforeFailure: boolean,
-  ) {}
-
-  readCurrent(): string | undefined {
-    return this.value;
-  }
-
-  replaceCurrentAtomically(value: string): never {
-    if (this.commitBeforeFailure) this.value = value;
-    throw new Error("模拟磁盘写入失败");
-  }
-}

package/template/packages/license-sdk/src/installation.ts

@@ -1,150 +0,0 @@
-import type { LicenseFailureReason, SignedLicense } from "@windy/shared";
-import { canonicalizeJson } from "./canonical-json.js";
-import type { AtomicLicenseStore } from "./storage.js";
-import type { LicenseValidationOptions } from "./validation.js";
-import {
-  validateLicenseDocument,
-  verifyLicenseDocument,
-} from "./validation.js";
-
-export type LicenseInstallFailure =
-  | LicenseFailureReason
-  | "current-license-invalid"
-  | "license-not-newer"
-  | "storage-failure";
-
-export interface LicenseInstallResult {
-  status: "installed" | "unchanged" | "rejected";
-  license?: SignedLicense;
-  failures: LicenseInstallFailure[];
-}
-
-export type TrustedReplacementAuthority = (input: {
-  current: SignedLicense;
-  candidate: SignedLicense;
-}) => boolean | Promise<boolean>;
-
-export type TrustedInvalidCurrentRecoveryAuthority = (input: {
-  rawCurrent: string;
-  candidate: SignedLicense;
-}) => boolean | Promise<boolean>;
-
-export interface LicenseInstallerOptions extends Omit<
-  LicenseValidationOptions,
-  "lastTrustedAt"
-> {
-  store: AtomicLicenseStore;
-  /** Must resolve from authenticated, locally trusted replacement metadata. */
-  trustedReplacementAuthority?: TrustedReplacementAuthority;
-  /** Must only be enabled by an authenticated, audited local recovery flow. */
-  trustedInvalidCurrentRecoveryAuthority?: TrustedInvalidCurrentRecoveryAuthority;
-}
-
-export class LicenseInstaller {
-  constructor(private readonly options: LicenseInstallerOptions) {}
-
-  async install(rawCandidate: string): Promise<LicenseInstallResult> {
-    const candidateResult = await validateLicenseDocument(rawCandidate, {
-      productCode: this.options.productCode,
-      machineCode: this.options.machineCode,
-      publicKeys: this.options.publicKeys,
-      now: this.options.now,
-      clockToleranceMs: this.options.clockToleranceMs,
-    });
-    const candidate = candidateResult.license;
-    if (!candidateResult.valid || !candidate) {
-      return {
-        status: "rejected",
-        failures: candidateResult.failures,
-      };
-    }
-
-    let rawCurrent: string | undefined;
-    try {
-      rawCurrent = await this.options.store.readCurrent();
-    } catch {
-      return { status: "rejected", failures: ["storage-failure"] };
-    }
-
-    if (rawCurrent) {
-      const currentResult = await verifyLicenseDocument(
-        rawCurrent,
-        this.options.publicKeys,
-      );
-      const current = currentResult.license;
-      if (!currentResult.valid || !current) {
-        const recoveryAllowed = Boolean(
-          await this.options.trustedInvalidCurrentRecoveryAuthority?.({
-            rawCurrent,
-            candidate,
-          }),
-        );
-        if (!recoveryAllowed) {
-          return {
-            status: "rejected",
-            failures: ["current-license-invalid"],
-          };
-        }
-      } else {
-        if (sameLicense(current, candidate)) {
-          return { status: "unchanged", license: current, failures: [] };
-        }
-        if (!(await this.isNewerOrReplacement(current, candidate))) {
-          return {
-            status: "rejected",
-            license: current,
-            failures: ["license-not-newer"],
-          };
-        }
-      }
-    }
-
-    const serializedCandidate = canonicalizeJson(candidate);
-    try {
-      await this.options.store.replaceCurrentAtomically(serializedCandidate);
-      return { status: "installed", license: candidate, failures: [] };
-    } catch {
-      return this.resolveUncertainCommit(candidate);
-    }
-  }
-
-  private async isNewerOrReplacement(
-    current: SignedLicense,
-    candidate: SignedLicense,
-  ): Promise<boolean> {
-    if (
-      Date.parse(candidate.claims.issuedAt) >
-      Date.parse(current.claims.issuedAt)
-    ) {
-      return true;
-    }
-    return Boolean(
-      await this.options.trustedReplacementAuthority?.({ current, candidate }),
-    );
-  }
-
-  private async resolveUncertainCommit(
-    candidate: SignedLicense,
-  ): Promise<LicenseInstallResult> {
-    try {
-      const committedRaw = await this.options.store.readCurrent();
-      const committed = committedRaw
-        ? await verifyLicenseDocument(committedRaw, this.options.publicKeys)
-        : undefined;
-      if (committed?.license && sameLicense(committed.license, candidate)) {
-        return { status: "installed", license: candidate, failures: [] };
-      }
-    } catch {
-      // The adapter could not prove which complete value survived.
-    }
-    return { status: "rejected", failures: ["storage-failure"] };
-  }
-}
-
-function sameLicense(left: SignedLicense, right: SignedLicense): boolean {
-  return (
-    left.claims.licenseId === right.claims.licenseId &&
-    left.publicKeyId === right.publicKeyId &&
-    left.signature === right.signature
-  );
-}

package/template/packages/license-sdk/src/license-parser.ts

@@ -1,56 +0,0 @@
-import type { SignedLicense, SignedLicenseV1 } from "@windy/shared";
-import { createLicenseSigningPayload } from "./payload.js";
-
-export function parseSignedLicenseV1(
-  rawLicense: string,
-): SignedLicenseV1 | undefined {
-  try {
-    const value = JSON.parse(rawLicense) as unknown;
-    if (!isRecord(value)) return undefined;
-    if (
-      !hasExactKeys(value, [
-        "algorithm",
-        "claims",
-        "formatVersion",
-        "publicKeyId",
-        "signature",
-      ])
-    ) {
-      return undefined;
-    }
-    if (typeof value.signature !== "string" || !value.signature.length) {
-      return undefined;
-    }
-    const license = value as unknown as SignedLicenseV1;
-    createLicenseSigningPayload({
-      formatVersion: license.formatVersion,
-      algorithm: license.algorithm,
-      publicKeyId: license.publicKeyId,
-      claims: license.claims,
-    });
-    return license;
-  } catch {
-    return undefined;
-  }
-}
-
-export function parseSignedLicense(
-  rawLicense: string,
-): SignedLicense | undefined {
-  return parseSignedLicenseV1(rawLicense);
-}
-
-function isRecord(value: unknown): value is Record<string, unknown> {
-  return Boolean(value) && typeof value === "object" && !Array.isArray(value);
-}
-
-function hasExactKeys(
-  value: Record<string, unknown>,
-  expected: readonly string[],
-): boolean {
-  const keys = Object.keys(value);
-  return (
-    keys.length === expected.length &&
-    keys.every((key) => expected.includes(key))
-  );
-}

package/template/packages/license-sdk/src/offline-code-base32.ts

@@ -1,57 +0,0 @@
-const ALPHABET = "0123456789ABCDEFGHJKMNPQRSTVWXYZ";
-const VALUES = new Map(
-  [...ALPHABET].map((character, index) => [character, index]),
-);
-
-export function encodeBase32(bytes: Uint8Array): string {
-  let output = "";
-  let buffer = 0;
-  let bits = 0;
-  for (const byte of bytes) {
-    buffer = (buffer << 8) | byte;
-    bits += 8;
-    while (bits >= 5) {
-      bits -= 5;
-      output += ALPHABET[(buffer >>> bits) & 31];
-      buffer &= (1 << bits) - 1;
-    }
-  }
-  if (bits > 0) output += ALPHABET[(buffer << (5 - bits)) & 31];
-  return output;
-}
-
-export function decodeBase32(value: string): Uint8Array {
-  const output: number[] = [];
-  let buffer = 0;
-  let bits = 0;
-  for (const character of value) {
-    const decoded = VALUES.get(character);
-    if (decoded === undefined)
-      throw new Error(`非法 Base32 字符：${character}`);
-    buffer = (buffer << 5) | decoded;
-    bits += 5;
-    if (bits >= 8) {
-      bits -= 8;
-      output.push((buffer >>> bits) & 255);
-      buffer &= (1 << bits) - 1;
-    }
-  }
-  if (bits >= 5 || buffer !== 0) throw new Error("Base32 末尾填充位无效");
-  return Uint8Array.from(output);
-}
-
-export function segmentChecksum(data: string, segmentIndex: number): string {
-  let primary = (segmentIndex * 11 + 7) & 31;
-  let secondary = (segmentIndex * 17 + 19) & 31;
-  for (let index = 0; index < data.length; index += 1) {
-    const value = VALUES.get(data[index] || "");
-    if (value === undefined) throw new Error("分段包含非法字符");
-    primary = (primary + value * (index * 2 + 1)) & 31;
-    secondary = (secondary + value * ((index * 6 + 5) & 31)) & 31;
-  }
-  return (ALPHABET[primary] || "0") + (ALPHABET[secondary] || "0");
-}
-
-export function isBase32Character(character: string): boolean {
-  return VALUES.has(character);
-}

package/template/packages/license-sdk/src/offline-code-decompression.ts

@@ -1,55 +0,0 @@
-import { Unzlib } from "fflate";
-import { OFFLINE_ACTIVATION_CODE_LIMITS } from "./offline-code-limits.js";
-
-const COMPRESSED_CHUNK_BYTES = 64;
-
-export class OfflineCodeDecompressionLimitError extends Error {
-  constructor() {
-    super("离线激活码解压结果超过安全上限");
-    this.name = "OfflineCodeDecompressionLimitError";
-  }
-}
-
-/**
- * 分块驱动解压器，并在累计输出越过信封声明或协议上限时立即中断。
- */
-export function decompressOfflineCode(
-  compressed: Uint8Array,
-  expectedLength: number,
-): Uint8Array {
-  if (
-    compressed.byteLength === 0 ||
-    compressed.byteLength > OFFLINE_ACTIVATION_CODE_LIMITS.compressedBytes
-  ) {
-    throw new OfflineCodeDecompressionLimitError();
-  }
-
-  const output = new Uint8Array(expectedLength);
-  let offset = 0;
-  const stream = new Unzlib((chunk) => {
-    const remaining = expectedLength - offset;
-    if (
-      chunk.byteLength > remaining ||
-      offset + chunk.byteLength >
-        OFFLINE_ACTIVATION_CODE_LIMITS.decompressedBytes
-    ) {
-      throw new OfflineCodeDecompressionLimitError();
-    }
-    output.set(chunk, offset);
-    offset += chunk.byteLength;
-  });
-
-  for (
-    let start = 0;
-    start < compressed.byteLength;
-    start += COMPRESSED_CHUNK_BYTES
-  ) {
-    const end = Math.min(start + COMPRESSED_CHUNK_BYTES, compressed.byteLength);
-    stream.push(compressed.subarray(start, end), end === compressed.byteLength);
-  }
-
-  if (offset !== expectedLength) {
-    throw new Error("离线激活码解压结果长度不一致");
-  }
-  return output;
-}

package/template/packages/license-sdk/src/offline-code-limits.ts

@@ -1,10 +0,0 @@
-/**
- * W1 安全上限。常见激活码不足 1 KiB；打印与请求上限保留了数十倍余量。
- */
-export const OFFLINE_ACTIVATION_CODE_LIMITS = {
-  printedCharacters: 32 * 1024,
-  normalizedCharacters: 28 * 1024,
-  compressedBytes: 16 * 1024,
-  decompressedBytes: 64 * 1024,
-  requestBytes: 64 * 1024,
-} as const;

package/template/packages/license-sdk/src/offline-code-wire.ts

@@ -1,72 +0,0 @@
-import type { SignedLicense } from "@windy/shared";
-
-export const ED25519_SIGNATURE_BYTES = 64;
-
-export function toCompactTuple(license: SignedLicense): unknown[] {
-  const { claims } = license;
-  return [
-    claims.licenseId,
-    claims.productCode,
-    claims.customer.id,
-    claims.customer.code,
-    claims.customer.name,
-    claims.project.id,
-    claims.project.code,
-    claims.project.name,
-    claims.contract.id,
-    claims.contract.contractNumber,
-    claims.contract.version,
-    claims.machineCode,
-    claims.issuedAt,
-    claims.expiresAt,
-    claims.licenseVersion.key,
-    claims.licenseVersion.name,
-    license.publicKeyId,
-  ];
-}
-
-export function fromCompactTuple(value: unknown, signature: string): unknown {
-  if (
-    !Array.isArray(value) ||
-    value.length !== 17 ||
-    value.some((item) => typeof item !== "string")
-  ) {
-    throw new Error("激活码字段类型或数量无效");
-  }
-  return {
-    formatVersion: 1,
-    algorithm: "ED25519",
-    publicKeyId: value[16],
-    signature,
-    claims: {
-      licenseId: value[0],
-      productCode: value[1],
-      customer: { id: value[2], code: value[3], name: value[4] },
-      project: { id: value[5], code: value[6], name: value[7] },
-      contract: { id: value[8], contractNumber: value[9], version: value[10] },
-      machineCode: value[11],
-      issuedAt: value[12],
-      expiresAt: value[13],
-      licenseVersion: { key: value[14], name: value[15] },
-    },
-  };
-}
-
-export function decodeEd25519Signature(value: string): Uint8Array {
-  if (!/^[A-Za-z0-9+/]{86}==$/.test(value)) {
-    throw new Error("License ED25519 签名编码无效");
-  }
-  const bytes = Uint8Array.from(atob(value), (character) =>
-    character.charCodeAt(0),
-  );
-  if (bytes.byteLength !== ED25519_SIGNATURE_BYTES) {
-    throw new Error("License ED25519 签名长度无效");
-  }
-  return bytes;
-}
-
-export function encodeEd25519Signature(bytes: Uint8Array): string {
-  let binary = "";
-  for (const byte of bytes) binary += String.fromCharCode(byte);
-  return btoa(binary);
-}