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

package/lib/Git/Api/Objects.js.map

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

package/lib/Git/Api/Protocol.d.ts

@@ -0,0 +1,41 @@
+/**
+ * The `protocol` group: git smart HTTP v0 at the repository's root path.
+ * The routes are streaming binary (pkt-lines in, sideband packs out),
+ * decode repository path parameters and return the binary response they build.
+ * Use handleRaw to keep request bodies streaming through API middleware.
+ *
+ * `:repo` may carry a `.git` suffix; the handlers strip it.
+ */
+import { RepoNotFound, PushDenied } from "./Schema.ts";
+import * as HttpApiEndpoint from "effect/unstable/httpapi/HttpApiEndpoint";
+import * as HttpApiGroup from "effect/unstable/httpapi/HttpApiGroup";
+/** `GET /:owner/:repo/info/refs?service=…`: the ref advertisement. */
+export declare const InfoRefs: HttpApiEndpoint.HttpApiEndpoint<"infoRefs", "GET", "/:owner/:repo/info/refs", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly owner: import("effect/Schema").String;
+    readonly repo: import("effect/Schema").String;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/unstable/httpapi/HttpApiSchema").NoContent>, import("effect/Schema").toCodecJson<typeof PushDenied | typeof RepoNotFound>, never, never>;
+/** `POST /:owner/:repo/git-upload-pack`: clone and fetch. */
+export declare const UploadPack: HttpApiEndpoint.HttpApiEndpoint<"uploadPack", "POST", "/:owner/:repo/git-upload-pack", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly owner: import("effect/Schema").String;
+    readonly repo: import("effect/Schema").String;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/unstable/httpapi/HttpApiSchema").NoContent>, import("effect/Schema").toCodecJson<typeof PushDenied | typeof RepoNotFound>, never, never>;
+/** `POST /:owner/:repo/git-receive-pack`: push. */
+export declare const ReceivePack: HttpApiEndpoint.HttpApiEndpoint<"receivePack", "POST", "/:owner/:repo/git-receive-pack", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly owner: import("effect/Schema").String;
+    readonly repo: import("effect/Schema").String;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/unstable/httpapi/HttpApiSchema").NoContent>, import("effect/Schema").toCodecJson<typeof PushDenied | typeof RepoNotFound>, never, never>;
+declare const Protocol_base: HttpApiGroup.HttpApiGroup<"protocol", HttpApiEndpoint.HttpApiEndpoint<"infoRefs", "GET", "/:owner/:repo/info/refs", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly owner: import("effect/Schema").String;
+    readonly repo: import("effect/Schema").String;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/unstable/httpapi/HttpApiSchema").NoContent>, import("effect/Schema").toCodecJson<typeof PushDenied | typeof RepoNotFound>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"receivePack", "POST", "/:owner/:repo/git-receive-pack", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly owner: import("effect/Schema").String;
+    readonly repo: import("effect/Schema").String;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/unstable/httpapi/HttpApiSchema").NoContent>, import("effect/Schema").toCodecJson<typeof PushDenied | typeof RepoNotFound>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"uploadPack", "POST", "/:owner/:repo/git-upload-pack", import("effect/Schema").toCodecStringTree<import("effect/Schema").Struct<{
+    readonly owner: import("effect/Schema").String;
+    readonly repo: import("effect/Schema").String;
+}>>, never, never, never, import("effect/Schema").toCodecJson<import("effect/unstable/httpapi/HttpApiSchema").NoContent>, import("effect/Schema").toCodecJson<typeof PushDenied | typeof RepoNotFound>, never, never>, true>;
+/** The git wire protocol, mounted at the root. */
+export declare class Protocol extends Protocol_base {
+}
+export {};
+//# sourceMappingURL=Protocol.d.ts.map

package/lib/Git/Api/Protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Protocol.d.ts","sourceRoot":"","sources":["../../../src/Git/Api/Protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAY,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,eAAe,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AAErE,sEAAsE;AACtE,eAAO,MAAM,QAAQ;;;qNAIpB,CAAC;AAEF,6DAA6D;AAC7D,eAAO,MAAM,UAAU;;;qNAItB,CAAC;AAEF,mDAAmD;AACnD,eAAO,MAAM,WAAW;;;qNAIvB,CAAC;;;;;;;;;;;AAEF,kDAAkD;AAClD,qBAAa,QAAS,SAAQ,aAEW;CAAG"}

package/lib/Git/Api/Protocol.js

