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

package/lib/Git/Store/StreamingSource.d.ts

@@ -0,0 +1,66 @@
+/**
+ * A pack source the parser can read WHILE the body is still arriving
+ * (DESIGN §22.6). The receive-pack handler feeds request chunks in; the
+ * parser reads forward through it; nothing waits for the upload to end.
+ *
+ * - Chunks are coalesced into fixed slabs (`SLAB_BYTES`), so a read inside
+ *   one slab is a view (the parser's synchronous fast path needs views).
+ * - A read past what has arrived blocks until enough bytes exist or the
+ *   body ends; a read that cannot be satisfied at end returns short.
+ * - Retention is bounded: once the parser has consumed past a slab and the
+ *   retained total exceeds `retainBytes`, the oldest slab is dropped. A
+ *   later read below the retained window (a delta base far behind) is
+ *   served by the `fallback` reader — the spilled object, readable once the
+ *   body has ended — or fails when there is none.
+ * - Backpressure: `push` waits while more than `backpressureBytes` of
+ *   unconsumed bytes are buffered, so a slow parser throttles the upload
+ *   instead of growing memory.
+ */
+import * as Effect from "effect/Effect";
+import { StoreError } from "../Protocol/Store.ts";
+import type { RandomAccess } from "../Protocol/PackParser.ts";
+export declare const SLAB_BYTES: number;
+export declare const RETAIN_BYTES: number;
+export declare const BACKPRESSURE_BYTES: number;
+export interface StreamingSource extends RandomAccess {
+    /** Bytes received so far. */
+    readonly received: () => number;
+    /** Resolves with the total once the body has ended. */
+    readonly awaitEnd: Effect.Effect<number, StoreError>;
+    /** True once the feeder has ended the body. */
+    readonly ended: () => boolean;
+    /** The parser is done with everything below `offset`; retention may drop it. */
+    readonly release: (offset: number) => void;
+}
+export interface StreamingFeeder {
+    readonly source: StreamingSource;
+    /** Appends a chunk; waits while backpressure applies. */
+    readonly push: (chunk: Uint8Array) => Effect.Effect<void, StoreError>;
+    /**
+     * Appends without ever parking: for receivers whose consumer retains
+     * the whole body anyway (the push pump, DESIGN §22.10), backpressure
+     * buys nothing and the per-chunk Effect hop is the receive path's cost.
+     * Returns false once the source has ended or failed.
+     */
+    readonly pushSync: (chunk: Uint8Array) => boolean;
+    /** Ends the body; readers waiting past the end are woken. */
+    readonly end: () => void;
+    /**
+     * Announces that a fallback reader WILL be set (the body is being
+     * spilled): evicted reads after `end` wait for it instead of failing.
+     */
+    readonly expectFallback: () => void;
+    /** Fails every current and future read. */
+    readonly fail: (error: StoreError) => void;
+    /**
+     * Installs the reader for bytes that retention has dropped (the spilled
+     * object). Reads below the retained window wait for it and for `end`.
+     */
+    readonly setFallback: (reader: RandomAccess) => void;
+}
+export declare const makeStreamingSource: (options?: {
+    readonly retainBytes?: number | undefined;
+    readonly backpressureBytes?: number | undefined;
+    readonly slabBytes?: number | undefined;
+}) => StreamingFeeder;
+//# sourceMappingURL=StreamingSource.d.ts.map

package/lib/Git/Store/StreamingSource.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingSource.d.ts","sourceRoot":"","sources":["../../../src/Git/Store/StreamingSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAG9D,eAAO,MAAM,UAAU,QAAkB,CAAC;AAC1C,eAAO,MAAM,YAAY,QAAmB,CAAC;AAC7C,eAAO,MAAM,kBAAkB,QAAmB,CAAC;AAenD,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,MAAM,CAAC;IAChC,uDAAuD;IACvD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrD,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,MAAM,OAAO,CAAC;IAC9B,gFAAgF;IAChF,QAAQ,CAAC,OAAO,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,MAAM,EAAE,eAAe,CAAC;IACjC,yDAAyD;IACzD,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IACtE;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,OAAO,CAAC;IAClD,6DAA6D;IAC7D,QAAQ,CAAC,GAAG,EAAE,MAAM,IAAI,CAAC;IACzB;;;OAGG;IACH,QAAQ,CAAC,cAAc,EAAE,MAAM,IAAI,CAAC;IACpC,2CAA2C;IAC3C,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IAC3C;;;OAGG;IACH,QAAQ,CAAC,WAAW,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,IAAI,CAAC;CACtD;AAED,eAAO,MAAM,mBAAmB,aAAc;IAC5C,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChD,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CACzC,KAAG,eA4PH,CAAC"}

package/lib/Git/Store/StreamingSource.js

