alchemy 2.0.0-beta.76 → 2.0.0-beta.78

package/lib/GitHub/Milestone.js

@@ -0,0 +1,261 @@
+import * as Effect from "effect/Effect";
+import { isResolved } from "../Diff.js";
+import * as Provider from "../Provider.js";
+import { Resource } from "../Resource.js";
+import { gitHubBaseUrlChanged, Octokit, octokitFor } from "./Octokit.js";
+/**
+ * A GitHub milestone.
+ *
+ * `Milestone` manages repository milestones for tracking issues and pull
+ * requests. Milestones are created on first deploy and updated in place on
+ * subsequent deploys when properties change.
+ *
+ * Authentication is resolved via the `GitHubCredentials` service supplied by
+ * `GitHub.providers()` (env, stored PAT, `gh` CLI, or OAuth). The token needs
+ * `repo` scope for private repositories or `public_repo` for public ones.
+ * ### Creating Milestones
+ * **Example:** Basic Milestone
+ * ```typescript
+ * const v1 = yield* GitHub.Milestone("v1", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "v1.0.0",
+ *   description: "First stable release",
+ * });
+ * ```
+ *
+ * **Example:** Milestone with Due Date
+ * ```typescript
+ * yield* GitHub.Milestone("sprint-1", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Sprint 1",
+ *   description: "Complete user authentication",
+ *   dueOn: "2026-12-31",
+ * });
+ * ```
+ *
+ * ### Updating Milestones
+ * Deploy with the same logical ID and different properties to update the
+ * existing milestone in place.
+ *
+ * **Example:** Update Description and Due Date
+ * ```typescript
+ * yield* GitHub.Milestone("v2", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "v2.0.0",
+ *   description: "Updated: API redesign and performance improvements",
+ *   dueOn: "2027-06-30",
+ * });
+ * ```
+ *
+ * ### Closing and Reopening
+ * **Example:** Close a Milestone
+ * ```typescript
+ * yield* GitHub.Milestone("v1", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "v1.0.0",
+ *   state: "closed",
+ * });
+ * ```
+ *
+ * **Example:** Reopen a Milestone
+ * ```typescript
+ * yield* GitHub.Milestone("v1", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "v1.0.0",
+ *   state: "open",
+ * });
+ * ```
+ *
+ * ### Replacing on Title Change
+ * Changing the title creates a new milestone and deletes the old one.
+ *
+ * **Example:** Replace by Changing Title
+ * ```typescript
+ * // First deploy creates "Q1 2026"
+ * const milestone = yield* GitHub.Milestone("q1", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Q1 2026",
+ * });
+ *
+ * // Later deploy with same logical ID but different title replaces it
+ * const milestone = yield* GitHub.Milestone("q1", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Q1 2027",
+ * });
+ * ```
+ *
+ * ### Wiring with Other Resources
+ * **Example:** Create Repository with Milestone
+ * ```typescript
+ * import * as Output from "alchemy/Output";
+ *
+ * const repo = yield* GitHub.Repository("api", {
+ *   owner: "my-org",
+ *   name: "api",
+ *   autoInit: true,
+ * });
+ *
+ * yield* GitHub.Milestone("launch", {
+ *   owner: repo.owner!,
+ *   repository: Output.map(repo.fullName, (fullName) => fullName.split("/")[1]!),
+ *   title: "Initial Launch",
+ *   dueOn: "2026-12-31",
+ * });
+ * ```
+ *
+ * @resource
+ */
+export const Milestone = Resource("GitHub.Milestone");
+export const MilestoneProvider = () => Provider.succeed(Milestone, {
+    stables: ["milestoneNumber", "nodeId"],
+    // A milestone belongs to (host, owner, repository, title) — changing any
+    // of these replaces the resource.
+    diff: Effect.fn(function* ({ news, olds }) {
+        if (!isResolved(news))
+            return;
+        if (olds === undefined)
+            return;
+        if (news.owner !== olds.owner ||
+            news.repository !== olds.repository ||
+            news.title !== olds.title ||
+            (yield* gitHubBaseUrlChanged(olds, news))) {
+            return { action: "replace" };
+        }
+    }),
+    reconcile: Effect.fn(function* ({ news }) {
+        const octokit = yield* octokitFor(news.baseUrl);
+        const state = news.state ?? "open";
+        const description = news.description ?? "";
+        const requestedDueOn = news.dueOn;
+        const dueOn = requestedDueOn === undefined
+            ? null
+            : yield* Effect.try(() => new Date(requestedDueOn).toISOString().replace(".000Z", "Z"));
+        // Observe — probe for an existing milestone by title. GitHub's list
+        // endpoint supports filtering by state, but we need to check both open
+        // and closed to find any existing milestone with this title.
+        const existingMilestones = yield* Effect.tryPromise({
+            try: () => octokit.paginate(octokit.rest.issues.listMilestones, {
+                owner: news.owner,
+                repo: news.repository,
+                state: "all",
+                per_page: 100,
+            }),
+            catch: (e) => e,
+        });
+        let observed = existingMilestones.find((m) => m.title === news.title);
+        // Ensure — when no milestone exists, create one
+        if (observed === undefined) {
+            const { data } = yield* Effect.tryPromise({
+                try: () => octokit.rest.issues.createMilestone({
+                    owner: news.owner,
+                    repo: news.repository,
+                    title: news.title,
+                    state,
+                    description,
+                    due_on: dueOn ?? undefined,
+                }),
+                catch: (e) => e,
+            });
+            observed = data;
+        }
+        // Creation can shift the due date; converge the returned state too.
+        if (observed.state === state &&
+            (observed.description ?? "") === description &&
+            observed.due_on === dueOn) {
+            return attrsOf(observed);
+        }
+        // Octokit's endpoint type omits the API's nullable due_on field.
+        const { data } = yield* Effect.tryPromise({
+            try: () => octokit.request({
+                method: "PATCH",
+                url: "/repos/{owner}/{repo}/milestones/{milestone_number}",
+                owner: news.owner,
+                repo: news.repository,
+                milestone_number: observed.number,
+                title: news.title,
+                state,
+                description,
+                due_on: dueOn,
+            }),
+            catch: (e) => e,
+        });
+        return attrsOf(data);
+    }),
+    // Enumerate every milestone across the repositories the token can see —
+    // milestones are keyed by {owner, repository, title} with no account-wide
+    // list endpoint, so walk the repos like the Variable provider does.
+    list: Effect.fn(function* () {
+        const octokit = yield* Octokit;
+        const repos = yield* Effect.tryPromise({
+            try: () => octokit.paginate(octokit.rest.repos.listForAuthenticatedUser, {
+                per_page: 100,
+            }),
+            catch: (e) => e,
+        });
+        const perRepo = yield* Effect.forEach(repos, (repo) => Effect.tryPromise({
+            try: async () => {
+                try {
+                    const milestones = await octokit.paginate(octokit.rest.issues.listMilestones, {
+                        owner: repo.owner.login,
+                        repo: repo.name,
+                        state: "all",
+                        per_page: 100,
+                    });
+                    return milestones.map(attrsOf);
+                }
+                catch (error) {
+                    // Repos where the token lacks milestone access reject with
+                    // 403/404 — skip them rather than failing the whole enumeration.
+                    if (error.status === 403 || error.status === 404) {
+                        return [];
+                    }
+                    throw error;
+                }
+            },
+            catch: (e) => e,
+        }), { concurrency: 10 });
+        return perRepo.flat();
+    }),
+    delete: Effect.fn(function* ({ olds, output }) {
+        const octokit = yield* octokitFor(olds.baseUrl);
+        yield* Effect.tryPromise({
+            try: async () => {
+                try {
+                    await octokit.rest.issues.deleteMilestone({
+                        owner: olds.owner,
+                        repo: olds.repository,
+                        milestone_number: output.milestoneNumber,
+                    });
+                }
+                catch (error) {
+                    if (error.status !== 404) {
+                        throw error;
+                    }
+                }
+            },
+            catch: (e) => e,
+        });
+    }),
+});
+const attrsOf = (data) => ({
+    milestoneNumber: data.number,
+    nodeId: data.node_id,
+    title: data.title,
+    state: data.state,
+    description: data.description,
+    dueOn: data.due_on,
+    htmlUrl: data.html_url,
+    createdAt: data.created_at,
+    updatedAt: data.updated_at,
+    closedAt: data.closed_at,
+    openIssues: data.open_issues,
+    closedIssues: data.closed_issues,
+});
+//# sourceMappingURL=Milestone.js.map

