test: add test for prerelease workflow

Author: xiaoyu2er

.github/scripts/generate-e2e-matrix.test.js

@@ -0,0 +1,125 @@
+#!/usr/bin/env node
+
+/**
+ * Tests for the E2E matrix generation script
+ * Usage: node generate-e2e-matrix.test.js
+ */
+
+const { test } = require('node:test');
+const assert = require('node:assert');
+const { generateE2EMatrix } = require('./generate-e2e-matrix.js');
+
+test('generateE2EMatrix should create cross-product of locales and shards', () => {
+  const localesJson =
+    '[{"locale":"zh-hans","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANS"},{"locale":"zh-hant","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANT"}]';
+  const shardTotal = 3;
+
+  const result = generateE2EMatrix(localesJson, shardTotal);
+
+  // Should have 6 jobs total (2 locales × 3 shards)
+  assert.strictEqual(result.include.length, 6);
+
+  // Check structure
+  assert.ok(
+    result.include.every(
+      (job) =>
+        Object.prototype.hasOwnProperty.call(job, 'locale') &&
+        Object.prototype.hasOwnProperty.call(job, 'shard') &&
+        Object.prototype.hasOwnProperty.call(job, 'secret_project_id'),
+    ),
+  );
+
+  // Check shards are 1-indexed
+  const shards = result.include.map((job) => job.shard).sort();
+  assert.deepStrictEqual(shards, [1, 1, 2, 2, 3, 3]);
+
+  // Check both locales are present
+  const locales = [...new Set(result.include.map((job) => job.locale))];
+  assert.deepStrictEqual(locales.sort(), ['zh-hans', 'zh-hant']);
+});
+
+test('generateE2EMatrix should handle single locale', () => {
+  const localesJson =
+    '[{"locale":"zh-hans","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANS"}]';
+  const shardTotal = 2;
+
+  const result = generateE2EMatrix(localesJson, shardTotal);
+
+  // Should have 2 jobs (1 locale × 2 shards)
+  assert.strictEqual(result.include.length, 2);
+
+  // All jobs should be for zh-hans
+  assert.ok(result.include.every((job) => job.locale === 'zh-hans'));
+
+  // Should have shards 1 and 2
+  const shards = result.include.map((job) => job.shard).sort();
+  assert.deepStrictEqual(shards, [1, 2]);
+});
+
+test('generateE2EMatrix should handle single shard', () => {
+  const localesJson =
+    '[{"locale":"zh-hans","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANS"},{"locale":"zh-hant","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANT"}]';
+  const shardTotal = 1;
+
+  const result = generateE2EMatrix(localesJson, shardTotal);
+
+  // Should have 2 jobs (2 locales × 1 shard)
+  assert.strictEqual(result.include.length, 2);
+
+  // All jobs should have shard 1
+  assert.ok(result.include.every((job) => job.shard === 1));
+
+  // Should have both locales
+  const locales = result.include.map((job) => job.locale).sort();
+  assert.deepStrictEqual(locales, ['zh-hans', 'zh-hant']);
+});
+
+test('generateE2EMatrix should preserve additional properties', () => {
+  const localesJson =
+    '[{"locale":"zh-hans","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANS","extra":"value"}]';
+  const shardTotal = 2;
+
+  const result = generateE2EMatrix(localesJson, shardTotal);
+
+  // Should preserve the extra property
+  assert.ok(result.include.every((job) => job.extra === 'value'));
+  assert.ok(
+    result.include.every(
+      (job) => job.secret_project_id === 'VERCEL_PROJECT_ID_ZH_HANS',
+    ),
+  );
+});
+
+test('generateE2EMatrix should handle large shard counts', () => {
+  const localesJson =
+    '[{"locale":"zh-hans","secret_project_id":"VERCEL_PROJECT_ID_ZH_HANS"}]';
+  const shardTotal = 10;
+
+  const result = generateE2EMatrix(localesJson, shardTotal);
+
+  // Should have 10 jobs
+  assert.strictEqual(result.include.length, 10);
+
+  // Should have shards 1 through 10
+  const shards = result.include.map((job) => job.shard).sort((a, b) => a - b);
+  assert.deepStrictEqual(shards, [1, 2, 3, 4, 5, 6, 7, 8, 9, 10]);
+});
+
+test('generateE2EMatrix should handle empty locales array', () => {
+  const localesJson = '[]';
+  const shardTotal = 3;
+
+  const result = generateE2EMatrix(localesJson, shardTotal);
+
+  // Should have no jobs
+  assert.strictEqual(result.include.length, 0);
+});
+
+test('generateE2EMatrix should throw on invalid JSON', () => {
+  try {
+    generateE2EMatrix('invalid json', 3);
+    assert.fail('Expected function to throw');
+  } catch (error) {
+    assert.ok(error.message.includes('Unexpected token'));
+  }
+});

.github/scripts/generate-prerelease-matrix.test.js