@@ -0,0 +1,274 @@
+/**
+ * A pack source the parser can read WHILE the body is still arriving
+ * (DESIGN §22.6). The receive-pack handler feeds request chunks in; the
+ * parser reads forward through it; nothing waits for the upload to end.
+ *
+ * - Chunks are coalesced into fixed slabs (`SLAB_BYTES`), so a read inside
+ *   one slab is a view (the parser's synchronous fast path needs views).
+ * - A read past what has arrived blocks until enough bytes exist or the
+ *   body ends; a read that cannot be satisfied at end returns short.
+ * - Retention is bounded: once the parser has consumed past a slab and the
+ *   retained total exceeds `retainBytes`, the oldest slab is dropped. A
+ *   later read below the retained window (a delta base far behind) is
+ *   served by the `fallback` reader — the spilled object, readable once the
+ *   body has ended — or fails when there is none.
+ * - Backpressure: `push` waits while more than `backpressureBytes` of
+ *   unconsumed bytes are buffered, so a slow parser throttles the upload
+ *   instead of growing memory.
+ */
+import * as Effect from "effect/Effect";
+import { StoreError } from "../Protocol/Store.js";
+// Slabs match the pump's part size so a part read is a view, not a copy.
+export const SLAB_BYTES = 8 * 1024 * 1024;
+export const RETAIN_BYTES = 16 * 1024 * 1024;
+export const BACKPRESSURE_BYTES = 24 * 1024 * 1024;
+export const makeStreamingSource = (options) => {
+    const slabBytes = options?.slabBytes ?? SLAB_BYTES;
+    const retainBytes = options?.retainBytes ?? RETAIN_BYTES;
+    const backpressureBytes = options?.backpressureBytes ?? BACKPRESSURE_BYTES;
+    const slabs = [];
+    let received = 0;
+    let retainFrom = 0; // first byte still in memory
+    let consumed = 0; // parser's release watermark
+    let ended = false;
+    let total;
+    let failure;
+    let fallback;
+    let fallbackExpected = false;
+    const readWaiters = [];
+    const endWaiters = [];
+    const pushWaiters = [];
+    const fallbackWaiters = [];
+    const append = (chunk) => {
+        let at = 0;
+        while (at < chunk.length) {
+            let slab = slabs[slabs.length - 1];
+            if (slab === undefined || slab.filled === slab.bytes.length) {
+                slab = { start: received, bytes: new Uint8Array(slabBytes), filled: 0 };
+                slabs.push(slab);
+            }
+            const take = Math.min(chunk.length - at, slab.bytes.length - slab.filled);
+            slab.bytes.set(chunk.subarray(at, at + take), slab.filled);
+            slab.filled += take;
+            received += take;
+            at += take;
+        }
+    };
+    const wake = () => {
+        for (let i = readWaiters.length - 1; i >= 0; i--) {
+            const w = readWaiters[i];
+            if (failure !== undefined) {
+                readWaiters.splice(i, 1);
+                w.resume(Effect.fail(failure));
+            }
+            else if (received >= w.need || ended) {
+                readWaiters.splice(i, 1);
+                w.resume(Effect.void);
+            }
+        }
+        if (ended || failure !== undefined) {
+            const ws = endWaiters.splice(0);
+            for (const w of ws) {
+                w(failure !== undefined ? Effect.fail(failure) : Effect.succeed(total));
+            }
+        }
+    };
+    /**
+     * Backpressure must never park the feeder while a reader is waiting for
+     * bytes past the buffer — that reader is the only thing that will ever
+     * consume, so parking would deadlock (a 64 KiB probe against a 1 KiB
+     * budget, or an entry larger than the budget). A waiting reader always
+     * releases the feeder.
+     */
+    const pushMayProceed = () => received - consumed <= backpressureBytes ||
+        readWaiters.length > 0 ||
+        ended ||
+        failure !== undefined;
+    const wakePush = () => {
+        if (pushMayProceed()) {
+            const ws = pushWaiters.splice(0);
+            for (const w of ws)
+                w();
+        }
+    };
+    const trim = () => {
+        // Drop whole slabs entirely below the consumed watermark once the
+        // retained total exceeds the budget.
+        while (slabs.length > 1 &&
+            received - retainFrom > retainBytes &&
+            slabs[0].start + slabs[0].filled <= consumed) {
+            const dropped = slabs.shift();
+            retainFrom = dropped.start + dropped.filled;
+        }
+    };
+    const waitFor = (need) => Effect.suspend(() => {
+        if (failure !== undefined)
+            return Effect.fail(failure);
+        if (received >= need || ended)
+            return Effect.void;
+        return Effect.callback((resume) => {
+            readWaiters.push({ need, resume });
+            wakePush(); // a waiting reader releases a parked feeder
+        });
+    });
+    const waitForFallback = Effect.suspend(() => {
+        if (failure !== undefined)
+            return Effect.fail(failure);
+        if (fallback !== undefined && ended)
+            return Effect.succeed(fallback);
+        return Effect.callback((resume) => {
+            fallbackWaiters.push(() => {
+                resume(failure !== undefined
+                    ? Effect.fail(failure)
+                    : fallback !== undefined
+                        ? Effect.succeed(fallback)
+                        : Effect.fail(new StoreError({
+                            reason: "streaming source: bytes evicted and no fallback reader",
+                        })));
+            });
+        });
+    });
+    const wakeFallback = () => {
+        // Once the body has ended, evicted reads either get the fallback reader
+        // or fail — they must never wait forever. When a fallback is expected
+        // (the spill completes after the body ends), they wait for it.
+        if (ended &&
+            (fallback !== undefined || !fallbackExpected || failure !== undefined)) {
+            const ws = fallbackWaiters.splice(0);
+            for (const w of ws)
+                w();
+        }
+    };
+    /** Assembles [offset, end) from retained slabs; a view when in one slab. */
+    const assemble = (offset, end) => {
+        let first = -1;
+        for (let i = 0; i < slabs.length; i++) {
+            const s = slabs[i];
+            if (offset >= s.start && offset < s.start + s.filled) {
+                first = i;
+                break;
+            }
+        }
+        if (first < 0)
+            return new Uint8Array(0);
+        const s0 = slabs[first];
+        if (end <= s0.start + s0.filled) {
+            return s0.bytes.subarray(offset - s0.start, end - s0.start);
+        }
+        const out = new Uint8Array(end - offset);
+        let written = 0;
+        for (let i = first; i < slabs.length && offset + written < end; i++) {
+            const s = slabs[i];
+            const from = Math.max(offset, s.start) - s.start;
+            const to = Math.min(end, s.start + s.filled) - s.start;
+            if (to <= from)
+                break;
+            out.set(s.bytes.subarray(from, to), written);
+            written += to - from;
+        }
+        return written === out.length ? out : out.subarray(0, written);
+    };
+    const source = {
+        get size() {
+            return total ?? Number.POSITIVE_INFINITY;
+        },
+        received: () => received,
+        ended: () => ended,
+        awaitEnd: Effect.suspend(() => {
+            if (failure !== undefined)
+                return Effect.fail(failure);
+            if (ended)
+                return Effect.succeed(total);
+            return Effect.callback((resume) => {
+                endWaiters.push(resume);
+            });
+        }),
+        release: (offset) => {
+            if (offset > consumed) {
+                consumed = offset;
+                trim();
+                wakePush();
+            }
+        },
+        readSync: (offset, length) => {
+            if (offset < retainFrom)
+                return undefined;
+            const end = Math.min(offset + length, received);
+            if (end <= offset)
+                return ended ? new Uint8Array(0) : undefined;
+            if (end < offset + length && !ended)
+                return undefined;
+            for (const s of slabs) {
+                if (offset >= s.start && end <= s.start + s.filled) {
+                    return s.bytes.subarray(offset - s.start, end - s.start);
+                }
+            }
+            return undefined;
+        },
+        evictedBeforeEnd: (offset) => offset < retainFrom && !ended,
+        read: (offset, length) => Effect.gen(function* () {
+            if (offset < retainFrom) {
+                const reader = yield* waitForFallback;
+                return yield* reader.read(offset, length);
+            }
+            yield* waitFor(offset + length);
+            if (offset < retainFrom) {
+                const reader = yield* waitForFallback;
+                return yield* reader.read(offset, length);
+            }
+            const end = Math.min(offset + length, received);
+            return end <= offset ? new Uint8Array(0) : assemble(offset, end);
+        }),
+    };
+    return {
+        source,
+        pushSync: (chunk) => {
+            if (failure !== undefined || ended)
+                return false;
+            append(chunk);
+            wake();
+            return true;
+        },
+        push: (chunk) => Effect.gen(function* () {
+            if (failure !== undefined)
+                return yield* Effect.fail(failure);
+            if (ended) {
+                return yield* Effect.fail(new StoreError({ reason: "streaming source: push after end" }));
+            }
+            append(chunk);
+            wake();
+            if (!pushMayProceed()) {
+                yield* Effect.callback((resume) => {
+                    pushWaiters.push(() => resume(Effect.void));
+                });
+            }
+        }),
+        expectFallback: () => {
+            fallbackExpected = true;
+        },
+        end: () => {
+            if (ended)
+                return;
+            ended = true;
+            total = received;
+            wake();
+            wakePush();
+            wakeFallback();
+        },
+        fail: (error) => {
+            if (failure !== undefined)
+                return;
+            failure = error;
+            ended = true;
+            total ??= received;
+            wake();
+            wakePush();
+            wakeFallback();
+        },
+        setFallback: (reader) => {
+            fallback = reader;
+            wakeFallback();
+        },
+    };
+};
+//# sourceMappingURL=StreamingSource.js.map