package/lib/GitHub/Milestone.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Milestone.js","sourceRoot":"","sources":["../../src/GitHub/Milestone.ts"],"names":[],"mappings":"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"}

package/lib/GitHub/Providers.d.ts

@@ -10,8 +10,7 @@ export type ProviderRequirements = Layer.Services<ReturnType<typeof providers>>;
 export interface ProvidersOptions extends GitHubAuthOptions {
 }
 /**
- * GitHub providers (Comment, Environment, Repository, Secret, Variable,
- * Webhook) plus the GitHub AuthProvider that `alchemy login` discovers.
+ * GitHub resource providers and the GitHub AuthProvider discovered by the CLI.
  *
  * Pass `baseUrl` to pin every GitHub resource to a GitHub Enterprise host
  * without relying on the auth provider's configuration:
@@ -20,10 +19,10 @@ export interface ProvidersOptions extends GitHubAuthOptions {
  * providers: GitHub.providers({ baseUrl: "github.example.com" })
  * ```
  *
- * The auth provider receives the same value, so `alchemy login` skips the
+ * The auth provider receives the same value, so the configure flow skips the
  * host prompt and authenticates against the pinned host (`gh auth token
  * --hostname`, enterprise token env vars). Individual resources can still
  * override the host per-resource via their own `baseUrl` prop.
  */
