@theholocron/holocron-plugin-github 3.5.3 → 3.6.0

package/dist/index.d.mts

@@ -1,11 +1,12 @@
 import { GitHubClient, GitHubClientOptions, createGitHubClient } from "@theholocron/github-client";
-import { Auth, AuthError, Ci, CiRun, CiRunFilter, Environment, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, RepoRef, RepoSettings, ResolveTokenInput, Ruleset, SecretScope, Secrets, Source, TeamEntry, TeamEntry as TeamEntry$1, TeamPermission, TrackerDoctorReport, TrackerUser, createFeatureResolver } from "@theholocron/cli";
+import { Auth, AuthError, Ci, CiRun, CiRunFilter, Environment, Environments, Issue, IssueSearchFilter, Issues, LabelDef, LifecycleResult, LifecycleSlot, PagesConfig, RepoRef, RepoSettings, ResolveTokenInput, Ruleset, SecretScope, Secrets, Source, TeamEntry, TeamEntry as TeamEntry$1, TeamPermission, TrackerDoctorReport, TrackerUser, createFeatureResolver } from "@theholocron/cli";
 //#region src/auth.d.ts
 declare const resolveReadToken: (input?: ResolveTokenInput) => string;
 declare const resolveIssuesToken: (input?: ResolveTokenInput) => string;
 declare const resolveSyncToken: (input?: ResolveTokenInput) => string;
 declare const resolveReleaseToken: (input?: ResolveTokenInput) => string;
 declare const resolveAdminToken: (input?: ResolveTokenInput) => string;
