alchemy 2.0.0-beta.77 → 2.0.0-beta.78

package/lib/Git/Engine.js

@@ -0,0 +1,290 @@
+/** Git operations without HTTP requests, user services, or authorization callbacks. */
+import * as Context from "effect/Context";
+import * as Effect from "effect/Effect";
+import * as Fiber from "effect/Fiber";
+import * as Layer from "effect/Layer";
+import * as Option from "effect/Option";
+import * as Semaphore from "effect/Semaphore";
+import { RuntimeContext } from "../RuntimeContext.js";
+import { PushDenied, RefConflict, RepoNotFound } from "./Api/Schema.js";
+import { BlobStore } from "./BlobStore.js";
+import { Hasher } from "./Hasher/Hasher.js";
+import { Operations, OperationsLive } from "./Operations.js";
+import { StoreError } from "./Protocol/Store.js";
+import { incomingStates, invalidPush, preparedStates, } from "./Push.js";
+import { encodeStagedBatch } from "./PushWire.js";
+import { ulid } from "./RegistryObject.js";
+import { MAX_PACK_BYTES, PUSH_WAIT_TIMEOUT, RepoStore, ingestPackFrom, isolatePushGate, pushPermitsFor, } from "./RepoObject.js";
+import { incomingKey, wirePackId } from "./Store/Keys.js";
+import { sliceRandomAccess } from "./Store/PackSource.js";
+const path = (repo) => ({ owner: repo.owner, repo: repo.name });
+const asStoreError = (error) => error instanceof StoreError
+    ? error
+    : new StoreError({
+        reason: `${error._tag}${error.reason === undefined ? "" : `: ${error.reason}`}`,
+    });
+const scopedMutation = (updates, commit) => Effect.gen(function* () {
+    let active = true;
+    yield* Effect.addFinalizer(() => Effect.sync(() => {
+        active = false;
+    }));
+    return Object.freeze({
+        updates: Object.freeze(updates.map((update) => Object.freeze({ ...update }))),
+        commit: Effect.suspend(() => {
+            if (!active)
+                return Effect.fail(invalidPush());
+            active = false;
+            return commit;
+        }),
+    });
+});
+const make = Effect.gen(function* () {
+    const operations = yield* Operations;
+    const repos = yield* RepoStore;
+    const blobs = yield* BlobStore;
+    const hasher = yield* Hasher;
+    const gate = yield* isolatePushGate;
+    const owner = {};
+    const get = (path) => Effect.gen(function* () {
+        const name = {
+            owner: path.owner.toLowerCase(),
+            repo: path.repo.toLowerCase().replace(/\.git$/, ""),
+        };
+        const entry = yield* operations.resolveCached(name.owner, name.repo);
+        if (entry === undefined || entry.deletedAt !== null)
+            return yield* new RepoNotFound(name);
+        return yield* repos.getByName(entry.repoId).getRepoMeta();
+    });
+    const preparePush = (repo, input) => Effect.gen(function* () {
+        const source = incomingStates.get(input);
+        if (source === undefined || !source.active || source.claimed)
+            return yield* invalidPush();
+        source.claimed = true;
+        const { feeder, receiving, packStart } = source;
+        const stub = repos.getByName(repo.repoId);
+        const staging = [];
+        let active = true;
+        let committed = false;
+        let ingest;
+        const receiveId = yield* ulid();
+        const parkedKey = incomingKey(repo.repoId, receiveId);
+        // Registered before ingest: cancellation and policy failure share the same owner.
+        const begun = yield* Effect.acquireRelease(stub.beginPush({ commands: input.updates }), (begun) => Effect.gen(function* () {
+            active = false;
+            if (begun._tag === "denied")
+                return;
+            yield* Fiber.interruptAll(staging.splice(0));
+            if (committed)
+                return;
+            // Ask durable state before deleting bytes: an interrupted RPC may have committed.
+            const keys = [
+                parkedKey,
+                ...(ingest?.resolvedKey?.split(",") ?? []),
+            ].filter(Boolean);
+            const packIds = keys.map((key) => wirePackId(key.slice(key.lastIndexOf("/") + 1, -5)));
+            const aborted = yield* stub
+                .abortPush(begun.pushId, packIds)
+                .pipe(Effect.orElseSucceed(() => false));
+            if (aborted) {
+                yield* blobs.delete(keys).pipe(Effect.ignore);
+            }
+        }));
+        if (begun._tag === "denied")
+            return yield* new PushDenied({
+                ref: input.updates[0]?.ref ?? "",
+                reason: begun.reason,
+            });
+        const pushId = begun.pushId;
+        const permits = pushPermitsFor(source.declaredBytes);
+        const acquired = yield* Effect.acquireRelease(Semaphore.take(gate, permits).pipe(Effect.timeoutOption(PUSH_WAIT_TIMEOUT)), (acquired) => Option.isSome(acquired)
+            ? Semaphore.release(gate, permits)
+            : Effect.void);
+        if (Option.isNone(acquired))
+            return yield* new StoreError({ reason: "push admission timed out" });
+        const started = Date.now();
+        const stageGate = yield* Semaphore.make(6);
+        const bases = new Map();
+        const store = {
+            insertStagedBatch: (id, objects) => Effect.gen(function* () {
+                const encoded = encodeStagedBatch(objects);
+                const fiber = yield* Effect.forkDetach(Semaphore.withPermits(stageGate, 1)(stub
+                    .stagePush(id, encoded)
+                    .pipe(Effect.mapError(asStoreError), Effect.provide(RuntimeContext.phantom))));
+                staging.push(fiber);
+            }),
+            settle: Effect.gen(function* () {
+                for (const fiber of staging)
+                    yield* Fiber.join(fiber);
+                staging.length = 0;
+            }),
+            readBase: (oid) => bases.has(oid)
+                ? Effect.succeed(bases.get(oid))
+                : stub.readPushBase(oid).pipe(Effect.mapError(asStoreError), Effect.tap((value) => Effect.sync(() => {
+                    bases.set(oid, value);
+                })), Effect.provide(RuntimeContext.phantom)),
+        };
+        const probe = yield* feeder.source.read(packStart, 12);
+        if (probe.length > 0 && probe.length < 12) {
+            return yield* new StoreError({ reason: "truncated pack header" });
+        }
+        const hasPack = probe.length === 12;
+        if (hasPack) {
+            ingest = yield* ingestPackFrom(sliceRandomAccess(feeder.source, packStart), {
+                store,
+                pushId,
+                hasher,
+                spill: {
+                    body: feeder.source,
+                    feeder,
+                    packStart,
+                    blobs,
+                    key: parkedKey,
+                    packId: wirePackId(receiveId),
+                    repoId: repo.repoId,
+                    threshold: MAX_PACK_BYTES,
+                },
+            });
+        }
+        if (store.settle)
+            yield* store.settle;
+        const received = yield* Fiber.join(receiving).pipe(Effect.flatMap(Effect.fromResult));
+        const commitInput = {
+            pushId,
+            commands: input.updates,
+            atomic: input.atomic,
+            commits: ingest?.commits ?? [],
+            referenced: ingest?.referenced ?? [],
+            referencedParents: ingest?.referencedParents ?? [],
+            promoted: ingest?.promoted ?? 0,
+            stats: {
+                objects: ingest?.objectCount ?? 0,
+                bytes: hasPack ? received.total - packStart : 0,
+                ingestMs: Date.now() - started,
+                stageMs: ingest?.stageMs ?? 0,
+                phases: ingest?.phases,
+            },
+        };
+        // Connectivity is checked before application validation, then again at commit.
+        yield* stub.validatePush(commitInput).pipe(Effect.mapError(asStoreError));
+        const prepared = Object.freeze({
+            repo: Object.freeze({ ...repo }),
+            updates: input.updates,
+            readObject: (oid, maxBytes = 1024 * 1024) => Effect.suspend(() => !active || !source.active
+                ? Effect.fail(invalidPush())
+                : stub
+                    .readPreparedObject(pushId, oid, maxBytes)
+                    .pipe(Effect.mapError(asStoreError))),
+        });
+        preparedStates.set(prepared, {
+            owner,
+            commit: Effect.suspend(() => {
+                if (!active || !source.active)
+                    return Effect.fail(invalidPush());
+                active = false;
+                return stub.commitPush(commitInput).pipe(Effect.mapError(asStoreError), Effect.tap((result) => Effect.sync(() => {
+                    committed = result.results.some((ref) => ref.ok);
+                })));
+            }),
+        });
+        return prepared;
+    });
+    const commitPush = (prepared) => Effect.suspend(() => {
+        const state = preparedStates.get(prepared);
+        return state?.owner === owner ? state.commit : Effect.fail(invalidPush());
+    });
+    const prepareRefUpdate = (repo, input) => Effect.gen(function* () {
+        const stub = repos.getByName(repo.repoId);
+        const current = yield* stub.getRef(input.ref).pipe(Effect.map((ref) => ref.oid), Effect.catchTag("RefNotFound", () => Effect.succeed("0".repeat(40))));
+        if (input.expectedOid !== undefined &&
+            input.expectedOid !== (current === "0".repeat(40) ? null : current))
+            return yield* new RefConflict({
+                ref: input.ref,
+                currentOid: current,
+            });
+        const update = { ref: input.ref, oldOid: current, newOid: input.newOid };
+        const commit = stub.updateRef({
+            name: input.ref,
+            newOid: input.newOid,
+            expectedOid: current === "0".repeat(40) ? null : current,
+        });
+        return yield* scopedMutation([update], commit);
+    });
+    const prepareRefRemoval = (repo, input) => Effect.gen(function* () {
+        const stub = repos.getByName(repo.repoId);
+        const current = yield* stub.getRef(input.ref);
+        if (input.expectedOid !== undefined && input.expectedOid !== current.oid)
+            return yield* new RefConflict({
+                ref: input.ref,
+                currentOid: current.oid,
+            });
+        return yield* scopedMutation([{ ref: input.ref, oldOid: current.oid, newOid: "0".repeat(40) }], stub.removeRef({ name: input.ref, expectedOid: current.oid }));
+    });
+    const prepareMerge = (repo, input) => Effect.gen(function* () {
+        const stub = repos.getByName(repo.repoId);
+        const pull = yield* stub.getPull(input.number);
+        return yield* scopedMutation([
+            {
+                ref: pull.baseRef,
+                oldOid: pull.baseOid ?? "0".repeat(40),
+                newOid: pull.headOid ?? "0".repeat(40),
+            },
+        ], stub.mergePull({
+            ...input,
+            expectedBaseOid: pull.baseOid ?? "0".repeat(40),
+            expectedHeadOid: input.expectedHeadOid ?? pull.headOid ?? "0".repeat(40),
+        }));
+    });
+    // These operate on repository data; authorization is composed by the caller.
+    return {
+        repositories: {
+            get,
+            create: (payload) => operations.repos.create({ payload }),
+            list: (query) => operations.repos.list({ query }),
+            update: (repo, payload) => operations.repos.update({ params: path(repo), payload }),
+            remove: (repo) => operations.repos.delete({ params: path(repo) }),
+            fork: (repo, payload) => operations.repos.fork({ params: path(repo), payload }),
+            import: (payload) => operations.repos.import({ payload }),
+            compact: (repo) => operations.repos.compact({ params: path(repo) }),
+        },
+        refs: {
+            list: (repo) => repos.getByName(repo.repoId).listRefs(),
+            get: (repo, name) => repos.getByName(repo.repoId).getRef(name),
+            update: (repo, input) => repos.getByName(repo.repoId).updateRef(input),
+            remove: (repo, input) => repos.getByName(repo.repoId).removeRef(input),
+        },
+        pulls: {
+            create: (repo, payload) => operations.pulls.create({ params: path(repo), payload }),
+            list: (repo, query) => operations.pulls.list({ params: path(repo), query }),
+            update: (repo, number, payload) => operations.pulls.update({ params: { ...path(repo), number }, payload }),
+            get: (repo, number) => repos.getByName(repo.repoId).getPull(number),
+            merge: (repo, input) => repos.getByName(repo.repoId).mergePull(input),
+        },
+        objects: {
+            commit: (repo, oid) => operations.objects.commit({
+                params: { ...path(repo), oid: oid },
+            }),
+            file: (repo, input) => repos.getByName(repo.repoId).readFileAtPath(input),
+            log: (repo, query) => operations.objects.log({ params: path(repo), query }),
+            tree: (repo, oid) => operations.objects.tree({ params: { ...path(repo), oid } }),
+            diff: (repo, oid) => operations.objects.diff({ params: { ...path(repo), oid } }),
+            compare: (repo, query) => operations.objects.compare({ params: path(repo), query }),
+            read: (repo, oid) => repos.getByName(repo.repoId).readPushBase(oid),
+        },
+        preparePush,
+        commitPush,
+        prepareRefUpdate,
+        prepareRefRemoval,
+        prepareMerge,
+    };
+});
+/** Git operations usable from HTTP handlers, jobs, and ordinary Effects. */
+export class Engine extends Context.Service()("alchemy/Git/Engine") {
+}
+/**
+ * Provides the Git engine using the application's repository, registry, blob, and hasher layers.
+ *
+ * @layer
+ * @provides Git.Engine
+ */
+export const EngineLive = Layer.effect(Engine, make).pipe(Layer.provideMerge(OperationsLive));
+//# sourceMappingURL=Engine.js.map