package/lib/Git/Store/StreamingSource.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StreamingSource.js","sourceRoot":"","sources":["../../../src/Git/Store/StreamingSource.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AACH,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAGlD,yEAAyE;AACzE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC;AAC1C,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAC7C,MAAM,CAAC,MAAM,kBAAkB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC;AAqDnD,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,OAInC,EAAmB,EAAE;IACpB,MAAM,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,UAAU,CAAC;IACnD,MAAM,WAAW,GAAG,OAAO,EAAE,WAAW,IAAI,YAAY,CAAC;IACzD,MAAM,iBAAiB,GAAG,OAAO,EAAE,iBAAiB,IAAI,kBAAkB,CAAC;IAC3E,MAAM,KAAK,GAAgB,EAAE,CAAC;IAC9B,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,UAAU,GAAG,CAAC,CAAC,CAAC,6BAA6B;IACjD,IAAI,QAAQ,GAAG,CAAC,CAAC,CAAC,6BAA6B;IAC/C,IAAI,KAAK,GAAG,KAAK,CAAC;IAClB,IAAI,KAAyB,CAAC;IAC9B,IAAI,OAA+B,CAAC;IACpC,IAAI,QAAkC,CAAC;IACvC,IAAI,gBAAgB,GAAG,KAAK,CAAC;IAC7B,MAAM,WAAW,GAAkB,EAAE,CAAC;IACtC,MAAM,UAAU,GAA0D,EAAE,CAAC;IAC7E,MAAM,WAAW,GAAsB,EAAE,CAAC;IAC1C,MAAM,eAAe,GAAsB,EAAE,CAAC;IAE9C,MAAM,MAAM,GAAG,CAAC,KAAiB,EAAE,EAAE;QACnC,IAAI,EAAE,GAAG,CAAC,CAAC;QACX,OAAO,EAAE,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;YACzB,IAAI,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;YACnC,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC;gBAC5D,IAAI,GAAG,EAAE,KAAK,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC;gBACxE,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACnB,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1E,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;YAC3D,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC;YACpB,QAAQ,IAAI,IAAI,CAAC;YACjB,EAAE,IAAI,IAAI,CAAC;QACb,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,KAAK,IAAI,CAAC,GAAG,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACjD,MAAM,CAAC,GAAG,WAAW,CAAC,CAAC,CAAE,CAAC;YAC1B,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;gBAC1B,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;YACjC,CAAC;iBAAM,IAAI,QAAQ,IAAI,CAAC,CAAC,IAAI,IAAI,KAAK,EAAE,CAAC;gBACvC,WAAW,CAAC,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzB,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YACxB,CAAC;QACH,CAAC;QACD,IAAI,KAAK,IAAI,OAAO,KAAK,SAAS,EAAE,CAAC;YACnC,MAAM,EAAE,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YAChC,KAAK,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBACnB,CAAC,CACC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,KAAM,CAAC,CACtE,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC,CAAC;IACF;;;;;;OAMG;IACH,MAAM,cAAc,GAAG,GAAG,EAAE,CAC1B,QAAQ,GAAG,QAAQ,IAAI,iBAAiB;QACxC,WAAW,CAAC,MAAM,GAAG,CAAC;QACtB,KAAK;QACL,OAAO,KAAK,SAAS,CAAC;IACxB,MAAM,QAAQ,GAAG,GAAG,EAAE;QACpB,IAAI,cAAc,EAAE,EAAE,CAAC;YACrB,MAAM,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACjC,KAAK,MAAM,CAAC,IAAI,EAAE;gBAAE,CAAC,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IACF,MAAM,IAAI,GAAG,GAAG,EAAE;QAChB,kEAAkE;QAClE,qCAAqC;QACrC,OACE,KAAK,CAAC,MAAM,GAAG,CAAC;YAChB,QAAQ,GAAG,UAAU,GAAG,WAAW;YACnC,KAAK,CAAC,CAAC,CAAE,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC,MAAM,IAAI,QAAQ,EAC9C,CAAC;YACD,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,EAAG,CAAC;YAC/B,UAAU,GAAG,OAAO,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC;QAC9C,CAAC;IACH,CAAC,CAAC;IACF,MAAM,OAAO,GAAG,CAAC,IAAY,EAAmC,EAAE,CAChE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,QAAQ,IAAI,IAAI,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC;QAClD,OAAO,MAAM,CAAC,QAAQ,CAAmB,CAAC,MAAM,EAAE,EAAE;YAClD,WAAW,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;YACnC,QAAQ,EAAE,CAAC,CAAC,4CAA4C;QAC1D,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACL,MAAM,eAAe,GACnB,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;QAClB,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACvD,IAAI,QAAQ,KAAK,SAAS,IAAI,KAAK;YAAE,OAAO,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC;QACrE,OAAO,MAAM,CAAC,QAAQ,CAA2B,CAAC,MAAM,EAAE,EAAE;YAC1D,eAAe,CAAC,IAAI,CAAC,GAAG,EAAE;gBACxB,MAAM,CACJ,OAAO,KAAK,SAAS;oBACnB,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC;oBACtB,CAAC,CAAC,QAAQ,KAAK,SAAS;wBACtB,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC;wBAC1B,CAAC,CAAC,MAAM,CAAC,IAAI,CACT,IAAI,UAAU,CAAC;4BACb,MAAM,EACJ,wDAAwD;yBAC3D,CAAC,CACH,CACR,CAAC;YACJ,CAAC,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACL,MAAM,YAAY,GAAG,GAAG,EAAE;QACxB,wEAAwE;QACxE,sEAAsE;QACtE,+DAA+D;QAC/D,IACE,KAAK;YACL,CAAC,QAAQ,KAAK,SAAS,IAAI,CAAC,gBAAgB,IAAI,OAAO,KAAK,SAAS,CAAC,EACtE,CAAC;YACD,MAAM,EAAE,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;YACrC,KAAK,MAAM,CAAC,IAAI,EAAE;gBAAE,CAAC,EAAE,CAAC;QAC1B,CAAC;IACH,CAAC,CAAC;IAEF,4EAA4E;IAC5E,MAAM,QAAQ,GAAG,CAAC,MAAc,EAAE,GAAW,EAAc,EAAE;QAC3D,IAAI,KAAK,GAAG,CAAC,CAAC,CAAC;QACf,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;YACtC,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACpB,IAAI,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,MAAM,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;gBACrD,KAAK,GAAG,CAAC,CAAC;gBACV,MAAM;YACR,CAAC;QACH,CAAC;QACD,IAAI,KAAK,GAAG,CAAC;YAAE,OAAO,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC;QACxC,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAE,CAAC;QACzB,IAAI,GAAG,IAAI,EAAE,CAAC,KAAK,GAAG,EAAE,CAAC,MAAM,EAAE,CAAC;YAChC,OAAO,EAAE,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,EAAE,CAAC,KAAK,EAAE,GAAG,GAAG,EAAE,CAAC,KAAK,CAAC,CAAC;QAC9D,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,GAAG,GAAG,MAAM,CAAC,CAAC;QACzC,IAAI,OAAO,GAAG,CAAC,CAAC;QAChB,KAAK,IAAI,CAAC,GAAG,KAAK,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,IAAI,MAAM,GAAG,OAAO,GAAG,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC;YACpE,MAAM,CAAC,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YACjD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC;YACvD,IAAI,EAAE,IAAI,IAAI;gBAAE,MAAM;YACtB,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,EAAE,OAAO,CAAC,CAAC;YAC7C,OAAO,IAAI,EAAE,GAAG,IAAI,CAAC;QACvB,CAAC;QACD,OAAO,OAAO,KAAK,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;IACjE,CAAC,CAAC;IAEF,MAAM,MAAM,GAAoB;QAC9B,IAAI,IAAI;YACN,OAAO,KAAK,IAAI,MAAM,CAAC,iBAAiB,CAAC;QAC3C,CAAC;QACD,QAAQ,EAAE,GAAG,EAAE,CAAC,QAAQ;QACxB,KAAK,EAAE,GAAG,EAAE,CAAC,KAAK;QAClB,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,EAAE;YAC5B,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACvD,IAAI,KAAK;gBAAE,OAAO,MAAM,CAAC,OAAO,CAAC,KAAM,CAAC,CAAC;YACzC,OAAO,MAAM,CAAC,QAAQ,CAAqB,CAAC,MAAM,EAAE,EAAE;gBACpD,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YAC1B,CAAC,CAAC,CAAC;QACL,CAAC,CAAC;QACF,OAAO,EAAE,CAAC,MAAM,EAAE,EAAE;YAClB,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;gBACtB,QAAQ,GAAG,MAAM,CAAC;gBAClB,IAAI,EAAE,CAAC;gBACP,QAAQ,EAAE,CAAC;YACb,CAAC;QACH,CAAC;QACD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE;YAC3B,IAAI,MAAM,GAAG,UAAU;gBAAE,OAAO,SAAS,CAAC;YAC1C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChD,IAAI,GAAG,IAAI,MAAM;gBAAE,OAAO,KAAK,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAChE,IAAI,GAAG,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,KAAK;gBAAE,OAAO,SAAS,CAAC;YACtD,KAAK,MAAM,CAAC,IAAI,KAAK,EAAE,CAAC;gBACtB,IAAI,MAAM,IAAI,CAAC,CAAC,KAAK,IAAI,GAAG,IAAI,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,MAAM,EAAE,CAAC;oBACnD,OAAO,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,KAAK,EAAE,GAAG,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;gBAC3D,CAAC;YACH,CAAC;YACD,OAAO,SAAS,CAAC;QACnB,CAAC;QACD,gBAAgB,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,GAAG,UAAU,IAAI,CAAC,KAAK;QAC3D,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,CACvB,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;gBACtC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;YACD,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;YAChC,IAAI,MAAM,GAAG,UAAU,EAAE,CAAC;gBACxB,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC;gBACtC,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;YAC5C,CAAC;YACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,MAAM,EAAE,QAAQ,CAAC,CAAC;YAChD,OAAO,GAAG,IAAI,MAAM,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;QACnE,CAAC,CAAC;KACL,CAAC;IAEF,OAAO;QACL,MAAM;QACN,QAAQ,EAAE,CAAC,KAAK,EAAE,EAAE;YAClB,IAAI,OAAO,KAAK,SAAS,IAAI,KAAK;gBAAE,OAAO,KAAK,CAAC;YACjD,MAAM,CAAC,KAAK,CAAC,CAAC;YACd,IAAI,EAAE,CAAC;YACP,OAAO,IAAI,CAAC;QACd,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE,CACd,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;YAClB,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YAC9D,IAAI,KAAK,EAAE,CAAC;gBACV,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,IAAI,CACvB,IAAI,UAAU,CAAC,EAAE,MAAM,EAAE,kCAAkC,EAAE,CAAC,CAC/D,CAAC;YACJ,CAAC;YACD,MAAM,CAAC,KAAK,CAAC,CAAC;YACd,IAAI,EAAE,CAAC;YACP,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC;gBACtB,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAO,CAAC,MAAM,EAAE,EAAE;oBACtC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC9C,CAAC,CAAC,CAAC;YACL,CAAC;QACH,CAAC,CAAC;QACJ,cAAc,EAAE,GAAG,EAAE;YACnB,gBAAgB,GAAG,IAAI,CAAC;QAC1B,CAAC;QACD,GAAG,EAAE,GAAG,EAAE;YACR,IAAI,KAAK;gBAAE,OAAO;YAClB,KAAK,GAAG,IAAI,CAAC;YACb,KAAK,GAAG,QAAQ,CAAC;YACjB,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;QACjB,CAAC;QACD,IAAI,EAAE,CAAC,KAAK,EAAE,EAAE;YACd,IAAI,OAAO,KAAK,SAAS;gBAAE,OAAO;YAClC,OAAO,GAAG,KAAK,CAAC;YAChB,KAAK,GAAG,IAAI,CAAC;YACb,KAAK,KAAK,QAAQ,CAAC;YACnB,IAAI,EAAE,CAAC;YACP,QAAQ,EAAE,CAAC;YACX,YAAY,EAAE,CAAC;QACjB,CAAC;QACD,WAAW,EAAE,CAAC,MAAM,EAAE,EAAE;YACtB,QAAQ,GAAG,MAAM,CAAC;YAClB,YAAY,EAAE,CAAC;QACjB,CAAC;KACF,CAAC;AACJ,CAAC,CAAC"}

