@shivaedev/github 0.0.0 → 0.5.1

package/dist/rateLimits.js

@@ -0,0 +1,43 @@
+import { Clock, DateTime, Effect } from "effect";
+export function rateLimits() {
+    const observations = new Map();
+    const blocked = new Map();
+    const failures = new Map();
+    const resources = new Map();
+    function resource(path) {
+        return resources.get(path) ?? (path.startsWith("/search/") ? "search" : "core");
+    }
+    return {
+        blocked,
+        failures,
+        observations,
+        observe(response) {
+            const headers = response.headers;
+            const path = new URL(response.request.url).pathname;
+            const name = headers["x-ratelimit-resource"] ?? resource(path);
+            resources.set(path, name);
+            const values = ["limit", "remaining", "used", "reset"].map((key) => headers[`x-ratelimit-${key}`]);
+            if (values.every((value) => value !== undefined && Number.isFinite(Number(value)))) {
+                observations.set(name, {
+                    limit: Number(headers["x-ratelimit-limit"]),
+                    remaining: Number(headers["x-ratelimit-remaining"]),
+                    reset: DateTime.makeUnsafe(Number(headers["x-ratelimit-reset"]) * 1000),
+                    resource: name,
+                    used: Number(headers["x-ratelimit-used"]),
+                });
+            }
+            return name;
+        },
+        resource,
+    };
+}
+export const failRateLimited = Effect.fnUntraced(function* (path, error, remaining) {
+    const fields = { path, remaining, resource: error.resource, retryAt: DateTime.formatIso(error.retryAt) };
+    yield* Effect.logWarning("GitHub rate limited", fields);
+    const span = yield* Effect.currentSpan.pipe(Effect.option);
+    if (span._tag === "Some") {
+        span.value.event("GitHub.rateLimited", yield* Clock.currentTimeNanos, fields);
+    }
+    return yield* error;
+});
+//# sourceMappingURL=rateLimits.js.map

package/dist/rateLimits.js.map

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

package/dist/representations.d.ts

@@ -0,0 +1,18 @@
+import { Effect, Stream } from "effect";
+import { HttpClientRequest } from "effect/http";
+import type { ServiceUnavailable } from "@shivaedev/errors/taxonomy.ts";
+import type { requests } from "#requests.ts";
+export declare function representations(apiUrl: string, request: ReturnType<typeof requests>, resource: (path: string) => string, responseByteLimit?: number): {
+    get: (path: string, accept?: string) => HttpClientRequest.HttpClientRequest;
+    list: (path: string, beforeRequest?: (resource: string) => Effect.Effect<void, ServiceUnavailable>, byteLimit?: number) => Effect.Effect<Stream.Stream<{
+        decode: <TSchema extends import("effect/Schema").Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], import("effect/Schema").SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubConversationLocked | import("./errors.ts").GitHubPermissionDenied | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/http/errors.ts").PaginationLinkError | import("@shivaedev/http/errors.ts").ResponseBodyTooLarge | ServiceUnavailable | import("@shivaedev/http/errors.ts").RemoteStatusError, never>, never, never>;
+    read: (path: string, byteLimit?: number) => Effect.Effect<{
+        decode: <TSchema extends import("effect/Schema").Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], import("effect/Schema").SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubConversationLocked | import("./errors.ts").GitHubPermissionDenied | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/http/errors.ts").ResponseBodyTooLarge | import("@shivaedev/http/errors.ts").RemoteStatusError, never>;
+    write: (method: "POST" | "PATCH", path: string, body: unknown, byteLimit?: number) => Effect.Effect<{
+        decode: <TSchema extends import("effect/Schema").Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], import("effect/Schema").SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubConversationLocked | import("./errors.ts").GitHubPermissionDenied | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/http/errors.ts").ResponseBodyTooLarge | import("@shivaedev/http/errors.ts").RemoteStatusError, never>;
+};
+export type Representations = Omit<ReturnType<typeof representations>, "get">;
+//# sourceMappingURL=representations.d.ts.map