@@ -0,0 +1,23 @@
+/**
+ * The `protocol` group: git smart HTTP v0 at the repository's root path.
+ * The routes are streaming binary (pkt-lines in, sideband packs out),
+ * decode repository path parameters and return the binary response they build.
+ * Use handleRaw to keep request bodies streaming through API middleware.
+ *
+ * `:repo` may carry a `.git` suffix; the handlers strip it.
+ */
+import { RepoPath, RepoNotFound, PushDenied } from "./Schema.js";
+import * as HttpApiEndpoint from "effect/unstable/httpapi/HttpApiEndpoint";
+import * as HttpApiGroup from "effect/unstable/httpapi/HttpApiGroup";
+/** `GET /:owner/:repo/info/refs?service=…`: the ref advertisement. */
+export const InfoRefs = HttpApiEndpoint.get("infoRefs", "/:owner/:repo/info/refs", { params: RepoPath, error: [RepoNotFound, PushDenied] });
+/** `POST /:owner/:repo/git-upload-pack`: clone and fetch. */
+export const UploadPack = HttpApiEndpoint.post("uploadPack", "/:owner/:repo/git-upload-pack", { params: RepoPath, error: [RepoNotFound, PushDenied] });
+/** `POST /:owner/:repo/git-receive-pack`: push. */
+export const ReceivePack = HttpApiEndpoint.post("receivePack", "/:owner/:repo/git-receive-pack", { params: RepoPath, error: [RepoNotFound, PushDenied] });
+/** The git wire protocol, mounted at the root. */
+export class Protocol extends HttpApiGroup.make("protocol", {
+    topLevel: true,
+}).add(InfoRefs, UploadPack, ReceivePack) {
+}
+//# sourceMappingURL=Protocol.js.map

package/lib/Git/Api/Protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Protocol.js","sourceRoot":"","sources":["../../../src/Git/Api/Protocol.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,KAAK,eAAe,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AAErE,sEAAsE;AACtE,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CACzC,UAAU,EACV,yBAAyB,EACzB,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CACxD,CAAC;AAEF,6DAA6D;AAC7D,MAAM,CAAC,MAAM,UAAU,GAAG,eAAe,CAAC,IAAI,CAC5C,YAAY,EACZ,+BAA+B,EAC/B,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CACxD,CAAC;AAEF,mDAAmD;AACnD,MAAM,CAAC,MAAM,WAAW,GAAG,eAAe,CAAC,IAAI,CAC7C,aAAa,EACb,gCAAgC,EAChC,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,YAAY,EAAE,UAAU,CAAC,EAAE,CACxD,CAAC;AAEF,kDAAkD;AAClD,MAAM,OAAO,QAAS,SAAQ,YAAY,CAAC,IAAI,CAAC,UAAU,EAAE;IAC1D,QAAQ,EAAE,IAAI;CACf,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,UAAU,EAAE,WAAW,CAAC;CAAG"}

package/lib/Git/Api/Pulls.d.ts