package/lib/Git/index.d.ts

@@ -0,0 +1,39 @@
+/**
+ * alchemy/Git — a Git hosting service on Cloudflare Workers,
+ * Durable Objects, and R2, built with Alchemy Effect-native Workers.
+ *
+ * Public surface:
+ * - The HTTP contract ({@link GitApi}, aliased {@link Api}): every plane as
+ *   one `HttpApi`, each endpoint an `HttpApiEndpoint`, each group a
+ *   class, with the schemas and tagged errors.
+ * - {@link Handlers} and {@link ApiHandlersLive}: shared handler implementations.
+ *   {@link ApiLive} registers public routes; merge it beside application routes.
+ *   {@link GroupsLive} exposes native group implementations for overrides.
+ * - {@link Engine}: transport-independent operations, with scoped prepare/commit
+ *   for application authorization and validation. HTTP codecs live in `alchemy/Git/Http`.
+ * - The deployable pieces: {@link ApiLive} + {@link InternalApiLive}, the
+ *   {@link GitRepo} / {@link Registry} Durable Objects, and the storage and
+ *   hasher blocks.
+ *
+ * Internals (wire-protocol codecs under `Protocol/`, storage under `Store/`,
+ * alarm jobs under `Jobs/`) are deliberately not re-exported here — deep
+ * import them via `alchemy/Git/Protocol/Pkt.ts` style paths when
+ * needed.
+ */
+export * from "./Api.ts";
+export { GitApi as Api } from "./Api.ts";
+export { Engine, EngineLive } from "./Engine.ts";
+export type { PushInput, PreparedPush, RefUpdate } from "./Push.ts";
+export * as Http from "./Http.ts";
+export * as Push from "./PushInput.ts";
+export * from "./Server.ts";
+export { parseCommit, parseTree, ZERO_OID, ObjectType, } from "./Protocol/ObjectCodec.ts";
+export { StoreError } from "./Protocol/Store.ts";
+export { WireProtocolError, PackIngestError } from "./RepoObject.ts";
+export { BlobStore, BlobStoreR2, BlobStoreError, type BlobBody, type BlobMeta, type BlobMultipart, type BlobStoreShape, } from "./BlobStore.ts";
+export { BlobStoreS3 } from "./BlobStoreS3.ts";
+export { RegistryD1 } from "./RegistryD1.ts";
+export { GitRepo, GitRepoLive, MAX_PACK_BYTES, type CommitPushInput, type CommitPushResult, type GitRepoShape, type RepoMetaData, RepoStore, type RepoStoreShape, type RepoStub, } from "./RepoObject.ts";
+export { Registry, RegistryDurableObject, RegistryLive, RegistryStore, REGISTRY_DO_NAME, RESERVED_OWNERS, } from "./RegistryObject.ts";
+export { Hasher, HasherInline, HasherSelf, HASHER_BINDING, } from "./Hasher/Hasher.ts";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/Git/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACjD,YAAY,EAAE,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACpE,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,WAAW,EACX,cAAc,EACd,KAAK,QAAQ,EACb,KAAK,QAAQ,EACb,KAAK,aAAa,EAClB,KAAK,cAAc,GACpB,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,OAAO,EACP,WAAW,EACX,cAAc,EACd,KAAK,eAAe,EACpB,KAAK,gBAAgB,EACrB,KAAK,YAAY,EACjB,KAAK,YAAY,EACjB,SAAS,EACT,KAAK,cAAc,EACnB,KAAK,QAAQ,GACd,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/lib/Git/index.js