package/lib/Git/Engine.js.map

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

package/lib/Git/GitHubCompat.d.ts

@@ -0,0 +1,155 @@
+/**
+ * GitHub REST v3 compatibility facade (`/api/v3/**`) — DESIGN.md "Tier 1".
+ *
+ * Lets GitHub-flavored tooling talk to the service unmodified. The target
+ * consumers are `gh api` (via `GH_HOST=<host>` + `GH_ENTERPRISE_TOKEN`,
+ * which sends REST to `https://<host>/api/v3/...`) and Octokit-style SDKs
+ * pointed at a GitHub Enterprise `baseUrl`. Only the REST plane is
+ * mimicked — the `gh pr`/`gh issue` porcelain commands speak GraphQL and
+ * are out of scope (use `gh api` paths instead).
+ *
+ * This module is a pure TRANSLATION layer: every route parses GitHub's
+ * request shapes, calls the same Repo-DO RPCs the native `/api/v1` plane
+ * uses (auth enforcement stays in the DO), and re-shapes responses into
+ * GitHub's JSON. GitHub-isms handled here:
+ *
+ * - `Authorization: token <t>` (gh's scheme) — parsed by `Auth.ts`
+ *   alongside Bearer/Basic.
+ * - A merged PR is `state: "closed"` with `merged: true` (our tri-state
+ *   `merged` collapses into GitHub's boolean).
+ * - Errors are `{ message }` with GitHub's status conventions (401
+ *   "Requires authentication", 404 "Not Found", 405 for unsupported merge
+ *   methods, 409 for conflicts).
+ * - List pagination is RFC-5988 `Link: <...>; rel="next"` headers. The
+ *   next URL carries an opaque `cursor` (not a page number) — `gh api
+ *   --paginate` and Octokit follow the URL verbatim, so keyset cursors
+ *   work transparently.
+ *
+ * Deliberately absent (documented, not accidental): issues, reviews,
+ * comments, checks, search, GraphQL, rename detection in file lists, and
+ * additions/deletions line counts (reported as 0 — the server does not
+ * compute content diffs; fetch blobs and diff client-side).
+ */
+import * as Effect from "effect/Effect";
+import * as HttpRouter from "effect/unstable/http/HttpRouter";
+import * as HttpServerRequest from "effect/unstable/http/HttpServerRequest";
+import * as HttpServerResponse from "effect/unstable/http/HttpServerResponse";
+import type { RuntimeContext } from "../RuntimeContext.ts";
+import type { RegistryEntry } from "./RegistryObject.ts";
+import type { CommitDiffData, CompareData, FileData, MergePullResult, PullData, PullDetailData, PullsPage, RefsPage, RepoMetaData, CommitLogPage } from "./RepoObject.ts";
+/** Outcome of the Worker's shared owner/repo + credential prelude. */
+export type CompatPrelude = {
+    readonly kind: "halt";
+    readonly response: HttpServerResponse.HttpServerResponse;
+} | {
+    readonly kind: "ok";
+    readonly entry: RegistryEntry;
+};
+/** The slice of the Repo-DO stub the facade calls. */
+export interface CompatRepoStub {
+    readonly getRepoMeta: () => Effect.Effect<RepoMetaData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly listRefs: (prefix?: string | undefined) => Effect.Effect<RefsPage, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly readCommitLog: (input: {
+        readonly ref?: string | undefined;
+        readonly cursor?: string | undefined;
+        readonly limit?: number | undefined;
+    }) => Effect.Effect<CommitLogPage, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly readCommitDiff: (input: {
+        readonly oid: string;
+    }) => Effect.Effect<CommitDiffData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly compareCommits: (input: {
+        readonly base: string;
+        readonly head: string;
+    }) => Effect.Effect<CompareData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly readFileAtPath: (input: {
+        readonly ref?: string | undefined;
+        readonly path: string;
+    }) => Effect.Effect<FileData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly createPull: (input: {
+        readonly title: string;
+        readonly body?: string | undefined;
+        readonly base: string;
+        readonly head: string;
+    }) => Effect.Effect<PullData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly listPulls: (input: {
+        readonly state?: "open" | "closed" | "merged" | "all" | undefined;
+        readonly cursor?: string | undefined;
+        readonly limit?: number | undefined;
+    }) => Effect.Effect<PullsPage, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly getPull: (number: number) => Effect.Effect<PullDetailData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly updatePull: (input: {
+        readonly number: number;
+        readonly title?: string | undefined;
+        readonly body?: string | null | undefined;
+        readonly state?: "open" | "closed" | undefined;
+    }) => Effect.Effect<PullData, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+    readonly mergePull: (input: {
+        readonly number: number;
+        readonly message?: string | undefined;
+        readonly expectedHeadOid?: string | undefined;
+    }) => Effect.Effect<MergePullResult, {
+        readonly _tag: string;
+    }, RuntimeContext>;
+}
+export interface GitHubCompatOptions {
+    /**
+     * The Worker's `rawRestPrelude`: resolves `owner/repo`, parses
+     * credentials (anonymous allowed — public repos), and 404s/500s early.
+     */
+    readonly prelude: (owner: string, repo: string) => Effect.Effect<CompatPrelude, never, HttpServerRequest.HttpServerRequest | RuntimeContext>;
+    /** Repo-DO stub by repoId (the Worker's `repos.getByName`). */
+    readonly stub: (repoId: string) => CompatRepoStub;
+}
+/**
+ * Builds the `/api/v3` route layer. Mounted by the GitWorker next to the
+ * git wire routes; every repo-scoped route flows through the same
+ * `prelude` (owner/name resolution)
+ * as the raw REST routes.
+ */
+export declare const gitHubCompatRoutes: (options: GitHubCompatOptions) => {
+    /** `GET /api/v3/user` — the credential probe; override the `user` handler in your `github` group to answer from your users. */
+    user: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, never>;
+    /** `GET /api/v3/repos/:owner/:repo` */
+    repo: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/branches` */
+    branches: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/commits` */
+    commits: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/commits/:sha` */
+    commit: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/contents/*` */
+    contents: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/pulls` */
+    pulls: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `POST /api/v3/repos/:owner/:repo/pulls` */
+    createPull: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/pulls/:number` */
+    pull: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `PATCH /api/v3/repos/:owner/:repo/pulls/:number` */
+    updatePull: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `PUT /api/v3/repos/:owner/:repo/pulls/:number/merge` */
+    mergePull: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+    /** `GET /api/v3/repos/:owner/:repo/pulls/:number/files` */
+    pullFiles: () => Effect.Effect<HttpServerResponse.HttpServerResponse, never, HttpServerRequest.HttpServerRequest | HttpRouter.RouteContext | RuntimeContext>;
+};
+//# sourceMappingURL=GitHubCompat.d.ts.map

package/lib/Git/GitHubCompat.d.ts.map

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