@c-time/frelio-cli 1.7.0 → 2.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (42) hide show
  1. package/README.md +60 -97
  2. package/dist/commands/add-staging.js +8 -8
  3. package/dist/commands/bake.d.ts +14 -0
  4. package/dist/commands/bake.js +59 -0
  5. package/dist/commands/init.d.ts +1 -4
  6. package/dist/commands/init.js +37 -108
  7. package/dist/commands/set-domain.js +1 -1
  8. package/dist/commands/set-mode.js +1 -6
  9. package/dist/commands/update.d.ts +2 -2
  10. package/dist/commands/update.js +3 -8
  11. package/dist/core/__fixtures__/template/worker/index.d.ts +4 -0
  12. package/dist/core/__fixtures__/template/worker/index.js +6 -0
  13. package/dist/core/bake.d.ts +39 -0
  14. package/dist/core/bake.js +104 -0
  15. package/dist/core/bundle.js +14 -12
  16. package/dist/core/cloudflare.d.ts +26 -11
  17. package/dist/core/cloudflare.js +28 -30
  18. package/dist/core/config.js +25 -6
  19. package/dist/core/file-generators.d.ts +16 -13
  20. package/dist/core/file-generators.js +34 -52
  21. package/dist/core/index.d.ts +2 -3
  22. package/dist/core/index.js +2 -4
  23. package/dist/core/migrations/pages-to-workers-issue184.d.ts +18 -0
  24. package/dist/core/migrations/pages-to-workers-issue184.js +70 -0
  25. package/dist/core/migrations/registry.js +8 -1
  26. package/dist/core/site-mode.d.ts +5 -6
  27. package/dist/core/site-mode.js +5 -6
  28. package/dist/core/status.js +1 -2
  29. package/dist/core/template-refresh.d.ts +8 -2
  30. package/dist/core/template-refresh.js +63 -22
  31. package/dist/core/types.d.ts +0 -2
  32. package/dist/index.js +9 -4
  33. package/dist/lib/npm-registry.d.ts +4 -4
  34. package/dist/lib/npm-registry.js +4 -4
  35. package/dist/lib/resource-links.d.ts +1 -1
  36. package/dist/lib/resource-links.js +4 -4
  37. package/dist/lib/template-renderer.js +3 -6
  38. package/dist/lib/templates.d.ts +33 -57
  39. package/dist/lib/templates.js +82 -579
  40. package/package.json +3 -1
  41. package/dist/core/terraform.d.ts +0 -7
  42. package/dist/core/terraform.js +0 -47
@@ -8,7 +8,7 @@ import prompts from 'prompts';
8
8
  import fs from 'node:fs';
9
9
  import path from 'node:path';
10
10
  import { log, logStep, logSuccess, logError } from '../lib/shell.js';
11
- import { generateStagingDomain, buildPagesProjectNames, } from '../lib/templates.js';
11
+ import { generateStagingDomain, buildWorkerNames, } from '../lib/templates.js';
12
12
  import { buildResourceLinks } from '../lib/resource-links.js';
13
13
  import { validateContentRepo, validateR2PublicUrl, validateRequired } from '../lib/validators.js';
14
14
  // core functions
@@ -19,7 +19,6 @@ import { setupCloudflareResources } from '../core/cloudflare.js';
19
19
  import { setupContactWorker } from '../core/contact.js';
20
20
  import { createFullContentStructure } from '../core/content-structure.js';
21
21
  import { regenerateAllConfigFiles } from '../core/file-generators.js';
22
- import { generateTerraformFiles } from '../core/terraform.js';
23
22
  import { installBundle } from '../core/bundle.js';
24
23
  import { initialCommitAndBranches, getGitIdentity, setGitIdentity, } from '../core/git-operations.js';