@@ -0,0 +1,38 @@
+/**
+ * alchemy/Git — a Git hosting service on Cloudflare Workers,
+ * Durable Objects, and R2, built with Alchemy Effect-native Workers.
+ *
+ * Public surface:
+ * - The HTTP contract ({@link GitApi}, aliased {@link Api}): every plane as
+ *   one `HttpApi`, each endpoint an `HttpApiEndpoint`, each group a
+ *   class, with the schemas and tagged errors.
+ * - {@link Handlers} and {@link ApiHandlersLive}: shared handler implementations.
+ *   {@link ApiLive} registers public routes; merge it beside application routes.
+ *   {@link GroupsLive} exposes native group implementations for overrides.
+ * - {@link Engine}: transport-independent operations, with scoped prepare/commit
+ *   for application authorization and validation. HTTP codecs live in `alchemy/Git/Http`.
+ * - The deployable pieces: {@link ApiLive} + {@link InternalApiLive}, the
+ *   {@link GitRepo} / {@link Registry} Durable Objects, and the storage and
+ *   hasher blocks.
+ *
+ * Internals (wire-protocol codecs under `Protocol/`, storage under `Store/`,
+ * alarm jobs under `Jobs/`) are deliberately not re-exported here — deep
+ * import them via `alchemy/Git/Protocol/Pkt.ts` style paths when
+ * needed.
+ */
+export * from "./Api.js";
+export { GitApi as Api } from "./Api.js";
+export { Engine, EngineLive } from "./Engine.js";
+export * as Http from "./Http.js";
+export * as Push from "./PushInput.js";
+export * from "./Server.js";
+export { parseCommit, parseTree, ZERO_OID, ObjectType, } from "./Protocol/ObjectCodec.js";
+export { StoreError } from "./Protocol/Store.js";
+export { WireProtocolError, PackIngestError } from "./RepoObject.js";
+export { BlobStore, BlobStoreR2, BlobStoreError, } from "./BlobStore.js";
+export { BlobStoreS3 } from "./BlobStoreS3.js";
+export { RegistryD1 } from "./RegistryD1.js";
+export { GitRepo, GitRepoLive, MAX_PACK_BYTES, RepoStore, } from "./RepoObject.js";
+export { Registry, RegistryDurableObject, RegistryLive, RegistryStore, REGISTRY_DO_NAME, RESERVED_OWNERS, } from "./RegistryObject.js";
+export { Hasher, HasherInline, HasherSelf, HASHER_BINDING, } from "./Hasher/Hasher.js";
+//# sourceMappingURL=index.js.map