@@ -0,0 +1,157 @@
+/**
+ * The `pulls` group: pull-request lifecycle + merge (DESIGN.md §5).
+ *
+ * PRs are same-repo branch PRs (no cross-fork), tracking **live** branches
+ * by ref name: diff and mergeability are computed on read from current ref
+ * tips. Merging fast-forwards when possible; otherwise it creates a merge
+ * commit iff the three-way tree merge is trivial (no path touched on both
+ * sides relative to the merge base) — a conflicting PR is a typed 409, the
+ * server never writes conflict markers.
+ */
+import * as HttpApiEndpoint from "effect/unstable/httpapi/HttpApiEndpoint";
+import * as Schema from "effect/Schema";
+import * as HttpApiGroup from "effect/unstable/httpapi/HttpApiGroup";
+import { BranchMissing, MergeConflict, MergeResult, NothingToMerge, Pull, PullDetail, PullExists, PullNotFound, PullStateConflict, ReadOnlyRepo, RefConflict, RepoNotFound, ValidationError, PushDenied } from "./Schema.ts";
+/** `(owner, repo, number)` path segments for single-PR endpoints. */
+export declare const PullPath: Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>;
+/**
+ * Opens a PR. `base`/`head` accept short (`main`) or full
+ * (`refs/heads/main`) branch names — only branches are legal (no tags).
+ */
+export declare const CreatePull: HttpApiEndpoint.HttpApiEndpoint<"create", "POST", "/repos/:owner/:repo/pulls", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly title: Schema.String;
+    readonly body: Schema.optional<Schema.String>;
+    /** Target branch, short or full name. */
+    readonly base: Schema.String;
+    /** Source branch, short or full name. Must differ from `base`. */
+    readonly head: Schema.String;
+}>>, never, Schema.toCodecJson<typeof Pull>, Schema.toCodecJson<typeof RepoNotFound | typeof ValidationError | typeof BranchMissing | typeof PullExists>, never, never>;
+/** Lists PRs, newest first. `state` defaults to `open`. Anonymous on public repos. */
+export declare const ListPulls: HttpApiEndpoint.HttpApiEndpoint<"list", "GET", "/repos/:owner/:repo/pulls", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    /** Filter by lifecycle state. @default open */
+    readonly state: Schema.optional<Schema.Literals<readonly ["open", "closed", "merged", "all"]>>;
+    readonly cursor: Schema.optional<Schema.String>;
+    readonly limit: Schema.optional<Schema.Int>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly items: Schema.$Array<typeof Pull>;
+    readonly nextCursor: Schema.NullOr<Schema.String>;
+    readonly hasMore: Schema.Boolean;
+}>>, Schema.toCodecJson<typeof RepoNotFound>, never, never>;
+/** Reads one PR with live compare fields (aheadBy/behindBy/mergeable). */
+export declare const GetPull: HttpApiEndpoint.HttpApiEndpoint<"get", "GET", "/repos/:owner/:repo/pulls/:number", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>>, never, never, never, Schema.toCodecJson<typeof PullDetail>, Schema.toCodecJson<typeof RepoNotFound | typeof PullNotFound>, never, never>;
+/** Patches title/body, or closes/reopens via `state`. */
+export declare const UpdatePull: HttpApiEndpoint.HttpApiEndpoint<"update", "PATCH", "/repos/:owner/:repo/pulls/:number", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly title: Schema.optional<Schema.String>;
+    /** `null` clears the body. */
+    readonly body: Schema.optional<Schema.NullOr<Schema.String>>;
+    /**
+     * `closed` closes an open PR; `open` reopens a closed one. Merged
+     * PRs reject both (409).
+     */
+    readonly state: Schema.optional<Schema.Literals<readonly ["open", "closed"]>>;
+}>>, never, Schema.toCodecJson<typeof Pull>, Schema.toCodecJson<typeof RepoNotFound | typeof PullNotFound | typeof PullStateConflict>, never, never>;
+/**
+ * Merges an open PR: fast-forward when possible, else a merge commit iff
+ * the three-way tree merge is trivial.
+ */
+export declare const MergePull: HttpApiEndpoint.HttpApiEndpoint<"merge", "POST", "/repos/:owner/:repo/pulls/:number/merge", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    /**
+     * Merge-commit message; defaults to
+     * `Merge pull request #N from <head>`. Ignored on fast-forward.
+     */
+    readonly message: Schema.optional<Schema.String>;
+    /**
+     * Race guard: fail RefConflict if the head tip moved (force-push)
+     * since the caller inspected it.
+     */
+    readonly expectedHeadOid: Schema.optional<Schema.brand<Schema.String, "Oid">>;
+}>>, never, Schema.toCodecJson<typeof MergeResult>, Schema.toCodecJson<typeof ReadOnlyRepo | typeof PushDenied | typeof RepoNotFound | typeof RefConflict | typeof PullNotFound | typeof BranchMissing | typeof PullStateConflict | typeof NothingToMerge | typeof MergeConflict>, never, never>;
+declare const Pulls_base: HttpApiGroup.HttpApiGroup<"pulls", HttpApiEndpoint.HttpApiEndpoint<"create", "POST", "/api/v1/repos/:owner/:repo/pulls", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly title: Schema.String;
+    readonly body: Schema.optional<Schema.String>;
+    /** Target branch, short or full name. */
+    readonly base: Schema.String;
+    /** Source branch, short or full name. Must differ from `base`. */
+    readonly head: Schema.String;
+}>>, never, Schema.toCodecJson<typeof Pull>, Schema.toCodecJson<typeof RepoNotFound | typeof ValidationError | typeof BranchMissing | typeof PullExists>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"get", "GET", "/api/v1/repos/:owner/:repo/pulls/:number", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>>, never, never, never, Schema.toCodecJson<typeof PullDetail>, Schema.toCodecJson<typeof RepoNotFound | typeof PullNotFound>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"list", "GET", "/api/v1/repos/:owner/:repo/pulls", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    /** Filter by lifecycle state. @default open */
+    readonly state: Schema.optional<Schema.Literals<readonly ["open", "closed", "merged", "all"]>>;
+    readonly cursor: Schema.optional<Schema.String>;
+    readonly limit: Schema.optional<Schema.Int>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    readonly items: Schema.$Array<typeof Pull>;
+    readonly nextCursor: Schema.NullOr<Schema.String>;
+    readonly hasMore: Schema.Boolean;
+}>>, Schema.toCodecJson<typeof RepoNotFound>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"merge", "POST", "/api/v1/repos/:owner/:repo/pulls/:number/merge", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    /**
+     * Merge-commit message; defaults to
+     * `Merge pull request #N from <head>`. Ignored on fast-forward.
+     */
+    readonly message: Schema.optional<Schema.String>;
+    /**
+     * Race guard: fail RefConflict if the head tip moved (force-push)
+     * since the caller inspected it.
+     */
+    readonly expectedHeadOid: Schema.optional<Schema.brand<Schema.String, "Oid">>;
+}>>, never, Schema.toCodecJson<typeof MergeResult>, Schema.toCodecJson<typeof ReadOnlyRepo | typeof PushDenied | typeof RepoNotFound | typeof RefConflict | typeof PullNotFound | typeof BranchMissing | typeof PullStateConflict | typeof NothingToMerge | typeof MergeConflict>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"update", "PATCH", "/api/v1/repos/:owner/:repo/pulls/:number", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+    /** The PR number (path segment; decoded from its string form). */
+    readonly number: Schema.Int;
+}>>, never, Schema.toCodecJson<Schema.Struct<{
+    readonly title: Schema.optional<Schema.String>;
+    /** `null` clears the body. */
+    readonly body: Schema.optional<Schema.NullOr<Schema.String>>;
+    /**
+     * `closed` closes an open PR; `open` reopens a closed one. Merged
+     * PRs reject both (409).
+     */
+    readonly state: Schema.optional<Schema.Literals<readonly ["open", "closed"]>>;
+}>>, never, Schema.toCodecJson<typeof Pull>, Schema.toCodecJson<typeof RepoNotFound | typeof PullNotFound | typeof PullStateConflict>, never, never>, false>;
+/** The `pulls` group, mounted at `/api/v1`. */
+export declare class Pulls extends Pulls_base {
+}
+export {};
+//# sourceMappingURL=Pulls.d.ts.map