-export declare const providers: (options?: ProvidersOptions) => Layer.Layer<import("../Auth/Profile.ts").AlchemyProfile | import("../Auth/Credentials.ts").CredentialsStore | Credentials.GitHubCredentials | Providers, never, import("../index.ts").AuthProviders | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem>;
+export declare const providers: (options?: ProvidersOptions) => Layer.Layer<import("../Auth/Credentials.ts").CredentialsStore | Credentials.GitHubCredentials | import("../Auth/Profile.ts").ProfileStore | Providers, never, import("../index.ts").AuthProviders | import("effect/unstable/process/ChildProcessSpawner").ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
 //# sourceMappingURL=Providers.d.ts.map

package/lib/GitHub/Providers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../../src/GitHub/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,mBAAmB,CAAC;AAE3E,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAOhD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;;AAErD,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEhF,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;CAAG;AAE9D;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,SAAS,aAAc,gBAAgB,8TA2BjD,CAAC"}
+{"version":3,"file":"Providers.d.ts","sourceRoot":"","sources":["../../src/GitHub/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AAGtC,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,KAAK,iBAAiB,EAAkB,MAAM,mBAAmB,CAAC;AAO3E,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAehD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;;AAErD,qBAAa,SAAU,SAAQ,cAE9B;CAAG;AAEJ,MAAM,MAAM,oBAAoB,GAAG,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,OAAO,SAAS,CAAC,CAAC,CAAC;AAEhF,MAAM,WAAW,gBAAiB,SAAQ,iBAAiB;CAAG;AAE9D;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,aAAc,gBAAgB,yVA+CjD,CAAC"}

package/lib/GitHub/Providers.js

@@ -1,21 +1,30 @@
 import * as Layer from "effect/Layer";
 import { CredentialsStoreLive } from "../Auth/Credentials.js";
-import { ProfileLive } from "../Auth/Profile.js";
+import { ProfileStoreLive } from "../Auth/Profile.js";
 import * as Provider from "../Provider.js";
 import { makeGitHubAuth } from "./AuthProvider.js";
+import { BranchProtection, BranchProtectionProvider, } from "./BranchProtection.js";
+import { Collaborator, CollaboratorProvider } from "./Collaborator.js";
 import { Comment, CommentProvider } from "./Comment.js";
 import * as Credentials from "./Credentials.js";
 import { Environment, EnvironmentProvider } from "./Environment.js";
+import { Label, LabelProvider } from "./Label.js";
+import { Milestone, MilestoneProvider } from "./Milestone.js";
+import { Issue, IssueProvider } from "./Issue.js";
+import { PullRequest, PullRequestProvider } from "./PullRequest.js";
+import { Release, ReleaseProvider } from "./Release.js";
 import { Repository, RepositoryProvider } from "./Repository.js";
+import { Ruleset, RulesetProvider } from "./Ruleset.js";
 import { Secret, SecretProvider } from "./Secret.js";
+import { TeamAccess, TeamAccessProvider } from "./TeamAccess.js";
 import { Variable, VariableProvider } from "./Variable.js";
 import { Webhook, WebhookProvider } from "./Webhook.js";
+import { WikiPage, WikiPageProvider } from "./WikiPage.js";
 export { GitHubCredentials } from "./Credentials.js";
 export class Providers extends Provider.ProviderCollection()("GitHub") {
 }
 /**
- * GitHub providers (Comment, Environment, Repository, Secret, Variable,
- * Webhook) plus the GitHub AuthProvider that `alchemy login` discovers.
+ * GitHub resource providers and the GitHub AuthProvider discovered by the CLI.
  *
  * Pass `baseUrl` to pin every GitHub resource to a GitHub Enterprise host
  * without relying on the auth provider's configuration:
@@ -24,17 +33,27 @@ export class Providers extends Provider.ProviderCollection()("GitHub") {
  * providers: GitHub.providers({ baseUrl: "github.example.com" })
  * ```
  *
- * The auth provider receives the same value, so `alchemy login` skips the
+ * The auth provider receives the same value, so the configure flow skips the
  * host prompt and authenticates against the pinned host (`gh auth token
  * --hostname`, enterprise token env vars). Individual resources can still
  * override the host per-resource via their own `baseUrl` prop.
  */
 export const providers = (options) => Layer.effect(Providers, Provider.collection([
+    BranchProtection,
+    Collaborator,
     Comment,
     Environment,
+    Label,
+    Milestone,
+    Issue,
+    PullRequest,
+    Release,
     Repository,
+    Ruleset,
     Secret,
+    TeamAccess,
     Variable,
     Webhook,
-])).pipe(Layer.provide(Layer.mergeAll(CommentProvider(), EnvironmentProvider(), RepositoryProvider(), SecretProvider(), VariableProvider(), WebhookProvider())), Layer.provideMerge(Credentials.fromAuthProvider(options)), Layer.provideMerge(makeGitHubAuth(options)), Layer.provideMerge(ProfileLive), Layer.provideMerge(CredentialsStoreLive), Layer.orDie);
+    WikiPage,
+])).pipe(Layer.provide(Layer.mergeAll(BranchProtectionProvider(), CollaboratorProvider(), CommentProvider(), EnvironmentProvider(), LabelProvider(), MilestoneProvider(), IssueProvider(), PullRequestProvider(), ReleaseProvider(), RepositoryProvider(), RulesetProvider(), SecretProvider(), TeamAccessProvider(), VariableProvider(), WebhookProvider(), WikiPageProvider())), Layer.provideMerge(Credentials.fromAuthProvider(options)), Layer.provideMerge(makeGitHubAuth(options)), Layer.provideMerge(ProfileStoreLive), Layer.provideMerge(CredentialsStoreLive), Layer.orDie);
 //# sourceMappingURL=Providers.js.map