package/lib/Git/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/Git/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,cAAc,UAAU,CAAC;AACzB,OAAO,EAAE,MAAM,IAAI,GAAG,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEjD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAClC,OAAO,KAAK,IAAI,MAAM,gBAAgB,CAAC;AACvC,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,WAAW,EACX,SAAS,EACT,QAAQ,EACR,UAAU,GACX,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AACrE,OAAO,EACL,SAAS,EACT,WAAW,EACX,cAAc,GAKf,MAAM,gBAAgB,CAAC;AACxB,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAC/C,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAC7C,OAAO,EACL,OAAO,EACP,WAAW,EACX,cAAc,EAKd,SAAS,GAGV,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,QAAQ,EACR,qBAAqB,EACrB,YAAY,EACZ,aAAa,EACb,gBAAgB,EAChB,eAAe,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,MAAM,EACN,YAAY,EACZ,UAAU,EACV,cAAc,GACf,MAAM,oBAAoB,CAAC"}

package/lib/GitHub/AuthProvider.d.ts

@@ -1,22 +1,19 @@
 import * as Effect from "effect/Effect";
 import * as Redacted from "effect/Redacted";
+import * as Schema from "effect/Schema";
 import { ChildProcessSpawner } from "effect/unstable/process/ChildProcessSpawner";
 import { AuthError } from "../Auth/AuthProvider.ts";