package/lib/Git/Api/Pulls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Pulls.d.ts","sourceRoot":"","sources":["../../../src/Git/Api/Pulls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,eAAe,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AACrE,OAAO,EACL,aAAa,EACb,aAAa,EACb,WAAW,EACX,cAAc,EAId,IAAI,EACJ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EACjB,YAAY,EACZ,WAAW,EAEX,YAAY,EAEZ,eAAe,EACf,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,qEAAqE;AACrE,eAAO,MAAM,QAAQ;;;IAGnB,kEAAkE;;EAElE,CAAC;AAEH;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;IAQjB,yCAAyC;;IAEzC,kEAAkE;;uKAMvE,CAAC;AAEF,sFAAsF;AACtF,eAAO,MAAM,SAAS;;;;IAMhB,+CAA+C;;;;;;;;2DAYpD,CAAC;AAEF,0EAA0E;AAC1E,eAAO,MAAM,OAAO;;;IAhDlB,kEAAkE;;6IAwDnE,CAAC;AAEF,yDAAyD;AACzD,eAAO,MAAM,UAAU;;;IA3DrB,kEAAkE;;;;IAkE9D,8BAA8B;;IAE9B;;;OAGG;;oJAMR,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,SAAS;;;IAnFpB,kEAAkE;;;IAyF9D;;;OAGG;;IAEH;;;OAGG;;gSAgBR,CAAC;;;;;;;IAjGI,yCAAyC;;IAEzC,kEAAkE;;;;;IAlBtE,kEAAkE;;;;;;IAiC9D,+CAA+C;;;;;;;;;;;IAjCnD,kEAAkE;;;IAyF9D;;;OAGG;;IAEH;;;OAGG;;;;;IAjGP,kEAAkE;;;;IAkE9D,8BAA8B;;IAE9B;;;OAGG;;;AA4CT,+CAA+C;AAC/C,qBAAa,KAAM,SAAQ,UAEP;CAAG"}

package/lib/Git/Api/Pulls.js