25
24
  export async function initCommand(options) {
@@ -31,7 +30,7 @@ export async function initCommand(options) {
31
30
  const targets = ['git'];
32
31
  if (!options.skipGithub)
33
32
  targets.push('github');
34
- if (!options.skipCloudflare && !options.terraform)
33
+ if (!options.skipCloudflare)
35
34
  targets.push('cloudflare');
36
35
  const prereqs = checkPrerequisitesFor(targets);
37
36
  if (prereqs.success) {
@@ -54,7 +53,7 @@ export async function initCommand(options) {
54
53
  }
55
54
  log('');
56
55
  // ── お問い合わせ機能(任意)──
57
- const contactInput = options.skipCloudflare || options.terraform ? null : await promptContact(config);
56
+ const contactInput = options.skipCloudflare ? null : await promptContact(config);
58
57
  log('');
59
58
  // ── OAuth App 案内 ──
60
59
  log('🔑 GitHub OAuth App:');
@@ -67,9 +66,10 @@ export async function initCommand(options) {
67
66
  log(' ⚠ OAuth App は GitHub の Web UI で作成が必要です。');
68
67
  log(' → https://github.com/settings/developers');
69
68
  log(' → New OAuth App:');
70
- log(` - Application name: ${config.siteTitle || config.adminPagesProjectName} CMS`);
71
- log(` - Homepage URL: https://${config.adminPagesProjectName}.pages.dev`);
72
- log(` - Callback URL: https://${config.adminPagesProjectName}.pages.dev/api/auth/callback`);
69
+ log(` - Application name: ${config.siteTitle || config.adminWorkerName} CMS`);
70
+ log(` - Homepage URL: https://${config.adminWorkerName}.<your-subdomain>.workers.dev`);
71
+ log(` - Callback URL: https://${config.adminWorkerName}.<your-subdomain>.workers.dev/api/auth/callback`);
72
+ log(' (<your-subdomain> は管理画面 Worker 初回デプロイ後に確定する workers.dev サブドメイン。独自ドメイン運用ならそのドメインに読み替え)');
73
73
  log(' - Enable Device Flow: チェックしない(Disable のまま。Frelio は認可コードフローを使用)');
74
74
  log('');
75
75
  const oauthResponse = await prompts([
@@ -153,7 +153,7 @@ export async function initCommand(options) {
153
153
  logError(bundleResult.error);
154
154
  log(' ℹ リリースが公開されていない場合は、手動でバンドルを展開してください。');
155
155
  log(' npm pack @c-time/frelio-cms で取得した tarball を展開し、');
156
- log(' package/dist/(functions を除く)を admin/、package/dist/functions を functions/、');
156
+ log(' package/dist/(worker を除く)を admin/、package/dist/worker を admin-worker/、');
157
157
  log(' package/workers を workers/ に配置します。');
158
158
  }
159
159
  // 設定ファイル生成
@@ -167,26 +167,14 @@ export async function initCommand(options) {
167
167
  logError(configResult.error);
168
168
  process.exit(1);
169
169
  }
170
- // Cloudflare セットアップ or Terraform ファイル生成
171
- if (options.terraform) {
172
- step++;
173
- logStep(step, totalSteps, 'Terraform ファイル生成...');
174
- const tfResult = generateTerraformFiles(projectDir, config);
175
- if (tfResult.success) {
176
- logSuccess('Terraform ファイル生成完了(terraform/)');
177
- }
178
- else {
179
- logError(tfResult.error);
180
- }
181
- }
182
- else if (!options.skipCloudflare) {
170
+ // Cloudflare セットアップ
171
+ if (!options.skipCloudflare) {
183
172
  step++;
184
173
  logStep(step, totalSteps, 'Cloudflare セットアップ...');
185
174
  const secret = config.githubClientSecret;
186
- const cfToken = config.cloudflareApiToken;
187
- const cfResult = setupCloudflareResources(config, secret, cfToken);
175
+ const cfResult = setupCloudflareResources(config, secret);
188
176
  if (cfResult.success) {
189
- const { r2Bucket, contentPages, adminPages, secrets } = cfResult.data;
177
+ const { r2Bucket, secrets, needsWorkersDevSubdomain } = cfResult.data;
190
178
  if (r2Bucket.success) {
191
179
  logSuccess(r2Bucket.alreadyExisted
192
180
  ? `R2 バケット "${config.r2BucketName}" は既に存在します`
@@ -195,30 +183,20 @@ export async function initCommand(options) {
195
183
  else {
196
184
  logError(r2Bucket.error);
197
185
  }
198
- if (contentPages.success) {
199
- logSuccess(contentPages.alreadyExisted
200
- ? `Pages プロジェクト "${config.pagesProjectName}" は既に存在します`
201
- : `Pages プロジェクト "${config.pagesProjectName}"(コンテンツ配信)作成完了`);
202
- }
203
- else {
204
- logError(contentPages.error);
205
- }
206
- if (adminPages.success) {
207
- logSuccess(adminPages.alreadyExisted
208
- ? `Pages プロジェクト "${config.adminPagesProjectName}" は既に存在します`
209
- : `Pages プロジェクト "${config.adminPagesProjectName}"(管理画面)作成完了`);
210
- }
211
- else {
212
- logError(adminPages.error);
213
- }
186
+ // Issue #184: Worker は wrangler deploy 時に自動作成される(事前作成は不要)。
187
+ // admin Worker のシークレット(GITHUB_CLIENT_SECRET)は
188
+ // wrangler secret put が Worker を自動作成して設定する(初回デプロイ前でも可)。
214
189
  for (const s of secrets) {
215
190
  if (s.success) {
216
- logSuccess('シークレット設定完了');
191
+ logSuccess('admin Worker シークレット設定完了');
217
192
  }
218
193
  else {
219
194
  logError(s.error);
220
195
  }
221
196
  }
197
+ if (needsWorkersDevSubdomain) {
198
+ log(' ℹ staging プレビュー URL(<branch>-<worker>.<subdomain>.workers.dev)は、admin Worker の初回デプロイで workers.dev サブドメインが登録されてから有効になります。');
199
+ }
222
200
  }
223
201
  }
224
202
  // お問い合わせワーカー(任意)
@@ -266,15 +244,15 @@ export async function initCommand(options) {
266
244
  log('');
267
245
  log('✅ セットアップ完了!');
268
246
  log('');
269
- log(` 管理画面: https://${config.adminPagesProjectName}.pages.dev/admin/`);
247
+ log(` 管理画面: https://${config.adminWorkerName}.<your-subdomain>.workers.dev/(admin Worker 初回デプロイ後)`);
270
248
  // カスタムドメイン未設定時は staging ブランチのプレビューエイリアス(GitHub Actions の
271
- // wrangler デプロイで生成)を案内する。Cloudflare の Git 連携ブランチプレビューは使わない。
272
- log(` プレビュー: ${config.previewUrl || `https://staging.${config.pagesProjectName}.pages.dev`}`);
249
+ // wrangler versions upload --preview-alias で生成)を案内する。
250
+ log(` プレビュー: ${config.previewUrl || `https://staging-${config.contentWorkerName}.<your-subdomain>.workers.dev`}`);
273
251
  log('');
274
252
  // 作成したリソースへのリンク(確認・設定変更の導線)
275
253
  const resourceSections = buildResourceLinks(config, {
276
254
  github: !options.skipGithub,
277
- cloudflare: !options.terraform && !options.skipCloudflare,
255
+ cloudflare: !options.skipCloudflare,
278
256
  });
279
257
  if (resourceSections.length > 0) {
280
258
  log('🔗 作成したリソース:');
@@ -286,27 +264,14 @@ export async function initCommand(options) {
286
264
  }
287
265
  log('');
288
266
  }
289
- if (options.terraform) {
290
- log(' Terraform でインフラを構築:');
291
- log(` 1. cd ${repoName}/terraform`);
292
- log(' 2. cp terraform.tfvars.example terraform.tfvars && vim terraform.tfvars');
293
- log(' 3. terraform init');
294
- log(' 4. terraform plan');
295
- log(' 5. terraform apply');
296
- log('');
297
- log(' 残りの手動作業:');
298
- log(` 1. コンテンツ配信 Pages(${config.pagesProjectName})にリポジトリを接続`);
299
- log(` 2. 管理画面 Pages(${config.adminPagesProjectName})にリポジトリを接続(admin ブランチ)`);
300
- }
301
- else {
302
- log(' 残りの手動作業:');
303
- log(` 1. コンテンツ配信 Pages(${config.pagesProjectName})にリポジトリを接続`);
304
- log(` 2. 管理画面 Pages(${config.adminPagesProjectName})にリポジトリを接続(admin ブランチ)`);
305
- }
267
+ log(' 残りの手動作業:');
268
+ log(' 1. GitHub Actions シークレットを設定: CLOUDFLARE_API_TOKEN / CLOUDFLARE_ACCOUNT_ID');
269
+ log(' 2. admin ブランチへ push して管理画面 Worker を初回デプロイ(workers.dev サブドメインが登録される)');
270
+ log(' 3. staging ブランチへ push してコンテンツのプレビュー、main で本番デプロイ');
306
271
  if (config.stagingDomain) {
307
- log(` 3. プレビュー用カスタムドメインを設定: ${config.stagingDomain}`);
272
+ log(` 4. プレビュー用カスタムドメインを設定: ${config.stagingDomain}`);
308
273
  }
309
- log(` ${config.stagingDomain ? '4' : '3'}. ステージングのアクセス制限を設定(Cloudflare Access 推奨)`);
274
+ log(` ${config.stagingDomain ? '5' : '4'}. ステージングのアクセス制限を設定(Cloudflare Access 推奨)`);
310
275
  log('');
311
276
  }
312
277
  // ---------------------------------------------------------------------------
@@ -377,7 +342,10 @@ async function promptContact(config) {
377
342
  }, { onCancel: () => process.exit(0) });
378
343
  if (!enable.value)
379
344
  return null;
380
- const adminInboxUrl = `https://${config.adminPagesProjectName}.pages.dev/inbox`;
345
+ // Issue #184: 管理画面は Worker(<admin>.<subdomain>.workers.dev)配信。サブドメインは
346
+ // 初回デプロイまで未確定のため暫定値を入れる。確定後に CMS 基本設定 / contact worker の
347
+ // ADMIN_INBOX_URL を実 URL(または独自ドメイン)へ更新する。
348
+ const adminInboxUrl = `https://${config.adminWorkerName}.workers.dev/inbox`;
381
349
  const base = await prompts([
382
350
  {
383
351
  type: 'text',
@@ -557,36 +525,6 @@ async function promptConfig(options) {
557
525
  return userResult.success ? userResult.data.username : '';
558
526
  },
559
527
  },
560
- {
561
- type: options.cloudflareAccountId !== undefined
562
- ? null
563
- : () => {
564
- log('');
565
- log(' ℹ Cloudflare アカウント ID / API トークン(デプロイ管理機能 / Issue #27)');
566
- log(' 管理画面のデプロイ履歴で Cloudflare Pages のデプロイ一覧・削除を行うために使用します。');
567
- log(' アカウント ID: Cloudflare ダッシュボードの URL や任意ページの右サイドバーで確認できます。');
568
- log(' 未入力なら空欄のまま Enter(後から admin/config.json と wrangler.toml で設定可)');
569
- return 'text';
570
- },
571
- name: 'cloudflareAccountId',
572
- message: 'Cloudflare アカウント ID (任意):',
573
- initial: '',
574
- },
575
- {
576
- type: options.cloudflareApiToken !== undefined
577
- ? null
578
- : () => {
579
- log('');
580
- log(' ℹ Cloudflare API トークン(任意・シークレット)');
581
- log(' スコープ: Account → Cloudflare Pages: Edit(一覧取得+削除に必要)');
582
- log(' Dashboard → My Profile → API Tokens → Create Token で発行できます。');
583
- log(' 管理画面 Pages プロジェクトのシークレットとして登録されます(コミットされません)。');
584
- return 'password';
585
- },
586
- name: 'cloudflareApiToken',
587
- message: 'Cloudflare API トークン (任意):',
588
- initial: '',
589
- },
590
528
  ], { onCancel: () => process.exit(0) });
591
529
  const contentRepo = options.contentRepo || response.contentRepo;
592
530
  if (!contentRepo)
@@ -594,7 +532,7 @@ async function promptConfig(options) {
594
532
  const repoName = contentRepo.split('/')[1];
595
533
  const stagingDomain = options.stagingDomain ?? response.stagingDomain ?? '';
596
534
  const previewUrl = stagingDomain ? `https://${stagingDomain}` : '';
597
- const { pagesProjectName, adminPagesProjectName } = buildPagesProjectNames(repoName, options.randomSuffix ?? true);
535
+ const { contentWorkerName, adminWorkerName } = buildWorkerNames(repoName, options.randomSuffix ?? true);
598
536
  const config = {
599
537
  contentRepo,
600
538
  githubClientId: options.clientId || '',
@@ -603,20 +541,15 @@ async function promptConfig(options) {
603
541
  previewUrl,
604
542
  r2BucketName: options.r2BucketName ?? response.r2BucketName ?? `${repoName}-files`,
605
543
  r2PublicUrl: options.r2PublicUrl ?? response.r2PublicUrl ?? '',
606
- pagesProjectName,
607
- adminPagesProjectName,
544
+ contentWorkerName,
545
+ adminWorkerName,
608
546
  ownerUsername: options.ownerUsername ?? response.ownerUsername ?? '',
609
547
  stagingDomain,
610
- cloudflareAccountId: options.cloudflareAccountId ?? response.cloudflareAccountId ?? '',
611
548
  saveTimezone: '+09:00',
612
549
  };
613
550
  if (options.clientSecret) {
614
551
  config.githubClientSecret = options.clientSecret;
615
552
  }
616
- const cloudflareApiToken = options.cloudflareApiToken ?? response.cloudflareApiToken;
617
- if (cloudflareApiToken) {
618
- config.cloudflareApiToken = cloudflareApiToken;
619
- }
620
553
  return config;
621
554
  }
622
555
  function buildConfigFromOptions(options) {
@@ -629,7 +562,6 @@ function buildConfigFromOptions(options) {
629
562
  r2BucketName: options.r2BucketName,
630
563
  r2PublicUrl: options.r2PublicUrl,
631
564
  ownerUsername: options.ownerUsername,
632
- cloudflareAccountId: options.cloudflareAccountId,
633
565
  randomSuffix: options.randomSuffix,
634
566
  });
635
567
  if (!result.success) {
@@ -647,16 +579,13 @@ function buildConfigFromOptions(options) {
647
579
  return {
648
580
  ...config,
649
581
  githubClientSecret: options.clientSecret,
650
- cloudflareApiToken: options.cloudflareApiToken,
651
582
  };
652
583
  }
653
584
  function getTotalSteps(options, withContact = false) {
654
585
  let steps = 3; // content structure (includes workflows), bundle, config files
655
586
  if (!options.skipGithub)
656
587
  steps += 4; // create repo, clone, git identity, commit/push
657
- if (options.terraform)
658
- steps += 1;
659
- else if (!options.skipCloudflare)
588
+ if (!options.skipCloudflare)
660
589
  steps += 1;
661
590
  if (withContact)
662
591
  steps += 1;
@@ -130,7 +130,7 @@ export async function setDomainCommand(options) {
130
130
  log(' 次の手動作業:');
131
131
  log(' 1. 差分を確認して develop へ commit / push');
132
132
  log(' (wrangler.toml [vars] はデプロイ時に自動適用される / Issue #23)');
133
- log(' 2. Cloudflare Pages にカスタムドメインを追加(本番 + プレビュー)');
133
+ log(' 2. Cloudflare Dashboard → 対象 Worker → Settings → Domains & Routes でカスタムドメインを追加(本番 + プレビュー)');
134
134
  log(' 3. R2 公開バケットのカスタムドメインを設定(独自ドメイン化した場合)');
135
135
  log(' 4. GitHub OAuth App の Homepage / Callback URL を新ドメインに更新');
136
136
  log(' 5. file-upload Worker を別運用している場合は再デプロイ:');
@@ -29,13 +29,8 @@ export async function setModeCommand(mode) {
29
29
  log(` - ${p}`);
30
30
  }
31
31
  log('');
32
- log(' ⚠ エッジ(functions/_middleware.ts)が読むのは wrangler.toml [vars] の SITE_MODE です。');
33
- log(' 変更を反映するにはコンテンツ Pages の再デプロイが必要です:');
32
+ log(' ⚠ siteMode は worker/site-mode.ts に焼き込まれます。反映にはコンテンツの再デプロイが必要です:');
34
33
  log(' 1. 差分を develop へ commit / push');
35
34
  log(' 2. CMS の「直接デプロイ」フロー、または該当ブランチへの push でコンテンツを再デプロイ');
36
35
  log('');
37
- log(' 💡 最速の切替(キルスイッチ等で再ビルドを避けたい場合):');
38
- log(' - wrangler.toml の SITE_MODE を変更し `wrangler pages deploy public --project-name=<content>` で再デプロイ');
39
- log(' - もしくは Cloudflare Dashboard の Pages → 該当プロジェクト → Settings → Variables で SITE_MODE を変更し再デプロイ');
40
- log('');
41
36
  }
@@ -1,9 +1,9 @@
1
1
  /**
2
2
  * frelio update - CMS Admin バンドル+テンプレートの更新
3
3
  *
4
- * - バンドル: core/bundle の updateBundle(admin/ functions/api workers/)
4
+ * - バンドル: core/bundle の updateBundle(admin/ SPA・admin-worker/・workers/)
5
5
  * - テンプレート: core/template-refresh の refreshTemplates(.github ワークフロー /
6
- * wrangler.toml / functions/storage / _redirects / _routes.json)
6
+ * AGENTS.md / CLAUDE.md / wrangler.content.toml / wrangler.admin.toml / worker/site-mode.ts)
7
7
  */
8
8
  type UpdateOptions = {
9
9
  version?: string;
@@ -1,9 +1,9 @@
1
1
  /**
2
2
  * frelio update - CMS Admin バンドル+テンプレートの更新
3
3
  *
4
- * - バンドル: core/bundle の updateBundle(admin/ functions/api workers/)
4
+ * - バンドル: core/bundle の updateBundle(admin/ SPA・admin-worker/・workers/)
5
5
  * - テンプレート: core/template-refresh の refreshTemplates(.github ワークフロー /
6
- * wrangler.toml / functions/storage / _redirects / _routes.json)
6
+ * AGENTS.md / CLAUDE.md / wrangler.content.toml / wrangler.admin.toml / worker/site-mode.ts)
7
7
  */
8
8
  import fs from 'node:fs';
9
9
  import path from 'node:path';
@@ -69,7 +69,7 @@ export async function updateCommand(options) {
69
69
  log('');
70
70
  }
71
71
  else {
72
- log(' 📥 テンプレート(ワークフロー / functions / wrangler)を再生成中...');
72
+ log(' 📥 テンプレート(ワークフロー / AI 文書 / functions / wrangler)を再生成中...');
73
73
  const refresh = await refreshTemplates(projectDir, config, {
74
74
  force: options.force,
75
75
  });
@@ -92,9 +92,4 @@ export async function updateCommand(options) {
92
92
  log(' develop へマージしただけでは反映されません。次のように admin を進めてください:');
93
93
  log(' git push origin origin/develop:admin # develop はメインブランチ名に読み替え');
94
94
  log('');
95
- log(' ℹ デプロイ管理機能(Issue #27)を使う場合は次の環境変数が必要です:');
96
- log(' • CLOUDFLARE_API_TOKEN … 管理画面 Pages のシークレット(wrangler pages secret put)');
97
- log(' • CLOUDFLARE_ACCOUNT_ID … wrangler.toml の [vars]');
98
- log(' • PAGES_PROJECT_NAME … wrangler.toml の [vars](コンテンツ配信 Pages プロジェクト名)');
99
- log('');
100
95
  }
@@ -0,0 +1,4 @@
1
+ declare const _default: {
2
+ fetch(): Promise<Response>;
3
+ };
4
+ export default _default;
@@ -0,0 +1,6 @@
1
+ // フィクスチャ: コンテンツ配信 Worker 本体(worker/index.ts)の verbatim 配信検証用(Issue #189)。
2
+ export default {
3
+ async fetch() {
4
+ return new Response('fixture content worker');
5
+ },
6
+ };
@@ -0,0 +1,39 @@
1
+ /**
2
+ * core/bake — テンプレート焼き込み(issue #168)
3
+ *
4
+ * 各ページテンプレを gentl で1パス処理し、`data-gen-include`(共通クローム)と
5
+ * `data-gen-repeat`(実サンプルデータ)を解決した結果をテンプレート自身へ書き戻す。
6
+ * 焼き込み済みテンプレはサーバー無し(file://)でもクローム+実データが見えるプレビューになる。
7
+ *
8
+ * 雛形の `scripts/bake-templates.ts` と同一処理(ロジックは @c-time/frelio-gentl の
9
+ * bakeTemplates に集約)。CLI 版は既存サイト(雛形にスクリプトが無い)向け。
10
+ *
11
+ * gentl 出力は `<template data-gen-*>` ソースを保持するため冪等(再ビルド・再 bake 可能)。
12
+ */
13
+ import { type OperationResult } from './types.js';
14
+ export type BakePick = 'latest' | 'first';
15
+ export type BakeOptions = {
16
+ /** 書き込まず結果のみ返す */
17
+ dryRun?: boolean;
18
+ /** 冪等性検証。書き込まず、焼き込みが最新でなければ drift を返す(CI 用) */
19
+ check?: boolean;
20
+ /** detail テンプレの代表データ選定(既定 latest) */
21
+ pick?: BakePick;
22
+ };
23
+ export type BakeRunResult = {
24
+ /** 焼き込み(書き戻し)したテンプレ数 */
25
+ written: number;
26
+ /** 焼き込み対象テンプレ(templatePath と代表元件数) */
27
+ outputs: {
28
+ templatePath: string;
29
+ sourceCount: number;
30
+ }[];
31
+ /** --check で検出した差分テンプレ(焼き込みが最新でない) */
32
+ drift: string[];
33
+ /** レンダリングエラー件数 */
34
+ errors: number;
35
+ };
36
+ /**
37
+ * テンプレートを焼き込んでプロジェクトに書き戻す。
38
+ */
39
+ export declare function runBake(projectDir: string, opts?: BakeOptions): Promise<OperationResult<BakeRunResult>>;
@@ -0,0 +1,104 @@
1
+ /**
2
+ * core/bake — テンプレート焼き込み(issue #168)
3
+ *
4
+ * 各ページテンプレを gentl で1パス処理し、`data-gen-include`(共通クローム)と
5
+ * `data-gen-repeat`(実サンプルデータ)を解決した結果をテンプレート自身へ書き戻す。
6
+ * 焼き込み済みテンプレはサーバー無し(file://)でもクローム+実データが見えるプレビューになる。
7
+ *
8
+ * 雛形の `scripts/bake-templates.ts` と同一処理(ロジックは @c-time/frelio-gentl の
9
+ * bakeTemplates に集約)。CLI 版は既存サイト(雛形にスクリプトが無い)向け。
10
+ *
11
+ * gentl 出力は `<template data-gen-*>` ソースを保持するため冪等(再ビルド・再 bake 可能)。
12
+ */
13
+ import fs from 'node:fs';
14
+ import path from 'node:path';
15
+ import { bakeTemplates, NodeFileSystem, selectLatestRepresentative, selectFirstRepresentative, } from '@c-time/frelio-gentl';
16
+ import { ok, fail } from './types.js';
17
+ const DATA_JSON_ROOT = 'frelio-data/site/data/data-json';
18
+ const TEMPLATE_ROOT = 'frelio-data/site/templates';
19
+ /** gentl(happy-dom)出力は DOCTYPE を含まないため、file:// 直開き用に再付与する */
20
+ function ensureDoctype(html) {
21
+ return /^\s*<!doctype/i.test(html) ? html : `<!DOCTYPE html>\n${html}`;
22
+ }
23
+ function collectJsonFiles(dir) {
24
+ if (!fs.existsSync(dir))
25
+ return [];
26
+ const files = [];
27
+ for (const entry of fs.readdirSync(dir, { withFileTypes: true })) {
28
+ const full = path.join(dir, entry.name);
29
+ if (entry.isDirectory()) {
30
+ files.push(...collectJsonFiles(full));
31
+ }
32
+ else if (path.extname(entry.name) === '.json') {
33
+ files.push(full);
34
+ }
35
+ }
36
+ return files;
37
+ }
38
+ /**
39
+ * テンプレートを焼き込んでプロジェクトに書き戻す。
40
+ */
41
+ export async function runBake(projectDir, opts = {}) {
42
+ const pick = opts.pick ?? 'latest';
43
+ const templateRoot = path.join(projectDir, TEMPLATE_ROOT);
44
+ const dataJsonRoot = path.join(projectDir, DATA_JSON_ROOT);
45
+ if (!fs.existsSync(templateRoot)) {
46
+ return fail(`テンプレートディレクトリが見つかりません: ${TEMPLATE_ROOT}。Frelio プロジェクトのルートで実行してください。`, 'NOT_FOUND');
47
+ }
48
+ if (!fs.existsSync(dataJsonRoot)) {
49
+ return fail(`data-json が見つかりません: ${DATA_JSON_ROOT}。先に data-json を生成してください(npm run generate)。`, 'NOT_FOUND');
50
+ }
51
+ const jsonFiles = collectJsonFiles(dataJsonRoot);
52
+ if (jsonFiles.length === 0) {
53
+ return fail(`data-json が空です。先に data-json を生成してください(npm run generate)。`, 'NOT_FOUND');
54
+ }
55
+ let dataJsons;
56
+ try {
57
+ dataJsons = jsonFiles.map((f) => JSON.parse(fs.readFileSync(f, 'utf-8')));
58
+ }
59
+ catch (e) {
60
+ return fail(`data-json の読み込みに失敗しました: ${e.message}`, 'EXEC_FAILED');
61
+ }
62
+ const selectRepresentative = pick === 'first' ? selectFirstRepresentative : selectLatestRepresentative;
63
+ let result;
64
+ try {
65
+ result = await bakeTemplates({
66
+ dataJsons,
67
+ templateRootPath: templateRoot,
68
+ fileSystem: new NodeFileSystem(),
69
+ options: { logLevel: 'quiet' },
70
+ selectRepresentative,
71
+ });
72
+ }
73
+ catch (e) {
74
+ return fail(`焼き込みに失敗しました: ${e.message}`, 'EXEC_FAILED');
75
+ }
76
+ const drift = [];
77
+ let written = 0;
78
+ for (const output of result.outputs) {
79
+ const fullPath = path.join(templateRoot, output.templatePath);
80
+ const baked = ensureDoctype(output.html);
81
+ if (opts.check) {
82
+ const current = fs.existsSync(fullPath) ? fs.readFileSync(fullPath, 'utf-8') : '';
83
+ if (current !== baked)
84
+ drift.push(output.templatePath);
85
+ continue;
86
+ }
87
+ if (opts.dryRun)
88
+ continue;
89
+ // テンプレートは既存ファイル。ディレクトリは作らない(パス不一致=設定ミスを検出)
90
+ if (!fs.existsSync(fullPath))
91
+ continue;
92
+ fs.writeFileSync(fullPath, baked);
93
+ written++;
94
+ }
95
+ return ok({
96
+ written,
97
+ outputs: result.outputs.map((o) => ({
98
+ templatePath: o.templatePath,
99
+ sourceCount: o.sourceCount,
100
+ })),
101
+ drift,
102
+ errors: result.report.stats.errors,
103
+ });
104
+ }
@@ -14,12 +14,14 @@ export async function installBundle(projectDir, version) {
14
14
  try {
15
15
  const release = version ? await getRelease(version) : await getLatestRelease();
16
16
  const tarPath = await downloadTarball(release, tmpDir);
17
- const { adminDir, functionsDir, workersDir } = await extractNpmTarball(tarPath, tmpDir);
17
+ const { adminDir, adminWorkerDir, workersDir } = await extractNpmTarball(tarPath, tmpDir);
18
18
  if (fs.existsSync(adminDir)) {
19
- copyDir(adminDir, path.join(projectDir, 'admin'), ['functions']);
19
+ // dist/ 直下の worker/(バンドル済み admin Worker)は SPA には含めない(別途配置)
20
+ copyDir(adminDir, path.join(projectDir, 'admin'), ['worker']);
20
21
  }
21
- if (fs.existsSync(functionsDir)) {
22
- copyDir(functionsDir, path.join(projectDir, 'functions'));
22
+ // Issue #184 Phase 2: バンドル済み管理画面 Worker を admin-worker/ に配置
23
+ if (fs.existsSync(adminWorkerDir)) {
24
+ copyDir(adminWorkerDir, path.join(projectDir, 'admin-worker'));
23
25
  }
24
26
  if (fs.existsSync(workersDir)) {
25
27
  copyDir(workersDir, path.join(projectDir, 'workers'));
@@ -51,19 +53,19 @@ export async function updateBundle(projectDir, version) {
51
53
  try {
52
54
  const release = version ? await getRelease(version) : await getLatestRelease();
53
55
  const tarPath = await downloadTarball(release, tmpDir);
54
- const { adminDir: srcAdminDir, functionsDir: srcFunctionsDir, workersDir: srcWorkersDir, } = await extractNpmTarball(tarPath, tmpDir);
56
+ const { adminDir: srcAdminDir, adminWorkerDir: srcAdminWorkerDir, workersDir: srcWorkersDir, } = await extractNpmTarball(tarPath, tmpDir);
55
57
  // admin/ 置き換え
56
58
  if (fs.existsSync(srcAdminDir)) {
57
59
  fs.rmSync(adminDir, { recursive: true, force: true });
58
- copyDir(srcAdminDir, adminDir, ['functions']);
60
+ copyDir(srcAdminDir, adminDir, ['worker']);
59
61
  }
60
- // functions/api/ 置き換え(functions/storage/ は保持)
61
- const functionsApiDir = path.join(projectDir, 'functions', 'api');
62
- if (fs.existsSync(path.join(srcFunctionsDir, 'api'))) {
63
- if (fs.existsSync(functionsApiDir)) {
64
- fs.rmSync(functionsApiDir, { recursive: true, force: true });
62
+ // 管理画面 Worker(Issue #184 Phase 2)置き換え: admin-worker/
63
+ const adminWorkerDestDir = path.join(projectDir, 'admin-worker');
64
+ if (fs.existsSync(srcAdminWorkerDir)) {
65
+ if (fs.existsSync(adminWorkerDestDir)) {
66
+ fs.rmSync(adminWorkerDestDir, { recursive: true, force: true });
65
67
  }
66
- copyDir(path.join(srcFunctionsDir, 'api'), functionsApiDir);
68
+ copyDir(srcAdminWorkerDir, adminWorkerDestDir);
67
69
  }
68
70
  // workers/ 置き換え
69
71
  const workersDestDir = path.join(projectDir, 'workers');
@@ -7,10 +7,14 @@ import { type ProjectConfig, type OperationResult } from './types.js';
7
7
  export declare function createR2Bucket(bucketName: string): OperationResult<{
8
8
  alreadyExisted: boolean;
9
9
  }>;
10
- export declare function createPagesProject(projectName: string, productionBranch: string): OperationResult<{
11
- alreadyExisted: boolean;
12
- }>;
13
- export declare function setPagesSecret(projectName: string, secretName: string, secretValue: string): OperationResult;
10
+ /**
11
+ * Worker のシークレットを名前指定で設定する(Issue #184)。
12
+ *
13
+ * `wrangler secret put <name> --name <workerName>`。**Worker が未デプロイの場合は失敗する**
14
+ * (Workers のシークレットは存在する Worker にのみ設定できる)。init では初回デプロイ後に
15
+ * 再実行する案内を出す(fail を握りつぶさず呼び出し側へ返す)。
16
+ */
17
+ export declare function setWorkerSecretByName(workerName: string, secretName: string, secretValue: string): OperationResult;
14
18
  /** D1 データベースを作成し database_id を返す(冪等: 既存はその ID を返す) */
15
19
  export declare function createD1Database(name: string): OperationResult<{
16
20
  databaseId: string;
@@ -22,12 +26,23 @@ export type CloudflareSetupResult = {
22
26
  r2Bucket: OperationResult<{
23
27
  alreadyExisted: boolean;
24
28
  }>;
25
- contentPages: OperationResult<{
26
- alreadyExisted: boolean;
27
- }>;
28
- adminPages: OperationResult<{
29
- alreadyExisted: boolean;
30
- }>;
29
+ /** admin Worker へのシークレット投入結果(未デプロイだと失敗→init が再実行を案内)。 */
31
30
  secrets: OperationResult[];
31
+ /** preview URL に必要な workers.dev サブドメインの案内(自動登録はしない)。 */
32
+ needsWorkersDevSubdomain: boolean;
32
33
  };
33
- export declare function setupCloudflareResources(config: ProjectConfig, githubClientSecret?: string, cloudflareApiToken?: string): OperationResult<CloudflareSetupResult>;
34
+ /**
35
+ * Cloudflare リソースをセットアップする(Issue #184: Workers 構成)。
36
+ *
37
+ * Pages プロジェクトの事前作成は不要(Worker は `wrangler deploy` で自動作成)。
38
+ * ここでは R2 バケット作成と、admin Worker のシークレット投入のみ行う。
39
+ *
40
+ * 注意:
41
+ * - Worker シークレットは **Worker が存在(初回デプロイ済み)してから**設定できる。init 時点で
42
+ * まだ未デプロイなら失敗するため、init は失敗時に「初回デプロイ後に再実行」を案内する。
43
+ * - staging プレビュー URL(`<branch>-<worker>.<subdomain>.workers.dev`)には、アカウントの
44
+ * workers.dev サブドメイン登録が必要。admin Worker は workers_dev=true のため初回デプロイで
45
+ * 自動登録される(未登録のうちは content の preview URL が出ない点に注意)。
46
+ * - GITHUB_CLIENT_ID は wrangler.admin.toml の [vars] で配るためシークレット不要。
47
+ */
48
+ export declare function setupCloudflareResources(config: ProjectConfig, githubClientSecret?: string): OperationResult<CloudflareSetupResult>;