-import { CredentialsStore } from "../Auth/Credentials.ts";
-export type GitHubAuthConfig = {
-    method: "env";
-    baseUrl?: string;
-} | {
-    method: "stored";
-    baseUrl?: string;
-} | {
-    method: "gh-cli";
-    baseUrl?: string;
-};
-export interface GitHubStoredCredentials {
-    type: "pat";
-    token: string;
-}
+/** Typed values stored in a GitHub provider profile document. */
+export declare const GitHubAuthConfigSchema: Schema.Union<readonly [Schema.Struct<{
+    readonly method: Schema.Literal<"stored">;
+    readonly token: Schema.String;
+    readonly baseUrl: Schema.optionalKey<Schema.String>;
+}>, Schema.Struct<{
+    readonly method: Schema.Literal<"gh-cli">;
+    readonly token: Schema.optionalKey<Schema.String>;
+    readonly baseUrl: Schema.optionalKey<Schema.String>;
+}>]>;
+export type GitHubAuthConfig = typeof GitHubAuthConfigSchema.Type;
 export interface GitHubResolvedCredentials {
     type: "token";
     token: Redacted.Redacted<string>;
@@ -27,30 +24,24 @@ export interface GitHubResolvedCredentials {
      */
     baseUrl?: string;
     source: {
-        type: GitHubAuthConfig["method"];
+        type: GitHubAuthConfig["method"] | "env";
         details?: string;
     };
 }
 export declare const GITHUB_AUTH_PROVIDER_NAME = "GitHub";
-/**
- * Read GitHub credentials from the environment. The base URL comes from the
- * stored config when set, otherwise from `GITHUB_BASE_URL`, `GITHUB_API_URL`,
- * or `GH_HOST`.
- */
+/** Resolve standalone GitHub credentials from environment variables. */
 export declare const readEnvCredentials: (configBaseUrl?: string) => Effect.Effect<GitHubResolvedCredentials, AuthError>;
 /**
  * Build the Layer that registers the GitHub {@link AuthProvider} into the
  * {@link AuthProviders} registry. Included in the GitHub `providers()` layer
- * so `alchemy login` can discover it.
+ * so the alchemy CLI can discover it.
  *
  * Supported methods:
  * - `gh-cli`: shells out to `gh auth token` (recommended).
- * - `env`: reads `GITHUB_ACCESS_TOKEN` or `GITHUB_TOKEN` (plus
- *   `GH_ENTERPRISE_TOKEN` / `GITHUB_ENTERPRISE_TOKEN` on enterprise hosts).
- * - `stored`: prompts for a PAT and writes it to `~/.alchemy/credentials`.
+ * - `stored`: prompts for a PAT and stores it inline in the provider file.
  *
  * GitHub Enterprise (Server or Cloud with data residency) is supported by
- * every method: `alchemy login --configure` prompts for the host, or set
+ * every method: `alchemy profile edit --reconfigure GitHub` prompts for the host, or set
  * `GITHUB_BASE_URL` / `GITHUB_API_URL` / `GH_HOST` in the environment. The
  * host is normalized into the REST API base URL passed to Octokit, and
  * `gh auth token` is invoked with `--hostname` so the CLI returns the token
@@ -65,17 +56,17 @@ export interface GitHubAuthOptions {
      * Hard-code the GitHub host or API base URL (e.g. `github.example.com`
      * or `https://github.example.com/api/v3`). When set, it takes precedence
      * over the profile's configured host and the environment for every auth
-     * method, `alchemy login` stops prompting for a host, and the `gh` CLI
+     * method, the configure flow stops prompting for a host, and the `gh` CLI
      * method authenticates against this host. `GitHub.providers({ baseUrl })`
      * threads its option here.
      */
     readonly baseUrl?: string;
 }