@@ -0,0 +1,109 @@
+/**
+ * The `pulls` group: pull-request lifecycle + merge (DESIGN.md §5).
+ *
+ * PRs are same-repo branch PRs (no cross-fork), tracking **live** branches
+ * by ref name: diff and mergeability are computed on read from current ref
+ * tips. Merging fast-forwards when possible; otherwise it creates a merge
+ * commit iff the three-way tree merge is trivial (no path touched on both
+ * sides relative to the merge base) — a conflicting PR is a typed 409, the
+ * server never writes conflict markers.
+ */
+import * as HttpApiEndpoint from "effect/unstable/httpapi/HttpApiEndpoint";
+import * as Schema from "effect/Schema";
+import * as HttpApiGroup from "effect/unstable/httpapi/HttpApiGroup";
+import { BranchMissing, MergeConflict, MergeResult, NothingToMerge, Oid, OwnerName, Paginated, Pull, PullDetail, PullExists, PullNotFound, PullStateConflict, ReadOnlyRepo, RefConflict, RepoName, RepoNotFound, RepoPath, ValidationError, PushDenied, } from "./Schema.js";
+/** `(owner, repo, number)` path segments for single-PR endpoints. */
+export const PullPath = Schema.Struct({
+    owner: OwnerName,
+    repo: RepoName,
+    /** The PR number (path segment; decoded from its string form). */
+    number: Schema.Int.check(Schema.isGreaterThanOrEqualTo(1)),
+});
+/**
+ * Opens a PR. `base`/`head` accept short (`main`) or full
+ * (`refs/heads/main`) branch names — only branches are legal (no tags).
+ */
+export const CreatePull = HttpApiEndpoint.post("create", "/repos/:owner/:repo/pulls", {
+    params: RepoPath,
+    payload: Schema.Struct({
+        title: Schema.String.check(Schema.isMinLength(1)),
+        body: Schema.optional(Schema.String),
+        /** Target branch, short or full name. */
+        base: Schema.String,
+        /** Source branch, short or full name. Must differ from `base`. */
+        head: Schema.String,
+    }),
+    success: Pull,
+    error: [RepoNotFound, BranchMissing, PullExists, ValidationError],
+});
+/** Lists PRs, newest first. `state` defaults to `open`. Anonymous on public repos. */
+export const ListPulls = HttpApiEndpoint.get("list", "/repos/:owner/:repo/pulls", {
+    params: RepoPath,
+    query: Schema.Struct({
+        /** Filter by lifecycle state. @default open */
+        state: Schema.optional(Schema.Literals(["open", "closed", "merged", "all"])),
+        cursor: Schema.optional(Schema.String),
+        limit: Schema.optional(Schema.Int.check(Schema.isBetween({ minimum: 1, maximum: 100 }))),
+    }),
+    success: Paginated(Pull),
+    error: [RepoNotFound],
+});
+/** Reads one PR with live compare fields (aheadBy/behindBy/mergeable). */
+export const GetPull = HttpApiEndpoint.get("get", "/repos/:owner/:repo/pulls/:number", {
+    params: PullPath,
+    success: PullDetail,
+    error: [RepoNotFound, PullNotFound],
+});
+/** Patches title/body, or closes/reopens via `state`. */
+export const UpdatePull = HttpApiEndpoint.patch("update", "/repos/:owner/:repo/pulls/:number", {
+    params: PullPath,
+    payload: Schema.Struct({
+        title: Schema.optional(Schema.String.check(Schema.isMinLength(1))),
+        /** `null` clears the body. */
+        body: Schema.optional(Schema.NullOr(Schema.String)),
+        /**
+         * `closed` closes an open PR; `open` reopens a closed one. Merged
+         * PRs reject both (409).
+         */
+        state: Schema.optional(Schema.Literals(["open", "closed"])),
+    }),
+    success: Pull,
+    error: [RepoNotFound, PullNotFound, PullStateConflict],
+});
+/**
+ * Merges an open PR: fast-forward when possible, else a merge commit iff
+ * the three-way tree merge is trivial.
+ */
+export const MergePull = HttpApiEndpoint.post("merge", "/repos/:owner/:repo/pulls/:number/merge", {
+    params: PullPath,
+    payload: Schema.Struct({
+        /**
+         * Merge-commit message; defaults to
+         * `Merge pull request #N from <head>`. Ignored on fast-forward.
+         */
+        message: Schema.optional(Schema.String),
+        /**
+         * Race guard: fail RefConflict if the head tip moved (force-push)
+         * since the caller inspected it.
+         */
+        expectedHeadOid: Schema.optional(Oid),
+    }),
+    success: MergeResult,
+    error: [
+        PushDenied,
+        RepoNotFound,
+        PullNotFound,
+        PullStateConflict,
+        BranchMissing,
+        NothingToMerge,
+        MergeConflict,
+        RefConflict,
+        ReadOnlyRepo,
+    ],
+});
+/** The `pulls` group, mounted at `/api/v1`. */
+export class Pulls extends HttpApiGroup.make("pulls")
+    .add(CreatePull, ListPulls, GetPull, UpdatePull, MergePull)
+    .prefix("/api/v1") {
+}
+//# sourceMappingURL=Pulls.js.map