package/lib/GitHub/Providers.js.map

@@ -1 +1 @@
-{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../../src/GitHub/Providers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAA0B,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACxD,OAAO,KAAK,WAAW,MAAM,kBAAkB,CAAC;AAChD,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACpE,OAAO,EAAE,UAAU,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AACrD,OAAO,EAAE,QAAQ,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAExD,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAO,SAAU,SAAQ,QAAQ,CAAC,kBAAkB,EAAa,CACrE,QAAQ,CACT;CAAG;AAMJ;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,OAA0B,EAAE,EAAE,CACtD,KAAK,CAAC,MAAM,CACV,SAAS,EACT,QAAQ,CAAC,UAAU,CAAC;IAClB,OAAO;IACP,WAAW;IACX,UAAU;IACV,MAAM;IACN,QAAQ;IACR,OAAO;CACR,CAAC,CACH,CAAC,IAAI,CACJ,KAAK,CAAC,OAAO,CACX,KAAK,CAAC,QAAQ,CACZ,eAAe,EAAE,EACjB,mBAAmB,EAAE,EACrB,kBAAkB,EAAE,EACpB,cAAc,EAAE,EAChB,gBAAgB,EAAE,EAClB,eAAe,EAAE,CAClB,CACF,EACD,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,EACzD,KAAK,CAAC,YAAY,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAC3C,KAAK,CAAC,YAAY,CAAC,WAAW,CAAC,EAC/B,KAAK,CAAC,YAAY,CAAC,oBAAoB,CAAC,EACxC,KAAK,CAAC,KAAK,CACZ,CAAC"}
+{"version":3,"file":"Providers.js","sourceRoot":"","sources":["../../src/GitHub/Providers.ts"],"names":[],"mappings":"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"}

package/lib/GitHub/PullRequest.d.ts

@@ -0,0 +1,220 @@
+import * as Provider from "../Provider.ts";
+import { Resource } from "../Resource.ts";
+import type * as GitHub from "./Providers.ts";
+export interface PullRequestProps {
+    /**
+     * Repository owner (user or organization).
+     */
+    owner: string;
+    /**
+     * Repository name.
+     */
+    repository: string;
+    /**
+     * Pull request title.
+     */
+    title: string;
+    /**
+     * Pull request body (supports GitHub Markdown).
+     *
+     * The body is automatically dedented, so you can use indented template
+     * literals without worrying about leading whitespace. Accepts
+     * `Output<string>` at the call site via `Output.interpolate` to embed
+     * resource attributes that are not yet resolved.
+     */
+    body?: string;
+    /**
+     * The name of the branch where your changes are implemented (the source).
+     */
+    head: string;
+    /**
+     * The name of the branch you want the changes pulled into (the target).
+     */
+    base: string;
+    /**
+     * State of the pull request. Use "open" to reopen a closed PR or "closed"
+     * to close an open PR. Note: only the PR owner, repo owner, or user with
+     * push access can close PRs.
+     * @default "open"
+     */
+    state?: "open" | "closed";
+    /**
+     * Whether the pull request is a draft.
+     * @default false
+     */
+    draft?: boolean;
+    /**
+     * Labels to attach to the pull request. The provided list fully replaces
+     * any existing labels.
+     */
+    labels?: string[];
+    /**
+     * Assignees (user logins) to assign to the pull request. The provided list
+     * fully replaces existing assignees.
+     */
+    assignees?: string[];
+    /**
+     * Reviewers (user logins) to request reviews from. The provided list fully
+     * replaces existing review requests.
+     */
+    reviewers?: string[];
+    /**
+     * Team slugs (for organization repos) to request reviews from.
+     */
+    teamReviewers?: string[];
+    /**
+     * Milestone number to assign to the pull request. Use `null` to remove
+     * milestone.
+     */
+    milestone?: number | null;
+    /**
+     * Whether maintainers of the base repository can modify the pull
+     * request's head branch. This does not change the pull request author.
+     */
+    maintainerCanModify?: boolean;
+    /**
+     * Override the GitHub host or API base URL for this resource only (e.g.
+     * `github.example.com` for GitHub Enterprise). Falls back to
+     * `GitHub.providers({ baseUrl })`, then to the host resolved by the auth
+     * provider. Changing it replaces the resource — the same name on a
+     * different GitHub instance is a different physical resource.
+     */
+    baseUrl?: string;
+}
+export interface PullRequest extends Resource<"GitHub.PullRequest", PullRequestProps, {
+    /**
+     * The numeric ID of the pull request in GitHub.
+     */
+    prNumber: number;
+    /**
+     * GraphQL node ID of the pull request.
+     */
+    nodeId: string;
+    /**
+     * URL to view the pull request in a browser.
+     */
+    htmlUrl: string;
+    /**
+     * State of the pull request (open or closed).
+     */
+    state: "open" | "closed";
+    /**
+     * Whether the pull request is merged.
+     */
+    merged: boolean;
+    /**
+     * Whether the pull request is a draft.
+     */
+    draft: boolean;
+    /**
+     * ISO-8601 timestamp of when the pull request was created.
+     */
+    createdAt: string;
+    /**
+     * ISO-8601 timestamp of the last update.
+     */
+    updatedAt: string;
+}, never, GitHub.Providers> {
+}
+/**
+ * A GitHub pull request.
+ *
+ * `PullRequest` manages the lifecycle of a pull request in a repository. PRs
+ * are created on the first deploy and updated in place on subsequent deploys
+ * when properties change. By default, pull requests are retained on
+ * destruction to preserve history — set `destroy()` to opt in to closure.
+ *
+ * Authentication is resolved via the `GitHubCredentials` service supplied by
+ * `GitHub.providers()` (env, stored PAT, `gh` CLI, or OAuth). The token needs
+ * `repo` scope for private repositories or `public_repo` for public ones.
+ *
+ * ### Creating Pull Requests
+ * **Example:** Create a Basic Pull Request
+ * ```typescript
+ * const pr = yield* GitHub.PullRequest("feature-pr", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Add new feature",
+ *   body: "## Changes\n\nThis PR adds...",
+ *   head: "feature-branch",
+ *   base: "main",
+ * })
+ * ```
+ *
+ * **Example:** Draft Pull Request with Reviewers
+ * ```typescript
+ * const pr = yield* GitHub.PullRequest("draft-pr", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "WIP: New feature",
+ *   body: "Work in progress...",
+ *   head: "feature-branch",
+ *   base: "main",
+ *   draft: true,
+ *   reviewers: ["reviewer1", "reviewer2"],
+ *   teamReviewers: ["platform-team"],
+ * })
+ * ```
+ *
+ * ### Updating Pull Requests
+ * Deploy with the same logical ID and different properties to update the
+ * existing PR in place rather than creating a new one.
+ *
+ * **Example:** Update PR State
+ * ```typescript
+ * const pr = yield* GitHub.PullRequest("completed-pr", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Add new feature",
+ *   body: "Completed and ready to merge.",
+ *   head: "feature-branch",
+ *   base: "main",
+ *   state: "closed",
+ * })
+ * ```
+ *
+ * ### Pull Request with Labels and Milestone
+ * **Example:** Organized Pull Request
+ * ```typescript
+ * const pr = yield* GitHub.PullRequest("release-pr", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Release v1.0",
+ *   body: "Release notes...",
+ *   head: "release-1.0",
+ *   base: "main",
+ *   labels: ["release", "v1.0"],
+ *   milestone: 1,
+ * })
+ * ```
+ *
+ * ### Infrastructure Deployment PRs
+ * A common pattern is creating PRs for infrastructure changes that require
+ * review before merging.
+ *
+ * **Example:** Infrastructure Change PR
+ * ```typescript
+ * yield* GitHub.PullRequest("infra-update", {
+ *   owner: "my-org",
+ *   repository: "my-repo",
+ *   title: "Update infrastructure configuration",
+ *   body: Output.interpolate`
+ *     ## Infrastructure Changes
+ *
+ *     **Database:** ${database.endpoint}
+ *     **Cache:** ${cache.endpoint}
+ *
+ *     Requires approval before deployment.
+ *   `,
+ *   head: "infra-updates",
+ *   base: "main",
+ *   labels: ["infrastructure"],
+ *   reviewers: ["infrastructure-lead"],
+ * })
+ * ```
+ *
+ * @resource
+ */
+export declare const PullRequest: import("../Resource.ts").ResourceClass<PullRequest>;
+export declare const PullRequestProvider: () => import("effect/Layer").Layer<Provider.Provider<PullRequest>, never, GitHub.GitHubCredentials>;
+//# sourceMappingURL=PullRequest.d.ts.map

package/lib/GitHub/PullRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PullRequest.d.ts","sourceRoot":"","sources":["../../src/GitHub/PullRequest.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,QAAQ,MAAM,gBAAgB,CAAC;AAC3C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAG1C,OAAO,KAAK,KAAK,MAAM,MAAM,gBAAgB,CAAC;AAE9C,MAAM,WAAW,gBAAgB;IAC/B;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IAEnB;;OAEG;IACH,KAAK,EAAE,MAAM,CAAC;IAEd;;;;;;;OAOG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;;;;OAKG;IACH,KAAK,CAAC,EAAE,MAAM,GAAG,QAAQ,CAAC;IAE1B;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAElB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAErB;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IAEzB;;;OAGG;IACH,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE1B;;;OAGG;IACH,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAE9B;;;;;;OAMG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,WAAY,SAAQ,QAAQ,CAC3C,oBAAoB,EACpB,gBAAgB,EAChB;IACE;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IAEjB;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,MAAM,GAAG,QAAQ,CAAC;IAEzB;;OAEG;IACH,MAAM,EAAE,OAAO,CAAC;IAEhB;;OAEG;IACH,KAAK,EAAE,OAAO,CAAC;IAEf;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;CACnB,EACD,KAAK,EACL,MAAM,CAAC,SAAS,CACjB;CAAG;AAEJ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkGG;AACH,eAAO,MAAM,WAAW,qDAEtB,CAAC;AAEH,eAAO,MAAM,mBAAmB,qGAwM5B,CAAC"}