@theholocron/cli 3.44.0 → 3.45.0

package/dist/capabilities/index.d.mts

@@ -630,6 +630,18 @@ interface WikiProvisionOpts {
   /** Project display name used in the wiki title (e.g. "Holocron"). */
   name?: string;
 }
+/**
+ * DNS record that `setup` should create for a wiki custom domain.
+ * Returned by `Wiki.dnsRecord()` when a custom domain is configured.
+ */
+interface WikiDnsRecord {
+  /** Zone apex passed as the first argument to `dns.upsertRecord`. */
+  zone: string;
+  /** Full hostname for the CNAME (e.g. "wiki.theholocron.dev"). */
+  cname: string;
+  /** CNAME target (e.g. "holocron.docs.buildwithfern.com"). */
+  target: string;
+}
 /**
  * Engineering wiki provider.
  *
@@ -642,6 +654,12 @@ interface Wiki extends ProviderIdentity {
   readonly key: "wiki";
   /** Provision the wiki — write config files or call the provider API. */
   provision(opts?: WikiProvisionOpts): Promise<string>;
+  /**
+   * DNS record needed for the custom domain, when one is configured.
+   * Returns null when no custom domain is set.
+   * Called by `setup` to provision the CNAME via the `dns` capability.
+   */
+  dnsRecord?(): WikiDnsRecord | null;
 }
 interface CapabilityImpls {
   source: Source;
@@ -665,4 +683,4 @@ type CardinalityFor<K extends CapabilityKey> = (typeof CARDINALITY)[K];
 type ResolvedCapability<K extends CapabilityKey> = CardinalityFor<K> extends "many" ? CapabilityImpls[K][] : CapabilityImpls[K];
 declare function isMulti<K extends CapabilityKey>(key: K): CardinalityFor<K> extends "many" ? true : false;
 //#endregion
-export { Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, EnsureResult, Environment, EnvironmentReviewer, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiProvisionOpts, isMulti };
+export { Analytics, Auth, AuthDescription, AuthEvent, AuthEventType, AuthIdentity, AuthUser, CARDINALITY, CapabilityImpls, CapabilityKey, Cardinality, CardinalityFor, Ci, CiRun, CiRunFilter, CiRunStatus, ConnectionStringOptions, CreateAuthUserInput, Deployment, DeploymentProject, DeploymentProjectSettings, DeploymentRecord, DeploymentTarget, DeploymentTrigger, Dns, DnsRecord, DnsRecordType, EnsureResult, Environment, EnvironmentReviewer, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, NormalizedAuthUser, Notifications, Observability, PagesConfig, ParseWebhookInput, ProviderApiError, ProviderIdentity, PullRequest, REQUIRED_CAPABILITIES, RepoRef, RepoSettings, ResolvedCapability, Ruleset, SecretScope, Secrets, Source, StatusCategory, Storage, StorageBranch, TeamEntry, TeamPermission, Tooling, ToolingDoctorReport, TrackerDoctorReport, TrackerUser, Vault, WebhookDashboardInfo, WebhookVerificationError, Wiki, WikiDnsRecord, WikiProvisionOpts, isMulti };

package/dist/cli.mjs

@@ -4266,6 +4266,19 @@ async function runSetup(input) {
 			return await wiki.provision({ name: config.name });
 		}));
 		print(formatStep(steps[steps.length - 1]));