-export declare const makeGitHubAuth: (authOptions?: GitHubAuthOptions) => import("effect/Layer").Layer<never, never, import("../index.ts").AuthProviders | ChildProcessSpawner | CredentialsStore>;
+export declare const makeGitHubAuth: (authOptions?: GitHubAuthOptions) => import("effect/Layer").Layer<never, never, import("../index.ts").AuthProviders | ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
 /**
  * The default GitHub AuthProvider layer — {@link makeGitHubAuth} with no
  * hard-coded host. Use `GitHub.providers({ baseUrl })` (or
  * `makeGitHubAuth({ baseUrl })` directly) to pin a GitHub Enterprise host.
  */
-export declare const GitHubAuth: import("effect/Layer").Layer<never, never, import("../index.ts").AuthProviders | ChildProcessSpawner | CredentialsStore>;
+export declare const GitHubAuth: import("effect/Layer").Layer<never, never, import("../index.ts").AuthProviders | ChildProcessSpawner | import("effect/FileSystem").FileSystem | import("effect/Path").Path>;
 //# sourceMappingURL=AuthProvider.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"AuthProvider.d.ts","sourceRoot":"","sources":["../../src/GitHub/AuthProvider.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAG5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EACL,SAAS,EAGV,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,gBAAgB,EAAmB,MAAM,wBAAwB,CAAC;AA+B3E,MAAM,MAAM,gBAAgB,GACxB;IAAE,MAAM,EAAE,KAAK,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACnC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,GACtC;IAAE,MAAM,EAAE,QAAQ,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE3C,MAAM,WAAW,uBAAuB;IACtC,IAAI,EAAE,KAAK,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;CACf;AAED,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAChE;AAED,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAyClD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,mBACb,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,SAAS,CAIjD,CAAC;AAEL;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,iBAAkB,iBAAiB,6HAyS3D,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,UAAU,0HAAmB,CAAC"}
+{"version":3,"file":"AuthProvider.d.ts","sourceRoot":"","sources":["../../src/GitHub/AuthProvider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAExC,OAAO,KAAK,QAAQ,MAAM,iBAAiB,CAAC;AAC5C,OAAO,KAAK,MAAM,MAAM,eAAe,CAAC;AAGxC,OAAO,EAAE,mBAAmB,EAAE,MAAM,6CAA6C,CAAC;AAClF,OAAO,EACL,SAAS,EAOV,MAAM,yBAAyB,CAAC;AAgCjC,iEAAiE;AACjE,eAAO,MAAM,sBAAsB;;;;;;;;IAcjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,OAAO,sBAAsB,CAAC,IAAI,CAAC;AAElE,MAAM,WAAW,yBAAyB;IACxC,IAAI,EAAE,OAAO,CAAC;IACd,KAAK,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IACjC;;;;OAIG;IACH,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE;QAAE,IAAI,EAAE,gBAAgB,CAAC,QAAQ,CAAC,GAAG,KAAK,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CACxE;AAED,eAAO,MAAM,yBAAyB,WAAW,CAAC;AAmClD,wEAAwE;AACxE,eAAO,MAAM,kBAAkB,mBACb,MAAM,KACrB,MAAM,CAAC,MAAM,CAAC,yBAAyB,EAAE,SAAS,CAIjD,CAAC;AAEL;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,WAAW,iBAAiB;IAChC;;;;;;;OAOG;IACH,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,eAAO,MAAM,cAAc,iBAAkB,iBAAiB,gLA2X3D,CAAC;AAEJ;;;;GAIG;AACH,eAAO,MAAM,UAAU,6KAAmB,CAAC"}