package/dist/representations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"representations.d.ts","sourceRoot":"","sources":["../src/representations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAc,iBAAiB,EAA2B,MAAM,aAAa,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAIxE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAE7C,wBAAgB,eAAe,CAC9B,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,UAAU,CAAC,OAAO,QAAQ,CAAC,EACpC,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,EAClC,iBAAiB,SAAc;gBAEZ,MAAM;iBAOlB,MAAM,kBACI,CAAC,QAAQ,EAAE,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC;;;iBAL5C,MAAM;;;oBA6BH,MAAM,GAAG,OAAO,QAAQ,MAAM,QAAQ,OAAO;;;EAQlF;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,UAAU,CAAC,OAAO,eAAe,CAAC,EAAE,KAAK,CAAC,CAAC"}

package/dist/representations.js

@@ -0,0 +1,28 @@
+import { Effect, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/http";
+import { paginate } from "@shivaedev/http/paginate.ts";
+import { jsonResponse } from "#json.ts";
+export function representations(apiUrl, request, resource, responseByteLimit = 1024 * 1024) {
+    function get(path, accept = "application/vnd.github+json") {
+        return HttpClientRequest.get(new URL(path, apiUrl).href, { headers: { Accept: accept } });
+    }
+    function readRepresentation(path, byteLimit = responseByteLimit) {
+        return Effect.map(request(get(path), byteLimit), jsonResponse);
+    }
+    function listRepresentations(path, beforeRequest, byteLimit = responseByteLimit) {
+        const entries = new WeakMap();
+        function fetchPage(input) {
+            return (beforeRequest?.(resource(new URL(input.url).pathname)) ?? Effect.void).pipe(Effect.andThen(request(input, byteLimit)), Effect.map((entry) => {
+                entries.set(entry.response, entry);
+                return entry.response;
+            }));
+        }
+        const client = HttpClient.makeWith((effect) => Effect.flatMap(effect, fetchPage), Effect.succeed);
+        return Effect.succeed(paginate(client, get(path)).pipe(Stream.mapEffect((response) => Effect.fromNullishOr(entries.get(response))), Stream.map(jsonResponse)));
+    }
+    function writeRepresentation(method, path, body, byteLimit = responseByteLimit) {
+        return HttpClientRequest.make(method)(new URL(path, apiUrl).href, { headers: { Accept: "application/vnd.github+json" } }).pipe(HttpClientRequest.bodyJson(body), Effect.flatMap((input) => request(input, byteLimit)), Effect.map(jsonResponse));
+    }
+    return { get, list: listRepresentations, read: readRepresentation, write: writeRepresentation };
+}
+//# sourceMappingURL=representations.js.map

package/dist/representations.js.map

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

package/dist/requests.d.ts

@@ -0,0 +1,10 @@
+import { Effect } from "effect";
+import { type HttpClient, HttpClientRequest } from "effect/http";
+import { ResponseBodyTooLarge } from "@shivaedev/http/errors.ts";
+import { type CachedResponse } from "./cache.ts";
+import { GitHubTransportError } from "./errors.ts";
+import type { GitHubToken } from "./GitHubToken.ts";
+import type { RateLimits } from "./rateLimits.ts";
+import type { TokenRefresh } from "./TokenRefresh.ts";
+export declare function requests(client: HttpClient.HttpClient, token: GitHubToken["Service"], rates: RateLimits, refresh?: typeof TokenRefresh.Service): (input: HttpClientRequest.HttpClientRequest, limit: number) => Effect.Effect<CachedResponse, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubConversationLocked | import("./errors.ts").GitHubPermissionDenied | import("./errors.ts").GitHubRateLimited | GitHubTransportError | ResponseBodyTooLarge | import("@shivaedev/http/errors.ts").RemoteStatusError, never>;
+//# sourceMappingURL=requests.d.ts.map

package/dist/requests.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.d.ts","sourceRoot":"","sources":["../src/requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEjE,OAAO,EAAE,KAAK,cAAc,EAAiB,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACpD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAElD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,wBAAgB,QAAQ,CACvB,MAAM,EAAE,UAAU,CAAC,UAAU,EAC7B,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAC7B,KAAK,EAAE,UAAU,EACjB,OAAO,GAAE,OAAO,YAAY,CAAC,OAAmB,6XA2BhD"}

package/dist/requests.js

@@ -0,0 +1,34 @@
+import { Effect } from "effect";
+import { HttpClientRequest } from "effect/http";
+import { readBoundedBody } from "@shivaedev/http/body.ts";
+import { ResponseBodyTooLarge } from "@shivaedev/http/errors.ts";
+import { authenticatedRequest } from "./authenticatedRequest.js";
+import { responseCache } from "./cache.js";
+import { GitHubTransportError } from "./errors.js";
+import { isUnchanged } from "./status.js";
+export function requests(client, token, rates, refresh = undefined) {
+    const cache = responseCache();
+    const send = authenticatedRequest(client, token, rates, refresh);
+    return Effect.fn("GitHub.request")(function* (input, limit) {
+        const key = `${input.url} ${input.headers.accept}`;
+        const cached = input.method === "GET" ? cache.get(key) : undefined;
+        let request = HttpClientRequest.removeHeader(input, "if-none-match");
+        if (cached?.response.headers.etag !== undefined) {
+            request = HttpClientRequest.setHeader(request, "If-None-Match", cached.response.headers.etag);
+        }
+        const response = yield* send(request, cached === undefined ? undefined : "revalidate");
+        if (isUnchanged(response) && cached !== undefined) {
+            if (cached.bytes.byteLength > limit) {
+                return yield* new ResponseBodyTooLarge({ limit });
+            }
+            return cached;
+        }
+        const bytes = yield* readBoundedBody(response, limit).pipe(Effect.catchTag("HttpClientError", () => Effect.fail(new GitHubTransportError({ path: new URL(input.url).pathname }))));
+        const entry = { bytes, decoded: new Map(), response };
+        if (input.method === "GET" && response.headers.etag !== undefined) {
+            cache.set(key, entry);
+        }
+        return entry;
+    });
+}
+//# sourceMappingURL=requests.js.map

package/dist/requests.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"requests.js","sourceRoot":"","sources":["../src/requests.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChC,OAAO,EAAmB,iBAAiB,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAuB,aAAa,EAAE,MAAM,YAAY,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AAGnD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,MAAM,UAAU,QAAQ,CACvB,MAA6B,EAC7B,KAA6B,EAC7B,KAAiB,EACjB,OAAO,GAAgC,SAAS;IAEhD,MAAM,KAAK,GAAG,aAAa,EAAE,CAAC;IAC9B,MAAM,IAAI,GAAG,oBAAoB,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC,EAAE,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,EAAE,KAA0C,EAAE,KAAa;QACtG,MAAM,GAAG,GAAG,GAAG,KAAK,CAAC,GAAG,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;QACnD,MAAM,MAAM,GAAG,KAAK,CAAC,MAAM,KAAK,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QACnE,IAAI,OAAO,GAAG,iBAAiB,CAAC,YAAY,CAAC,KAAK,EAAE,eAAe,CAAC,CAAC;QACrE,IAAI,MAAM,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACjD,OAAO,GAAG,iBAAiB,CAAC,SAAS,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC/F,CAAC;QACD,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC;QACvF,IAAI,WAAW,CAAC,QAAQ,CAAC,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACnD,IAAI,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,KAAK,EAAE,CAAC;gBACrC,OAAO,KAAK,CAAC,CAAC,IAAI,oBAAoB,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;YACnD,CAAC;YACD,OAAO,MAAM,CAAC;QACf,CAAC;QACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,eAAe,CAAC,QAAQ,EAAE,KAAK,CAAC,CAAC,IAAI,CACzD,MAAM,CAAC,QAAQ,CAAC,iBAAiB,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,oBAAoB,CAAC,EAAE,IAAI,EAAE,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CACtH,CAAC;QACF,MAAM,KAAK,GAAmB,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,GAAG,EAAE,EAAE,QAAQ,EAAE,CAAC;QACtE,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,IAAI,QAAQ,CAAC,OAAO,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YACnE,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QACvB,CAAC;QACD,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CAAC;AACJ,CAAC"}

package/dist/status.d.ts

@@ -0,0 +1,7 @@
+import { Effect } from "effect";
+import { type HttpClientResponse } from "effect/http";
+import { GitHubConversationLocked, GitHubPermissionDenied, GitHubRateLimited } from "#errors.ts";
+export declare function isUnauthorized(response: HttpClientResponse.HttpClientResponse): boolean;
+export declare function isUnchanged(response: HttpClientResponse.HttpClientResponse): boolean;
+export declare const checkStatus: (response: HttpClientResponse.HttpClientResponse, resource: string, failures?: any) => Effect.Effect<HttpClientResponse.HttpClientResponse, GitHubConversationLocked | GitHubPermissionDenied | GitHubRateLimited | import("effect/http/HttpClientError").HttpClientError | import("@shivaedev/http/errors.ts").ResponseBodyTooLarge | import("@shivaedev/http/errors.ts").RemoteStatusError, never>;
+//# sourceMappingURL=status.d.ts.map

package/dist/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../src/status.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,MAAM,EAAkB,MAAM,QAAQ,CAAC;AAC1D,OAAO,EAAc,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAIlE,OAAO,EAAE,wBAAwB,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEjG,wBAAgB,cAAc,CAAC,QAAQ,EAAE,kBAAkB,CAAC,kBAAkB,WAE7E;AAED,wBAAgB,WAAW,CAAC,QAAQ,EAAE,kBAAkB,CAAC,kBAAkB,WAE1E;AAED,eAAO,MAAM,WAAW,sYAetB,CAAC"}

package/dist/status.js

@@ -0,0 +1,57 @@
+import { DateTime, Effect, Option, Schema } from "effect";
+import { HttpClient } from "effect/http";
+import { readBoundedText } from "@shivaedev/http/body.ts";
+import { filterStatus } from "@shivaedev/http/filterStatus.ts";
+import { parseRetryAfter } from "@shivaedev/http/parseRetryAfter.ts";
+import { GitHubConversationLocked, GitHubPermissionDenied, GitHubRateLimited } from "#errors.ts";
+export function isUnauthorized(response) {
+    return response.status === 401;
+}
+export function isUnchanged(response) {
+    return response.status === 304;
+}
+export const checkStatus = Effect.fnUntraced(function* (response, resource, failures = 0) {
+    const { status, headers } = response;
+    if (status === 403 || status === 429) {
+        const limitedByHeaders = status === 429 || headers["x-ratelimit-remaining"] === "0" || headers["retry-after"] !== undefined;
+        const message = !limitedByHeaders && status === 403 ? yield* responseMessage(response) : undefined;
+        const limitedByMessage = message !== undefined && /rate limit/iu.test(message);
+        if (limitedByHeaders || limitedByMessage) {
+            return yield* refuseRateLimit(response, resource, failures);
+        }
+        const refusal = githubRefusal(message, new URL(response.request.url).pathname);
+        if (refusal !== undefined) {
+            return yield* refusal;
+        }
+    }
+    return yield* filterStatus(HttpClient.makeWith(() => Effect.succeed(response), Effect.succeed)).execute(response.request);
+});
+const Message = Schema.fromJsonString(Schema.Struct({ message: Schema.String }));
+const responseMessage = Effect.fnUntraced(function* (response) {
+    const text = yield* readBoundedText(response, 64 * 1024);
+    const body = Schema.decodeUnknownOption(Message)(text);
+    return Option.isSome(body) ? body.value.message : undefined;
+});
+function githubRefusal(message, path) {
+    if (message === undefined) {
+        return undefined;
+    }
+    if (/^Resource not accessible by integration$/iu.test(message)) {
+        return new GitHubPermissionDenied({ path });
+    }
+    if (/\bconversation (?:is|has been) locked\b/iu.test(message)) {
+        return new GitHubConversationLocked({ path });
+    }
+    return undefined;
+}
+const refuseRateLimit = Effect.fnUntraced(function* (response, resource, failures) {
+    const { headers } = response;
+    const now = yield* DateTime.now;
+    const reset = Number(headers["x-ratelimit-reset"] ?? 0) * 1000;
+    const fallback = headers["x-ratelimit-remaining"] === "0" && reset > DateTime.toEpochMillis(now)
+        ? reset
+        : DateTime.toEpochMillis(now) + Math.min(15 * 60_000, 60_000 * 2 ** failures);
+    const retryAt = parseRetryAfter(headers["retry-after"], now) ?? DateTime.makeUnsafe(fallback);
+    return yield* new GitHubRateLimited({ resource, retryAt });
+});
+//# sourceMappingURL=status.js.map

package/dist/status.js.map

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

package/dist/stickyComments.d.ts

@@ -0,0 +1,46 @@
+import { Effect, Schema } from "effect";
+import type { Representations } from "#representations.ts";
+export declare const PullRequestComment: Schema.encodeKeys<Schema.Struct<{
+    readonly body: Schema.String;
+    readonly id: Schema.Number;
+    readonly performedViaGithubApp: Schema.optional<Schema.NullOr<Schema.Struct<{
+        readonly id: Schema.Number;
+    }>>>;
+    readonly user: Schema.NullOr<Schema.Struct<{
+        readonly login: Schema.String;
+        readonly type: Schema.optional<Schema.String>;
+    }>>;
+}>, {
+    readonly performedViaGithubApp: "performed_via_github_app";
+}>;
+export declare const StickyComment: Schema.Struct<{
+    readonly appId: Schema.optional<Schema.Number>;
+    readonly author: Schema.optional<Schema.String>;
+    readonly body: Schema.String;
+    readonly marker: Schema.String;
+    readonly number: Schema.Number;
+    readonly owner: Schema.String;
+    readonly repo: Schema.String;
+}>;
+export declare function stickyComments(client: Representations): {
+    upsertStickyComment: (input: {
+        readonly appId?: number | undefined;
+        readonly author?: string | undefined;
+        readonly body: string;
+        readonly marker: string;
+        readonly number: number;
+        readonly owner: string;
+        readonly repo: string;
+    }) => Effect.Effect<{
+        readonly body: string;
+        readonly id: number;
+        readonly performedViaGithubApp?: {
+            readonly id: number;
+        } | null | undefined;
+        readonly user: {
+            readonly login: string;
+            readonly type?: string | undefined;
+        } | null;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubConversationLocked | import("./errors.ts").GitHubPermissionDenied | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("effect/Cause").NoSuchElementError | import("@shivaedev/http/errors.ts").PaginationLinkError | import("@shivaedev/http/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/errors/taxonomy.ts").ServiceUnavailable | import("@shivaedev/http/errors.ts").RemoteStatusError, never>;
+};
+//# sourceMappingURL=stickyComments.d.ts.map

package/dist/stickyComments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stickyComments.d.ts","sourceRoot":"","sources":["../src/stickyComments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAU,MAAM,EAAU,MAAM,QAAQ,CAAC;AACxD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAE3D,eAAO,MAAM,kBAAkB;;;;;;;;;;;;EAKkD,CAAC;AAElF,eAAO,MAAM,aAAa;;;;;;;;EAQxB,CAAC;AAIH,wBAAgB,cAAc,CAAC,MAAM,EAAE,eAAe;IAEpD,mBAAmB;;;;;;;;;;;;;;;;;;;EAwBpB"}

package/dist/stickyComments.js

@@ -0,0 +1,37 @@
+import { Effect, Option, Schema, Stream } from "effect";
+export const PullRequestComment = Schema.Struct({
+    body: Schema.String,
+    id: Schema.Number,
+    performedViaGithubApp: Schema.optional(Schema.NullOr(Schema.Struct({ id: Schema.Number }))),
+    user: Schema.NullOr(Schema.Struct({ login: Schema.String, type: Schema.optional(Schema.String) })),
+}).pipe(Schema.encodeKeys({ performedViaGithubApp: "performed_via_github_app" }));
+export const StickyComment = Schema.Struct({
+    appId: Schema.optional(Schema.Number),
+    author: Schema.optional(Schema.String),
+    body: Schema.String,
+    marker: Schema.String,
+    number: Schema.Number,
+    owner: Schema.String,
+    repo: Schema.String,
+});
+const CommentBody = Schema.Struct({ body: Schema.String });
+export function stickyComments(client) {
+    return {
+        upsertStickyComment: Effect.fn("GitHub.upsertStickyComment")(function* (input) {
+            const { owner, repo, number, marker, body, author, appId } = yield* Schema.decodeUnknownEffect(StickyComment)(input);
+            const hiddenMarker = `<!-- ${marker} -->`;
+            const root = `/repos/${owner}/${repo}/issues`;
+            const pages = yield* client.list(`${root}/${number}/comments`);
+            const existing = yield* pages.pipe(Stream.mapEffect((page) => page.decode(Schema.Array(PullRequestComment))), Stream.flatMap(Stream.fromIterable), Stream.filter((comment) => (author === undefined || comment.user?.login === author)
+                && (appId === undefined
+                    ? comment.body.includes(hiddenMarker)
+                    : comment.body.startsWith(hiddenMarker) && comment.performedViaGithubApp?.id === appId && comment.user?.type === "Bot")), Stream.runHead);
+            const payload = yield* Schema.encodeEffect(CommentBody)({ body: `${hiddenMarker}\n${body}` });
+            const response = yield* Option.isSome(existing)
+                ? client.write("PATCH", `${root}/comments/${existing.value.id}`, payload)
+                : client.write("POST", `${root}/${number}/comments`, payload);
+            return yield* response.decode(PullRequestComment);
+        }),
+    };
+}
+//# sourceMappingURL=stickyComments.js.map

package/dist/stickyComments.js.map

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

package/dist/verifyWebhook.d.ts

@@ -0,0 +1,4 @@
+import { Effect, Redacted, Schema } from "effect";
+import { GitHubWebhookSignatureError } from "./errors.ts";
+export declare const verifyWebhook: <TSchema extends Schema.Constraint>(body: Uint8Array<ArrayBufferLike>, signature: string | undefined, secret: Redacted.Redacted<string>, schema: TSchema) => Effect.Effect<TSchema["Type"], GitHubWebhookSignatureError | Schema.SchemaError, TSchema["DecodingServices"]>;
+//# sourceMappingURL=verifyWebhook.d.ts.map

package/dist/verifyWebhook.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyWebhook.d.ts","sourceRoot":"","sources":["../src/verifyWebhook.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,eAAO,MAAM,aAAa,GAAgC,OAAO,SAAS,MAAM,CAAC,UAAU,wOAczF,CAAC"}

package/dist/verifyWebhook.js

@@ -0,0 +1,14 @@
+import { createHmac, timingSafeEqual } from "node:crypto";
+import { Effect, Redacted, Schema } from "effect";
+import { GitHubWebhookSignatureError } from "./errors.js";
+export const verifyWebhook = Effect.fnUntraced(function* (body, signature, secret, schema) {
+    if (signature === undefined || !/^sha256=[0-9a-f]{64}$/u.test(signature)) {
+        return yield* new GitHubWebhookSignatureError();
+    }
+    const expected = createHmac("sha256", Redacted.value(secret)).update(body).digest();
+    if (!timingSafeEqual(expected, Buffer.from(signature.slice(7), "hex"))) {
+        return yield* new GitHubWebhookSignatureError();
+    }
+    return yield* Schema.decodeUnknownEffect(Schema.fromJsonString(schema))(new TextDecoder().decode(body));
+});
+//# sourceMappingURL=verifyWebhook.js.map

package/dist/verifyWebhook.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"verifyWebhook.js","sourceRoot":"","sources":["../src/verifyWebhook.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAClD,OAAO,EAAE,2BAA2B,EAAE,MAAM,aAAa,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EACvD,IAAgB,EAChB,SAA6B,EAC7B,MAAiC,EACjC,MAAe;IAEf,IAAI,SAAS,KAAK,SAAS,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;QAC1E,OAAO,KAAK,CAAC,CAAC,IAAI,2BAA2B,EAAE,CAAC;IACjD,CAAC;IACD,MAAM,QAAQ,GAAG,UAAU,CAAC,QAAQ,EAAE,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;IACpF,IAAI,CAAC,eAAe,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC;QACxE,OAAO,KAAK,CAAC,CAAC,IAAI,2BAA2B,EAAE,CAAC;IACjD,CAAC;IACD,OAAO,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;AACzG,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,10 +1,77 @@
 {
   "name": "@shivaedev/github",
-  "version": "0.0.0",
-  "description": "Placeholder for the ShivaeDev github package.",
-  "license": "MIT",
+  "version": "0.5.1",
+  "description": "Typed GitHub REST requests, conditional reads and resource budgets for Effect applications",
+  "keywords": [
+    "effect"
+  ],
+  "homepage": "https://github.com/ShivaeDev/platform/tree/main/packages/github#readme",
+  "bugs": {
+    "url": "https://github.com/ShivaeDev/platform/issues"
+  },
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/ShivaeDev/platform.git"
+    "url": "git+https://github.com/ShivaeDev/platform.git",
+    "directory": "packages/github"
+  },
+  "license": "MIT",
+  "sideEffects": false,
+  "type": "module",
+  "imports": {
+    "#test/*": "./src/test-support/*",
+    "#*.ts": {
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    }
+  },
+  "exports": {
+    "./*.ts": {
+      "source": "./src/*.ts",
+      "types": "./dist/*.d.ts",
+      "default": "./dist/*.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "src",
+    "!src/**/*.test.ts",
+    "!src/**/*.spec.ts",
+    "!src/**/test-support",
+    "README.md"
+  ],
+  "dependencies": {
+    "@shivaedev/errors": "0.0.0",
+    "@shivaedev/http": "0.0.0",
+    "@shivaedev/service": "0.4.1"
+  },
+  "devDependencies": {
+    "@effect/platform-node": "4.0.5",
+    "@effect/platform-node-shared": "4.0.5",
+    "@effect/vitest": "4.0.5",
+    "@shivaedev/quality": "0.41.1",
+    "@shivaedev/test": "0.9.0",
+    "@shivaedev/test-story": "0.20.1",
+    "@types/node": "24.19.2",
+    "effect": "4.0.5",
+    "typescript": "7.0.2",
+    "vitest": "5.0.5"
+  },
+  "peerDependencies": {
+    "effect": "4.0.5"
+  },
+  "engines": {
+    "node": ">=24"
+  },
+  "publishConfig": {
+    "access": "public",
+    "provenance": true
+  },
+  "scripts": {
+    "build": "node --eval \"import('node:fs').then(({ rmSync }) => rmSync('dist', { force: true, recursive: true }))\" && tsc --project tsconfig.build.json",
+    "ready": "pnpm typecheck && pnpm test && pnpm build",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
   }
 }

package/src/GitHub.ts

@@ -0,0 +1,68 @@
+import { Effect, Schema, Stream } from "effect";
+import { HttpClient } from "effect/http";
+import { defineService } from "@shivaedev/service/defineService.ts";
+import { artifacts } from "#artifacts.ts";
+import { checkRuns } from "#checkRuns.ts";
+import { GitHubConfig } from "#GitHubConfig.ts";
+import { GitHubToken } from "#GitHubToken.ts";
+import { rateLimits } from "#rateLimits.ts";
+import { representations } from "#representations.ts";
+import { requests } from "#requests.ts";
+import { stickyComments } from "#stickyComments.ts";
+import { TokenRefresh } from "#TokenRefresh.ts";
+
+export const GitHub = defineService({
+	id: "@shivaedev/github/GitHub",
+	initialize: Effect.gen(function* () {
+		const config = yield* GitHubConfig;
+		const rates = rateLimits();
+		const client = yield* HttpClient.HttpClient;
+		const token = yield* GitHubToken;
+		const refresh = yield* TokenRefresh;
+		return {
+			apiUrl: config.apiUrl,
+			archive: artifacts(config.apiUrl, client, token, rates, refresh),
+			rates,
+			request: requests(client, token, rates, refresh),
+			responseByteLimit: config.responseByteLimit,
+		};
+	}),
+	methods: ({ apiUrl, archive, rates, request, responseByteLimit }) => {
+		const { get, ...client } = representations(apiUrl, request, rates.resource, responseByteLimit);
+		return {
+			bytes: (path: string, accept: string, limit: number) => Effect.map(request(get(path, accept), limit), (entry) => entry.bytes),
+			...client,
+			...archive,
+			...stickyComments(client),
+			...checkRuns(client),
+			observations: () => Effect.sync(() => [...rates.observations.values()]),
+			resource: (path: string) => Effect.sync(() => rates.resource(new URL(path, apiUrl).pathname)),
+			text: (path: string, accept: string, limit: number) =>
+				Effect.map(request(get(path, accept), limit), (entry) => new TextDecoder().decode(entry.bytes)),
+		};
+	},
+	requires: [HttpClient.HttpClient, GitHubToken],
+});
+
+export function read<TSchema extends Schema.Constraint>(path: string, schema: TSchema, responseByteLimit?: number) {
+	return Effect.flatMap(GitHub, (github) => Effect.flatMap(github.read(path, responseByteLimit), (response) => response.decode(schema)));
+}
+
+export function list<TSchema extends Schema.Constraint>(path: string, schema: TSchema, responseByteLimit?: number) {
+	return Stream.unwrap(Effect.flatMap(GitHub, (github) => github.list(path, undefined, responseByteLimit))).pipe(
+		Stream.mapEffect((response) => response.decode(Schema.Array(schema))),
+		Stream.flatMap(Stream.fromIterable),
+	);
+}
+
+export function write<TSchema extends Schema.Constraint>(
+	method: "POST" | "PATCH",
+	path: string,
+	body: unknown,
+	schema: TSchema,
+	responseByteLimit?: number,
+) {
+	return Effect.flatMap(GitHub, (github) =>
+		Effect.flatMap(github.write(method, path, body, responseByteLimit), (response) => response.decode(schema)),
+	);
+}

package/src/GitHubConfig.ts

@@ -0,0 +1,5 @@
+import { Context } from "effect";
+
+export const GitHubConfig = Context.Reference<{ readonly apiUrl: string; readonly responseByteLimit?: number }>("@shivaedev/github/GitHubConfig", {
+	defaultValue: () => ({ apiUrl: "https://api.github.com" }),
+});

package/src/GitHubToken.ts

@@ -0,0 +1,16 @@
+import { Config, Context, Effect, Layer, type Option, type Redacted } from "effect";
+import type { GitHubAppError } from "./errors.ts";
+
+type Token = Option.Option<Redacted.Redacted<string>>;
+
+export class GitHubToken extends Context.Service<GitHubToken, Token | Effect.Effect<Token, GitHubAppError>>()("@shivaedev/github/GitHubToken") {
+	static readonly fromEnv = Layer.effect(GitHubToken)(
+		Effect.gen(function* () {
+			const token = yield* Config.Redacted("GH_TOKEN").pipe(
+				Config.orElse(() => Config.Redacted("GITHUB_TOKEN")),
+				Config.option,
+			);
+			return token;
+		}),
+	);
+}

package/src/TokenRefresh.ts

@@ -0,0 +1,7 @@
+import { Context, type Effect, type Option, type Redacted } from "effect";
+
+type Refresh = (rejected: Option.Option<Redacted.Redacted<string>>) => Effect.Effect<unknown>;
+
+export const TokenRefresh = Context.Reference<Refresh | undefined>("@shivaedev/github/TokenRefresh", {
+	defaultValue: () => undefined,
+});

package/src/appJwt.ts

@@ -0,0 +1,21 @@
+import { sign } from "node:crypto";
+import { Clock, Effect, Redacted } from "effect";
+import { GitHubAppError } from "#errors.ts";
+
+export interface AppCredentials {
+	readonly appId: string;
+	readonly privateKey: Redacted.Redacted<string>;
+}
+
+export const appJwt = Effect.fnUntraced(function* (options: AppCredentials) {
+	const now = Math.floor((yield* Clock.currentTimeMillis) / 1000);
+	return yield* Effect.try({
+		catch: () => new GitHubAppError({ stage: "sign" }),
+		try: () => {
+			const header = Buffer.from(JSON.stringify({ alg: "RS256", typ: "JWT" })).toString("base64url");
+			const payload = Buffer.from(JSON.stringify({ exp: now + 600, iat: now - 60, iss: options.appId })).toString("base64url");
+			const input = `${header}.${payload}`;
+			return Redacted.make(`${input}.${sign("RSA-SHA256", Buffer.from(input), Redacted.value(options.privateKey)).toString("base64url")}`);
+		},
+	});
+});