+		const wikiDns = wiki.dnsRecord?.();
+		if (wikiDns && loader.has("dns")) {
+			const dns = loader.get("dns");
+			steps.push(await runStep("dns", `upsertRecord ${wikiDns.cname}`, dryRun, async () => {
+				await dns.upsertRecord(wikiDns.zone, {
+					type: "CNAME",
+					name: wikiDns.cname,
+					content: wikiDns.target,
+					ttl: 1
+				});
+			}));
+			print(formatStep(steps[steps.length - 1]));
+		}
 	}
 	if (loader.has("deployment")) {
 		const deploy = loader.get("deployment");
@@ -5372,7 +5385,7 @@ var test_default = "name: Test\n\non: # yamllint disable-line rule:truthy\n  wor
 var typecheck_default = "name: Typecheck\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    secrets:\n      TURBO_TOKEN:\n        required: false\n\njobs:\n  typecheck:\n    name: tsc --noEmit\n    permissions:\n      contents: read\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    env:\n      TURBO_TOKEN: ${{ secrets.TURBO_TOKEN }}\n      TURBO_TEAM: ${{ vars.TURBO_TEAM }}\n    steps:\n      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        name: Checkout repository\n\n      - uses: theholocron/.github/.github/actions/setup@main\n        name: Setup\n\n      - run: pnpm typecheck\n        name: Type check\n\n\n  conclusion:\n    name: Conclusion\n    runs-on: ubuntu-latest\n    if: always()\n    needs: [typecheck]\n    steps:\n      - name: Check job statuses\n        run: |\n          if [[ \"$RESULTS\" == *\"failure\"* ]] || [[ \"$RESULTS\" == *\"cancelled\"* ]]; then\n            exit 1\n          fi\n        env:\n          RESULTS: ${{ join(needs.*.result, ',') }}\n";
 //#endregion
 //#region src/templates/workflows/wiki.yml
-var wiki_default = "name: Wiki\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      fern-version:\n        description: >\n          Fern CLI version to install. Pin this to avoid breaking changes when\n          Fern updates their config schema.\n        type: string\n        required: false\n        default: \"5.35.4\"\n      preview:\n        description: >\n          When true, publishes a preview instead of production.\n          Requires preview-id to be set.\n        type: boolean\n        required: false\n        default: false\n      preview-id:\n        description: >\n          Stable ID for the preview URL. The preview is accessible at\n          {org}-preview-{id}.docs.buildwithfern.com. Use the PR number\n          (e.g. \"pr-123\") so the same URL is reused on every push to\n          the branch.\n        type: string\n        required: false\n        default: \"\"\n    secrets:\n      HOLOCRON_FERN_TOKEN:\n        required: true\n\njobs:\n  publish:\n    name: ${{ inputs.preview && 'Preview' || 'Publish' }} to Fern\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    permissions:\n      contents: read\n    steps:\n      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        name: Checkout repository\n\n      - name: Install Fern CLI\n        run: npm install -g \"fern-api@$FERN_VERSION\"\n        env:\n          FERN_VERSION: ${{ inputs.fern-version }}\n\n      - name: Publish docs\n        if: ${{ !inputs.preview }}\n        run: fern generate --docs\n        env:\n          FERN_TOKEN: ${{ secrets.HOLOCRON_FERN_TOKEN }}\n\n      - name: Preview docs\n        if: ${{ inputs.preview && inputs.preview-id != '' }}\n        run: fern generate --docs --preview --id \"$PREVIEW_ID\"\n        env:\n          FERN_TOKEN: ${{ secrets.HOLOCRON_FERN_TOKEN }}\n          PREVIEW_ID: ${{ inputs.preview-id }}\n";
+var wiki_default = "name: Wiki\n\non: # yamllint disable-line rule:truthy\n  workflow_call:\n    inputs:\n      fern-version:\n        description: >\n          Fern CLI version to install. Pin this to avoid breaking changes when\n          Fern updates their config schema.\n        type: string\n        required: false\n        default: \"5.35.4\"\n      preview:\n        description: >\n          When true, publishes a preview instead of production.\n          Requires preview-id to be set.\n        type: boolean\n        required: false\n        default: false\n      preview-id:\n        description: >\n          Stable ID for the preview URL. The preview is accessible at\n          {fern-org}-preview-{id}.docs.buildwithfern.com. Use the PR number\n          (e.g. \"pr-123\") so the same URL is reused on every push to\n          the branch.\n        type: string\n        required: false\n        default: \"\"\n      fern-org:\n        description: >\n          Fern workspace org slug (e.g. \"holocron\"). When set, a GitHub\n          deployment is created after a successful preview so the URL appears\n          in the PR sidebar widget — the same pattern as Cloudflare Pages previews.\n        type: string\n        required: false\n        default: \"\"\n      base-path:\n        description: >\n          Basepath appended to the preview URL (e.g. \"holocron\" when using\n          multi-source routing with wiki.theholocron.dev/holocron).\n          Omit for single-instance Fern sites.\n        type: string\n        required: false\n        default: \"\"\n    secrets:\n      HOLOCRON_FERN_TOKEN:\n        required: false\n      FERN_TOKEN:\n        required: false\n\njobs:\n  publish:\n    name: ${{ inputs.preview && 'Preview' || 'Publish' }} to Fern\n    runs-on: ubuntu-latest\n    timeout-minutes: 10\n    permissions:\n      contents: read\n      deployments: write\n    steps:\n      - uses: actions/checkout@9c091bb21b7c1c1d1991bb908d89e4e9dddfe3e0 # v7.0.0\n        name: Checkout repository\n\n      - name: Install Fern CLI\n        run: npm install -g \"fern-api@$FERN_VERSION\"\n        env:\n          FERN_VERSION: ${{ inputs.fern-version }}\n\n      - name: Publish docs\n        if: ${{ !inputs.preview }}\n        run: fern generate --docs\n        env:\n          FERN_TOKEN: ${{ secrets.HOLOCRON_FERN_TOKEN || secrets.FERN_TOKEN }}\n\n      - name: Preview docs\n        if: ${{ inputs.preview && inputs.preview-id != '' }}\n        run: fern generate --docs --preview --id \"$PREVIEW_ID\"\n        env:\n          FERN_TOKEN: ${{ secrets.HOLOCRON_FERN_TOKEN || secrets.FERN_TOKEN }}\n          PREVIEW_ID: ${{ inputs.preview-id }}\n\n      - name: Report preview URL\n        if: ${{ inputs.preview && inputs.preview-id != '' && inputs.fern-org != '' }}\n        env:\n          GH_TOKEN: ${{ secrets.GITHUB_TOKEN }}\n          FERN_ORG: ${{ inputs.fern-org }}\n          PREVIEW_ID: ${{ inputs.preview-id }}\n          BASE_PATH: ${{ inputs.base-path }}\n        run: |\n          PREVIEW_URL=\"https://${FERN_ORG}-preview-${PREVIEW_ID}.docs.buildwithfern.com${BASE_PATH:+/${BASE_PATH}}\"\n          PAYLOAD=$(printf '{\"ref\":\"%s\",\"environment\":\"fern (Preview)\",\"description\":\"Fern Docs\",\"production_environment\":false,\"auto_merge\":false,\"required_contexts\":[]}' \\\n            \"$GITHUB_HEAD_REF\")\n          DEPLOY_ID=$(echo \"$PAYLOAD\" | gh api \"repos/${GITHUB_REPOSITORY}/deployments\" \\\n            --method POST --input - | jq -r '.id')\n          gh api \"repos/${GITHUB_REPOSITORY}/deployments/${DEPLOY_ID}/statuses\" \\\n            --method POST --field state=success --field environment_url=\"$PREVIEW_URL\"\n";
 //#endregion
 //#region src/templates/index.ts
 /**