@@ -0,0 +1,147 @@
+#!/usr/bin/env node
+
+/**
+ * Simple tests for the prerelease matrix generation script
+ * Usage: node test-prerelease-matrix.js
+ */
+
+const { test } = require('node:test');
+const assert = require('node:assert');
+const {
+  processPrerelease,
+  isLocaleEnabled,
+  getLocaleConfig,
+} = require('./generate-prerelease-matrix.js');
+
+// Mock locale config for testing
+const mockLocaleConfig = {
+  en: {
+    secret_project_id: 'VERCEL_PROJECT_EN_ID',
+    enabled: true,
+  },
+  'zh-hans': {
+    secret_project_id: 'VERCEL_PROJECT_ZH_HANS_ID',
+    enabled: true,
+  },
+  'zh-hant': {
+    secret_project_id: 'VERCEL_PROJECT_ZH_HANT_ID',
+    enabled: true,
+  },
+  ja: {
+    secret_project_id: 'VERCEL_PROJECT_JA_ID',
+    enabled: false,
+  },
+  es: {
+    secret_project_id: 'VERCEL_PROJECT_ES_ID',
+    enabled: false,
+  },
+};
+
+test('isLocaleEnabled should return correct boolean values', () => {
+  assert.strictEqual(isLocaleEnabled(mockLocaleConfig, 'en'), true);
+  assert.strictEqual(isLocaleEnabled(mockLocaleConfig, 'zh-hans'), true);
+  assert.strictEqual(isLocaleEnabled(mockLocaleConfig, 'zh-hant'), true);
+  assert.strictEqual(isLocaleEnabled(mockLocaleConfig, 'ja'), false);
+  assert.strictEqual(isLocaleEnabled(mockLocaleConfig, 'es'), false);
+  assert.strictEqual(isLocaleEnabled(mockLocaleConfig, 'nonexistent'), false);
+});
+
+test('getLocaleConfig should return correct configuration values', () => {
+  assert.strictEqual(
+    getLocaleConfig(mockLocaleConfig, 'en', 'secret_project_id'),
+    'VERCEL_PROJECT_EN_ID',
+  );
+  assert.strictEqual(
+    getLocaleConfig(mockLocaleConfig, 'zh-hans', 'secret_project_id'),
+    'VERCEL_PROJECT_ZH_HANS_ID',
+  );
+  assert.strictEqual(
+    getLocaleConfig(mockLocaleConfig, 'nonexistent', 'secret_project_id'),
+    '',
+  );
+  assert.strictEqual(
+    getLocaleConfig(mockLocaleConfig, 'en', 'nonexistent_field'),
+    '',
+  );
+});
+
+test('processPrerelease should handle general prerelease label (deploy all enabled locales)', () => {
+  const result = processPrerelease(mockLocaleConfig, ['prerelease']);
+
+  // Should include all enabled locales
+  assert.strictEqual(result.matrixInclude.length, 3);
+  assert.strictEqual(result.hasChanges, true);
+
+  const locales = result.matrixInclude.map((item) => item.locale);
+  assert.ok(locales.includes('en'));
+  assert.ok(locales.includes('zh-hans'));
+  assert.ok(locales.includes('zh-hant'));
+  assert.ok(!locales.includes('ja')); // ja is disabled
+  assert.ok(!locales.includes('es')); // es is disabled
+});
+
+test('processPrerelease should handle specific locale prerelease', () => {
+  const result = processPrerelease(mockLocaleConfig, [
+    'prerelease:en',
+    'prerelease:zh-hans',
+  ]);
+
+  // Should include only the specified locales
+  assert.strictEqual(result.matrixInclude.length, 2);
+  assert.strictEqual(result.hasChanges, true);
+
+  const locales = result.matrixInclude.map((item) => item.locale);
+  assert.ok(locales.includes('en'));
+  assert.ok(locales.includes('zh-hans'));
+  assert.ok(!locales.includes('zh-hant'));
+});
+
+test('processPrerelease should skip disabled locales', () => {
+  const result = processPrerelease(mockLocaleConfig, ['prerelease:ja']);
+
+  // Should not include disabled locale
+  assert.strictEqual(result.matrixInclude.length, 0);
+  assert.strictEqual(result.hasChanges, false);
+});
+
+test('processPrerelease should handle mixed labels (general + specific)', () => {
+  const result = processPrerelease(mockLocaleConfig, [
+    'prerelease',
+    'prerelease:ja',
+  ]);
+
+  // General prerelease should take precedence - deploy all enabled locales
+  assert.strictEqual(result.matrixInclude.length, 3);
+  assert.strictEqual(result.hasChanges, true);
+
+  const locales = result.matrixInclude.map((item) => item.locale);
+  assert.ok(locales.includes('en'));
+  assert.ok(locales.includes('zh-hans'));
+  assert.ok(locales.includes('zh-hant'));
+});
+
+test('processPrerelease should handle no prerelease labels', () => {
+  const result = processPrerelease(mockLocaleConfig, ['bug', 'feature']);
+
+  // Should include no locales when no prerelease labels
+  assert.strictEqual(result.matrixInclude.length, 0);
+  assert.strictEqual(result.hasChanges, false);
+});
+
+test('processPrerelease should handle empty labels array', () => {
+  const result = processPrerelease(mockLocaleConfig, []);
+
+  // Should include no locales when no labels
+  assert.strictEqual(result.matrixInclude.length, 0);
+  assert.strictEqual(result.hasChanges, false);
+});
+
+test('processPrerelease should handle non-existent locale', () => {
+  const result = processPrerelease(mockLocaleConfig, ['prerelease:invalid']);
+
+  // Should not include non-existent locale
+  assert.strictEqual(result.matrixInclude.length, 0);
+  assert.strictEqual(result.hasChanges, false);
+});
+
+console.log('All tests passed! ✅');