package/lib/Git/Api/Pulls.js.map

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

package/lib/Git/Api/Refs.d.ts

@@ -0,0 +1,95 @@
+/**
+ * The `refs` group: ref reads and transactional (CAS) writes (DESIGN.md §5).
+ *
+ * Ref names contain `/`, so the single-ref endpoints address the ref via
+ * the `name` query parameter, not a path segment.
+ */
+import * as HttpApiEndpoint from "effect/unstable/httpapi/HttpApiEndpoint";
+import * as Schema from "effect/Schema";
+import * as HttpApiGroup from "effect/unstable/httpapi/HttpApiGroup";
+import * as HttpApiSchema from "effect/unstable/httpapi/HttpApiSchema";
+import { ObjectNotFound, ReadOnlyRepo, Ref, RefConflict, RefNotFound, RepoNotFound, PushDenied } from "./Schema.ts";
+/** Lists refs, optionally filtered by prefix (e.g. `refs/heads/`). */
+export declare const ListRefs: HttpApiEndpoint.HttpApiEndpoint<"list", "GET", "/repos/:owner/:repo/refs", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    /** Filter by prefix, e.g. `refs/heads/`. */
+    readonly prefix: Schema.optional<Schema.String>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    /** The default branch's full ref name, `null` on an unborn repo. */
+    readonly head: Schema.NullOr<Schema.String>;
+    readonly refs: Schema.$Array<typeof Ref>;
+}>>, Schema.toCodecJson<typeof RepoNotFound>, never, never>;
+/** Reads one ref by full name (`?name=refs/heads/main`). */
+export declare const GetRef: HttpApiEndpoint.HttpApiEndpoint<"get", "GET", "/repos/:owner/:repo/ref", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly name: Schema.String;
+}>>, never, never, Schema.toCodecJson<typeof Ref>, Schema.toCodecJson<typeof RepoNotFound | typeof RefNotFound>, never, never>;
+/** Writes one ref with CAS semantics. */
+export declare const UpdateRef: HttpApiEndpoint.HttpApiEndpoint<"update", "PUT", "/repos/:owner/:repo/ref", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly name: Schema.String;
+}>>, Schema.toCodecJson<Schema.Struct<{
+    readonly newOid: Schema.brand<Schema.String, "Oid">;
+    /**
+     * CAS token: current oid the ref must hold. `null` = the ref must
+     * not exist (create). Absent = unconditional write.
+     */
+    readonly expectedOid: Schema.optional<Schema.NullOr<Schema.brand<Schema.String, "Oid">>>;
+}>>, never, Schema.toCodecJson<typeof Ref>, Schema.toCodecJson<typeof ReadOnlyRepo | typeof PushDenied | typeof RepoNotFound | typeof RefConflict | typeof ObjectNotFound>, never, never>;
+/** Deletes one ref with CAS semantics. */
+export declare const RemoveRef: HttpApiEndpoint.HttpApiEndpoint<"remove", "DELETE", "/repos/:owner/:repo/ref", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly name: Schema.String;
+}>>, Schema.toCodecJson<Schema.Struct<{
+    /** CAS token: current oid the ref must hold. Absent = unconditional. */
+    readonly expectedOid: Schema.optional<Schema.brand<Schema.String, "Oid">>;
+}>>, never, Schema.toCodecJson<HttpApiSchema.NoContent>, Schema.toCodecJson<typeof ReadOnlyRepo | typeof PushDenied | typeof RepoNotFound | typeof RefNotFound | typeof RefConflict>, never, never>;
+declare const Refs_base: HttpApiGroup.HttpApiGroup<"refs", HttpApiEndpoint.HttpApiEndpoint<"get", "GET", "/api/v1/repos/:owner/:repo/ref", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly name: Schema.String;
+}>>, never, never, Schema.toCodecJson<typeof Ref>, Schema.toCodecJson<typeof RepoNotFound | typeof RefNotFound>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"list", "GET", "/api/v1/repos/:owner/:repo/refs", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    /** Filter by prefix, e.g. `refs/heads/`. */
+    readonly prefix: Schema.optional<Schema.String>;
+}>>, never, never, Schema.toCodecJson<Schema.Struct<{
+    /** The default branch's full ref name, `null` on an unborn repo. */
+    readonly head: Schema.NullOr<Schema.String>;
+    readonly refs: Schema.$Array<typeof Ref>;
+}>>, Schema.toCodecJson<typeof RepoNotFound>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"remove", "DELETE", "/api/v1/repos/:owner/:repo/ref", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly name: Schema.String;
+}>>, Schema.toCodecJson<Schema.Struct<{
+    /** CAS token: current oid the ref must hold. Absent = unconditional. */
+    readonly expectedOid: Schema.optional<Schema.brand<Schema.String, "Oid">>;
+}>>, never, Schema.toCodecJson<HttpApiSchema.NoContent>, Schema.toCodecJson<typeof ReadOnlyRepo | typeof PushDenied | typeof RepoNotFound | typeof RefNotFound | typeof RefConflict>, never, never> | HttpApiEndpoint.HttpApiEndpoint<"update", "PUT", "/api/v1/repos/:owner/:repo/ref", Schema.toCodecStringTree<Schema.Struct<{
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>>, Schema.toCodecStringTree<Schema.Struct<{
+    readonly name: Schema.String;
+}>>, Schema.toCodecJson<Schema.Struct<{
+    readonly newOid: Schema.brand<Schema.String, "Oid">;
+    /**
+     * CAS token: current oid the ref must hold. `null` = the ref must
+     * not exist (create). Absent = unconditional write.
+     */
+    readonly expectedOid: Schema.optional<Schema.NullOr<Schema.brand<Schema.String, "Oid">>>;
+}>>, never, Schema.toCodecJson<typeof Ref>, Schema.toCodecJson<typeof ReadOnlyRepo | typeof PushDenied | typeof RepoNotFound | typeof RefConflict | typeof ObjectNotFound>, never, never>, false>;
+/** The `refs` group, mounted at `/api/v1`. */
+export declare class Refs extends Refs_base {
+}
+export {};
+//# sourceMappingURL=Refs.d.ts.map

package/lib/Git/Api/Refs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Refs.d.ts","sourceRoot":"","sources":["../../../src/Git/Api/Refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,eAAe,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,aAAa,MAAM,uCAAuC,CAAC;AACvE,OAAO,EACL,cAAc,EAEd,YAAY,EACZ,GAAG,EACH,WAAW,EAEX,WAAW,EACX,YAAY,EAEZ,UAAU,EACX,MAAM,aAAa,CAAC;AAErB,sEAAsE;AACtE,eAAO,MAAM,QAAQ;;;;IAMf,4CAA4C;;;IAI5C,oEAAoE;;;2DAMzE,CAAC;AAEF,4DAA4D;AAC5D,eAAO,MAAM,MAAM;;;;;8HAKjB,CAAC;AAEH,yCAAyC;AACzC,eAAO,MAAM,SAAS;;;;;;;IAQhB;;;OAGG;;yLAYR,CAAC;AAEF,0CAA0C;AAC1C,eAAO,MAAM,SAAS;;;;;;IAOhB,wEAAwE;;mMAM7E,CAAC;;;;;;;;;;IA5DI,4CAA4C;;;IAI5C,oEAAoE;;;;;;;;;IAkDpE,wEAAwE;;;;;;;;;IAzBxE;;;OAGG;;;AA8BT,8CAA8C;AAC9C,qBAAa,IAAK,SAAQ,SAEN;CAAG"}

package/lib/Git/Api/Refs.js

@@ -0,0 +1,70 @@
+/**
+ * The `refs` group: ref reads and transactional (CAS) writes (DESIGN.md §5).
+ *
+ * Ref names contain `/`, so the single-ref endpoints address the ref via
+ * the `name` query parameter, not a path segment.
+ */
+import * as HttpApiEndpoint from "effect/unstable/httpapi/HttpApiEndpoint";
+import * as Schema from "effect/Schema";
+import * as HttpApiGroup from "effect/unstable/httpapi/HttpApiGroup";
+import * as HttpApiSchema from "effect/unstable/httpapi/HttpApiSchema";
+import { ObjectNotFound, Oid, ReadOnlyRepo, Ref, RefConflict, RefName, RefNotFound, RepoNotFound, RepoPath, PushDenied, } from "./Schema.js";
+/** Lists refs, optionally filtered by prefix (e.g. `refs/heads/`). */
+export const ListRefs = HttpApiEndpoint.get("list", "/repos/:owner/:repo/refs", {
+    params: RepoPath,
+    query: Schema.Struct({
+        /** Filter by prefix, e.g. `refs/heads/`. */
+        prefix: Schema.optional(Schema.String),
+    }),
+    success: Schema.Struct({
+        /** The default branch's full ref name, `null` on an unborn repo. */
+        head: Schema.NullOr(Schema.String),
+        refs: Schema.Array(Ref),
+    }),
+    error: [RepoNotFound],
+});
+/** Reads one ref by full name (`?name=refs/heads/main`). */
+export const GetRef = HttpApiEndpoint.get("get", "/repos/:owner/:repo/ref", {
+    params: RepoPath,
+    query: Schema.Struct({ name: RefName }),
+    success: Ref,
+    error: [RepoNotFound, RefNotFound],
+});
+/** Writes one ref with CAS semantics. */
+export const UpdateRef = HttpApiEndpoint.put("update", "/repos/:owner/:repo/ref", {
+    params: RepoPath,
+    query: Schema.Struct({ name: RefName }),
+    payload: Schema.Struct({
+        newOid: Oid,
+        /**
+         * CAS token: current oid the ref must hold. `null` = the ref must
+         * not exist (create). Absent = unconditional write.
+         */
+        expectedOid: Schema.optional(Schema.NullOr(Oid)),
+    }),
+    success: Ref,
+    error: [
+        PushDenied,
+        RepoNotFound,
+        RefConflict,
+        ObjectNotFound,
+        ReadOnlyRepo,
+    ],
+});
+/** Deletes one ref with CAS semantics. */
+export const RemoveRef = HttpApiEndpoint.delete("remove", "/repos/:owner/:repo/ref", {
+    params: RepoPath,
+    query: Schema.Struct({ name: RefName }),
+    payload: Schema.Struct({
+        /** CAS token: current oid the ref must hold. Absent = unconditional. */
+        expectedOid: Schema.optional(Oid),
+    }),
+    success: HttpApiSchema.NoContent,
+    error: [PushDenied, RepoNotFound, RefNotFound, RefConflict, ReadOnlyRepo],
+});
+/** The `refs` group, mounted at `/api/v1`. */
+export class Refs extends HttpApiGroup.make("refs")
+    .add(ListRefs, GetRef, UpdateRef, RemoveRef)
+    .prefix("/api/v1") {
+}
+//# sourceMappingURL=Refs.js.map

package/lib/Git/Api/Refs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"Refs.js","sourceRoot":"","sources":["../../../src/Git/Api/Refs.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,eAAe,MAAM,yCAAyC,CAAC;AAC3E,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,KAAK,YAAY,MAAM,sCAAsC,CAAC;AACrE,OAAO,KAAK,aAAa,MAAM,uCAAuC,CAAC;AACvE,OAAO,EACL,cAAc,EACd,GAAG,EACH,YAAY,EACZ,GAAG,EACH,WAAW,EACX,OAAO,EACP,WAAW,EACX,YAAY,EACZ,QAAQ,EACR,UAAU,GACX,MAAM,aAAa,CAAC;AAErB,sEAAsE;AACtE,MAAM,CAAC,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CACzC,MAAM,EACN,0BAA0B,EAC1B;IACE,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC;QACnB,4CAA4C;QAC5C,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;KACvC,CAAC;IACF,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,oEAAoE;QACpE,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC;QAClC,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;KACxB,CAAC;IACF,KAAK,EAAE,CAAC,YAAY,CAAC;CACtB,CACF,CAAC;AAEF,4DAA4D;AAC5D,MAAM,CAAC,MAAM,MAAM,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,EAAE,yBAAyB,EAAE;IAC1E,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvC,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE,CAAC,YAAY,EAAE,WAAW,CAAC;CACnC,CAAC,CAAC;AAEH,yCAAyC;AACzC,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC,GAAG,CAC1C,QAAQ,EACR,yBAAyB,EACzB;IACE,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,MAAM,EAAE,GAAG;QACX;;;WAGG;QACH,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;KACjD,CAAC;IACF,OAAO,EAAE,GAAG;IACZ,KAAK,EAAE;QACL,UAAU;QACV,YAAY;QACZ,WAAW;QACX,cAAc;QACd,YAAY;KACb;CACF,CACF,CAAC;AAEF,0CAA0C;AAC1C,MAAM,CAAC,MAAM,SAAS,GAAG,eAAe,CAAC,MAAM,CAC7C,QAAQ,EACR,yBAAyB,EACzB;IACE,MAAM,EAAE,QAAQ;IAChB,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC,MAAM,CAAC;QACrB,wEAAwE;QACxE,WAAW,EAAE,MAAM,CAAC,QAAQ,CAAC,GAAG,CAAC;KAClC,CAAC;IACF,OAAO,EAAE,aAAa,CAAC,SAAS;IAChC,KAAK,EAAE,CAAC,UAAU,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC;CAC1E,CACF,CAAC;AAEF,8CAA8C;AAC9C,MAAM,OAAO,IAAK,SAAQ,YAAY,CAAC,IAAI,CAAC,MAAM,CAAC;KAChD,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,CAAC;KAC3C,MAAM,CAAC,SAAS,CAAC;CAAG"}