+declare const resolveDeployToken: (input?: ResolveTokenInput) => string;
 //#endregion
 //#region src/capabilities/ci.d.ts
 interface CiOptions {
@@ -116,6 +117,9 @@ declare class GitHubSecrets implements Secrets {
 interface SourceOptions {
   repo: string;
   repoRoot: string;
+  /** Forwarded to a secondary client created for Pages calls (HOLOCRON_DEPLOY_TOKEN). */
+  baseUrl?: string;
+  fetch?: typeof fetch;
 }
 declare class GitHubSource implements Source {
   private readonly client;
@@ -126,6 +130,8 @@ declare class GitHubSource implements Source {
   private readonly repo;
   private readonly repoRoot;
   private readonly workflowDir;
+  private readonly baseUrl?;
+  private readonly fetchImpl?;
   constructor(client: GitHubClient, opts: SourceOptions);
   whoami(): Promise<{
     login: string;
@@ -154,6 +160,7 @@ declare class GitHubSource implements Source {
   syncTopics(topics: string[]): Promise<string>;
   syncDescription(description: string): Promise<string>;
   syncHomepage(homepage: string): Promise<string>;
+  configurePages(config: PagesConfig, token: string): Promise<void>;
 }
 //#endregion
 //#region src/capabilities/teams.d.ts
@@ -241,4 +248,4 @@ declare function createPlugin(options: GitHubPluginOptions): {
  */
 declare const AUTH_HINT: string;
 //#endregion
-export { AUTH_HINT, type Auth, AuthError, type CanonicalLabel, GitHubCi, type GitHubClientOptions, GitHubEnvironments, GitHubIssues, GitHubPluginOptions, GitHubSecrets, GitHubSource, type NormalizedTeamEntry, PluginContext, type ResolveTokenInput, type TeamEntry, type TeamPermission, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, ci, createFeatureResolver, createGitHubClient, createPlugin, encryptSecret, environments, issues, normalizeTeamEntry, resolveAdminToken, resolveIssuesToken, resolveReadToken, resolveReleaseToken, resolveSyncToken, secrets, source, syncLabels, syncTeams, verifyToken };
+export { AUTH_HINT, type Auth, AuthError, type CanonicalLabel, GitHubCi, type GitHubClientOptions, GitHubEnvironments, GitHubIssues, GitHubPluginOptions, GitHubSecrets, GitHubSource, type NormalizedTeamEntry, PluginContext, type ResolveTokenInput, type TeamEntry, type TeamPermission, type VerifyTokenFailure, type VerifyTokenResult, type VerifyTokenSuccess, ci, createFeatureResolver, createGitHubClient, createPlugin, encryptSecret, environments, issues, normalizeTeamEntry, resolveAdminToken, resolveDeployToken, resolveIssuesToken, resolveReadToken, resolveReleaseToken, resolveSyncToken, secrets, source, syncLabels, syncTeams, verifyToken };

package/dist/index.mjs

@@ -24,6 +24,10 @@ const resolveAdminToken = createFeatureResolver({
 	envName: "HOLOCRON_ADMIN_TOKEN",
 	keyringKey: "github.admin"
 });
+const resolveDeployToken = createFeatureResolver({
+	envName: "HOLOCRON_DEPLOY_TOKEN",
+	keyringKey: "github.deploy"
+});
 //#endregion
 //#region src/capabilities/ci.ts
 var GitHubCi = class {
@@ -479,6 +483,8 @@ var GitHubSource = class {
 	repo;
 	repoRoot;
 	workflowDir;
+	baseUrl;
+	fetchImpl;
 	constructor(client, opts) {
 		this.client = client;
 		const [owner = "", name = ""] = opts.repo.split("/", 2);
@@ -487,6 +493,8 @@ var GitHubSource = class {
 		this.repo = opts.repo;
 		this.repoRoot = opts.repoRoot;
 		this.workflowDir = join(opts.repoRoot, ".github", "workflows");
+		this.baseUrl = opts.baseUrl;
+		this.fetchImpl = opts.fetch;
 	}
 	async whoami() {
 		return { login: (await this.client.user.getCurrentUser()).login };
@@ -588,6 +596,28 @@ var GitHubSource = class {
 		await this.client.repos.updateRepo(this.repo, { homepage });
 		return "homepage updated";
 	}
+	async configurePages(config, token) {
+		const pagesClient = createGitHubClient$1({
+			token,
+			baseUrl: this.baseUrl,
+			fetch: this.fetchImpl
+		});
+		const buildType = config.build === "workflow" ? "workflow" : "legacy";
+		const branchSource = config.build === "branch" ? {
+			branch: "gh-pages",
+			path: "/"
+		} : void 0;
+		if (!await pagesClient.pages.getPages(this.repo)) {
+			const createPayload = { build_type: buildType };
+			if (branchSource) createPayload.source = branchSource;
+			await pagesClient.pages.createPages(this.repo, createPayload);
+		}
+		const updatePayload = { build_type: buildType };
+		if (branchSource) updatePayload.source = branchSource;
+		if (config.domain !== void 0) updatePayload.cname = config.domain;
+		if (config.https !== void 0) updatePayload.https_enforced = config.https;
+		await pagesClient.pages.updatePages(this.repo, updatePayload);
+	}
 };
 function isENOENT(err) {
 	return typeof err === "object" && err !== null && "code" in err && err.code === "ENOENT";
@@ -639,7 +669,9 @@ async function verifyToken(token, opts = {}) {
 function source(ctx) {
 	return new GitHubSource(ctx.client, {
 		repo: ctx.repo,
-		repoRoot: ctx.repoRoot
+		repoRoot: ctx.repoRoot,
+		baseUrl: ctx.options.baseUrl,
+		fetch: ctx.options.fetch
 	});
 }
 function secrets(ctx) {
@@ -686,4 +718,4 @@ function createPlugin(options) {
 */
 const AUTH_HINT = "generate fine-grained Personal Access Tokens at https://github.com/settings/tokens (one per feature — see docs/tokens.md for required scopes per operation), then run: holocron auth set github.<feature> <PAT>";
 //#endregion
-export { AUTH_HINT, AuthError, GitHubCi, GitHubEnvironments, GitHubIssues, GitHubSecrets, GitHubSource, ci, createFeatureResolver, createGitHubClient, createPlugin, encryptSecret, environments, issues, normalizeTeamEntry, resolveAdminToken, resolveIssuesToken, resolveReadToken, resolveReleaseToken, resolveSyncToken, secrets, source, syncLabels, syncTeams, verifyToken };
+export { AUTH_HINT, AuthError, GitHubCi, GitHubEnvironments, GitHubIssues, GitHubSecrets, GitHubSource, ci, createFeatureResolver, createGitHubClient, createPlugin, encryptSecret, environments, issues, normalizeTeamEntry, resolveAdminToken, resolveDeployToken, resolveIssuesToken, resolveReadToken, resolveReleaseToken, resolveSyncToken, secrets, source, syncLabels, syncTeams, verifyToken };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@theholocron/holocron-plugin-github",
-  "version": "3.5.3",
+  "version": "3.6.0",
   "description": "Holocron plugin for GitHub. Implements source, ci, secrets, environments, and issues capabilities against the GitHub REST API.",
   "homepage": "https://github.com/theholocron/holocron/tree/main/packages/holocron-plugin-github#readme",
   "bugs": "https://github.com/theholocron/holocron/issues",
@@ -22,15 +22,15 @@
     }
   },
   "peerDependencies": {
-    "@theholocron/github-client": "^1.3.5",
-    "@theholocron/cli": "3.5.3"
+    "@theholocron/github-client": "^1.6.0",
+    "@theholocron/cli": "3.6.0"
   },
   "dependencies": {
     "libsodium-wrappers": "^0.8.4"
   },
   "devDependencies": {
     "@theholocron/eslint-config": "^7.6.1",
-    "@theholocron/github-client": "^1.3.5",
+    "@theholocron/github-client": "^1.6.0",
     "@theholocron/tsconfig": "^7.6.1",
     "@theholocron/tsdown-config": "^7.6.1",
     "@theholocron/vitest-config": "^7.6.1",
@@ -44,7 +44,7 @@
     "tsx": "4.23.1",
     "typescript": "^5.9.3",
     "vitest": "^4.1.10",
-    "@theholocron/cli": "3.5.3"
+    "@theholocron/cli": "3.6.0"
   },
   "publishConfig": {
     "access": "public"