@shivaedev/effect-github 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 ShivaeDev
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,111 @@
-# Temporary Holding Version
+# @shivaedev/effect-github
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+GitHub integrations should share one client instead of repeating token headers, page loops and quota handling in every application. This package turns GitHub REST responses into Schema-decoded Effects and streams while keeping rate limits typed.
+
+## Read GitHub with less application code
+
+Describe the response you need and read it. Unchanged responses reuse their decoded value after ETag revalidation; paged lists fetch as you consume them.
+
+```ts
+import { Schema } from "effect";
+import { read } from "@shivaedev/effect-github/GitHub.ts";
+
+const Repository = Schema.Struct({ name: Schema.String });
+const repository = read("/repos/acme/widgets", Repository);
+```
+
+## Using the client
+
+`GitHub` is a native Context service declared with `defineService`. Its Layer owns the conditional response cache and resource observations. Provide an Effect `HttpClient` and a `GitHubToken` once, then use the Schema-aware `read`, `list` and `write` functions. Schema decoding services remain visible in their requirements.
+
+```ts
+import { Effect, Layer, Schema, Stream } from "effect";
+import { FetchHttpClient } from "effect/http";
+import { GitHub, list, read, write } from "@shivaedev/effect-github/GitHub.ts";
+import { GitHubToken } from "@shivaedev/effect-github/GitHubToken.ts";
+
+const github = GitHub.layer.pipe(
+  Layer.provide(FetchHttpClient.layer),
+  Layer.provide(GitHubToken.fromEnv),
+);
+const Issue = Schema.Struct({ number: Schema.Number, title: Schema.String });
+const program = Effect.gen(function* () {
+  const issue = yield* read("/repos/acme/widgets/issues/1", Issue);
+  const first = yield* list("/repos/acme/widgets/issues", Issue).pipe(
+    Stream.take(1),
+    Stream.runCollect,
+  );
+  const created = yield* write("POST", "/repos/acme/widgets/issues", { title: "A new issue" }, Issue);
+  return { issue, first, created };
+});
+
+await Effect.runPromise(program.pipe(Effect.provide(github)));
+```
+
+`GitHubToken.fromEnv` reads `GH_TOKEN`, then `GITHUB_TOKEN`, through Effect Config. If neither is set, requests are unauthenticated. To supply a token directly, provide `GitHubToken` with `Option.some(Redacted.make(token))`; use `Option.none()` for anonymous access. Requests send `Accept: application/vnd.github+json` and `X-GitHub-Api-Version: 2022-11-28`.
+
+The default base URL is `https://api.github.com`. Provide `GitHubConfig` from `@shivaedev/effect-github/GitHubConfig.ts` with `{ apiUrl }` for another GitHub API endpoint.
+
+`read(path, schema)` decodes a JSON response. `list(path, itemSchema)` returns a Stream of decoded items across GitHub's Link pages, and stops fetching when consumption stops. `write(method, path, body, schema)` sends JSON with `POST` or `PATCH` and decodes its response. JSON response bodies are bounded at 1 MiB. The conditional cache holds up to 1000 representations and keeps decoded values separate for each Schema.
+
+For diffs and artifacts, obtain the service and call `text(path, accept, byteLimit)` or `bytes(path, accept, byteLimit)`. Both bound the body before returning it and use your chosen media type.
+
+```ts
+const diff = Effect.gen(function* () {
+  const github = yield* GitHub;
+  return yield* github.text("/repos/acme/widgets/pulls/1", "application/vnd.github.diff", 256 * 1024);
+});
+```
+
+The service's `read(path)` and `write(method, path, body)` return a representation with a generic `decode(schema)` method. Its `list(path)` returns an Effect containing a Stream of page representations. Prefer the exported functions for Schema-decoded items. A caller with a pacing policy can pass `github.list(path, beforeRequest)`: the callback receives the resource name before each page request, and its typed failure stops the stream. `github.resource(path)` returns the observed resource for that path, defaulting to core or search before the first response.
+
+### Acting as a GitHub App
+
+Provide `githubApp` as the `GitHubToken` Layer to authenticate the same client as an installation. Give it the App ID, a PEM private key wrapped in `Redacted`, and an installation ID. This uses Node's built-in crypto; no JWT or Octokit dependency is needed.
+
+```ts
+import { Layer, Redacted } from "effect";
+import { FetchHttpClient } from "effect/http";
+import { GitHub } from "@shivaedev/effect-github/GitHub.ts";
+import { githubApp } from "@shivaedev/effect-github/githubApp.ts";
+
+const appClient = (privateKey: Redacted.Redacted<string>) => GitHub.layer.pipe(
+  Layer.provide(githubApp({ appId: "123456", privateKey, installationId: 7 })),
+  Layer.provide(FetchHttpClient.layer),
+);
+```
+
+Alternatively, pass `{ appId, privateKey, owner: "acme", repository: "widgets" }`. The Layer resolves the installation through `GET /repos/{owner}/{repo}/installation` before exchanging the App JWT for an installation token. The RS256 JWT carries the App ID as `iss`, `iat` 60 seconds before the current time, and `exp` ten minutes ahead.
+
+`GitHubToken` accepts a static Option or a lazy Effect returning one; the client resolves it on each request. Code that reads the service directly must evaluate an Effect value before inspecting the Option, using `Effect.isEffect(value) ? yield* value : value`.
+
+The token is fetched on the first request and reused until five minutes before `expires_at`, using Effect's Clock. Concurrent requests share the in-flight exchange, including at refresh. A rejected exchange fails with `GitHubAppError` from `errors.ts`; a 401 has `{ stage: "exchange", status: 401 }`. Signing failures have `stage: "sign"`. These errors and their logs and spans contain no private key, App JWT or installation token.
+
+### Verifying webhooks
+
+Pass the raw request bytes and the `X-Hub-Signature-256` header to `verifyWebhook` before parsing the body. It checks HMAC SHA-256 with a constant-time comparison, then decodes JSON with your Schema. A missing header, tampered body or wrong secret fails with `GitHubWebhookSignatureError` before Schema decoding.
+
+```ts
+import { Redacted, Schema } from "effect";
+import { verifyWebhook } from "@shivaedev/effect-github/verifyWebhook.ts";
+
+const WorkflowRun = Schema.Struct({
+  action: Schema.String,
+  workflowRun: Schema.Struct({ id: Schema.Number, conclusion: Schema.String }),
+}).pipe(Schema.encodeKeys({ workflowRun: "workflow_run" }));
+const receiveWorkflowRun = (
+  rawBody: Uint8Array,
+  signature: string | undefined,
+  secret: Redacted.Redacted<string>,
+) => verifyWebhook(rawBody, signature, secret, WorkflowRun);
+```
+
+This decodes a signed `workflow_run` delivery with the fields the application needs. Keep the body bytes as received: parsing and reserializing JSON changes what was signed.
+
+### Rate limits and failures
+
+`github.observations()` returns the latest `resource`, `limit`, `remaining`, `used` and UTC `reset` from response headers, including conditional and failed responses. Core and search budgets remain separate. A primary or secondary rate limit fails with `GitHubRateLimited` from `@shivaedev/effect-github/errors.ts`; its `retryAt` is a UTC `DateTime` usable directly by a job scheduler. Requests to a blocked resource fail locally until that instant. Each rate-limited failure records a log and span event with the request path and budget, excluding credentials and query strings.
+
+HTTP status failures use platform's typed `RemoteNotFound`, `RemoteUnauthorized` and other errors from `@shivaedev/platform/http-client/errors.ts`. An oversized body fails with `ResponseBodyTooLarge`; invalid response data fails with `Schema.SchemaError`. Transport failures use `GitHubTransportError`, which contains only the request path.
+
+Install with `pnpm add @shivaedev/effect-github effect`. Choose and provide an Effect HTTP client appropriate to your runtime. Scheduling, retries and application policy stay with the caller.

package/dist/GitHub.d.ts

@@ -0,0 +1,25 @@
+import { Effect, Schema, Stream } from "effect";
+import { HttpClient } from "effect/http";
+import type { ServiceUnavailable } from "@shivaedev/platform/errors/taxonomy.ts";
+import { GitHubToken } from "./GitHubToken.ts";
+export declare const GitHub: import("effect/Context").Service<"@shivaedev/effect-github/GitHub", Readonly<{
+    readonly bytes: (path: string, accept: string, limit: number) => Effect.Effect<Uint8Array<ArrayBufferLike>, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly list: (path: string, beforeRequest?: ((resource: string) => Effect.Effect<void, ServiceUnavailable>) | undefined) => Effect.Effect<Stream.Stream<{
+        decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>, never, never>;
+    readonly observations: () => Effect.Effect<import("./rateLimits.ts").RateLimitObservation[], never, never>;
+    readonly read: (path: string) => Effect.Effect<{
+        decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly resource: (path: string) => Effect.Effect<string, never, never>;
+    readonly text: (path: string, accept: string, limit: number) => Effect.Effect<string, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+    readonly write: (method: "PATCH" | "POST", path: string, body: unknown) => Effect.Effect<{
+        decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
+    }, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, never>;
+}>> & {
+    readonly layer: import("effect/Layer").Layer<"@shivaedev/effect-github/GitHub", never, GitHubToken | HttpClient.HttpClient>;
+};
+export declare function read<TSchema extends Schema.Constraint>(path: string, schema: TSchema): Effect.Effect<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
+export declare function list<TSchema extends Schema.Constraint>(path: string, schema: TSchema): Stream.Stream<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/Cause").NoSuchElementError | import("@shivaedev/platform/http-client/errors.ts").PaginationLinkError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | ServiceUnavailable | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
+export declare function write<TSchema extends Schema.Constraint>(method: "POST" | "PATCH", path: string, body: unknown, schema: TSchema): Effect.Effect<TSchema["Type"], import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | import("./errors.ts").GitHubTransportError | import("effect/http/HttpBody").HttpBodyError | import("@shivaedev/platform/http-client/errors.ts").ResponseBodyTooLarge | Schema.SchemaError | import("@shivaedev/platform/http-client/errors.ts").RemoteStatusError, "@shivaedev/effect-github/GitHub" | TSchema["DecodingServices"]>;
+//# sourceMappingURL=GitHub.d.ts.map

package/dist/GitHub.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHub.d.ts","sourceRoot":"","sources":["../src/GitHub.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAChD,OAAO,EAAE,UAAU,EAA8C,MAAM,aAAa,CAAC;AAErF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAIjF,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAK/C,eAAO,MAAM,MAAM;;8DAkBqD,MAAM,KAAK,MAAM,CAAC,MAAM,CAAC,IAAI,EAAE,kBAAkB,CAAC;;;;;;;;;;;;;;CAyCxH,CAAC;AAEH,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,wYAEpF;AAED,wBAAgB,IAAI,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,mhBAKpF;AAED,wBAAgB,KAAK,CAAC,OAAO,SAAS,MAAM,CAAC,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,ubAE9H"}

package/dist/GitHub.js

@@ -0,0 +1,63 @@
+import { Effect, Schema, Stream } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/http";
+import { defineService } from "@shivaedev/effect-service/defineService.ts";
+import { paginate } from "@shivaedev/platform/http-client/paginate.ts";
+import { GitHubConfig } from "./GitHubConfig.js";
+import { GitHubToken } from "./GitHubToken.js";
+import { jsonResponse } from "./json.js";
+import { rateLimits } from "./rateLimits.js";
+import { requests } from "./requests.js";
+export const GitHub = defineService({
+    id: "@shivaedev/effect-github/GitHub",
+    initialize: Effect.gen(function* () {
+        const config = yield* GitHubConfig;
+        const rates = rateLimits();
+        return {
+            apiUrl: config.apiUrl,
+            rates,
+            request: requests(yield* HttpClient.HttpClient, yield* GitHubToken, rates),
+        };
+    }),
+    methods: ({ apiUrl, rates, request }) => {
+        function get(path, accept = "application/vnd.github+json") {
+            return HttpClientRequest.get(new URL(path, apiUrl).href, { headers: { Accept: accept } });
+        }
+        function readRepresentation(path) {
+            return Effect.map(request(get(path), 1024 * 1024), jsonResponse);
+        }
+        function listRepresentations(path, beforeRequest) {
+            const entries = new WeakMap();
+            function fetchPage(input) {
+                return (beforeRequest?.(rates.resource(new URL(input.url).pathname)) ?? Effect.void).pipe(Effect.andThen(request(input, 1024 * 1024)), 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) {
+            return HttpClientRequest.make(method)(new URL(path, apiUrl).href, { headers: { Accept: "application/vnd.github+json" } }).pipe(HttpClientRequest.bodyJson(body), Effect.flatMap((input) => request(input, 1024 * 1024)), Effect.map(jsonResponse));
+        }
+        return {
+            bytes: (path, accept, limit) => Effect.map(request(get(path, accept), limit), (entry) => entry.bytes),
+            list: listRepresentations,
+            observations: () => Effect.sync(() => [...rates.observations.values()]),
+            read: readRepresentation,
+            resource: (path) => Effect.sync(() => rates.resource(new URL(path, apiUrl).pathname)),
+            text: (path, accept, limit) => Effect.map(request(get(path, accept), limit), (entry) => new TextDecoder().decode(entry.bytes)),
+            write: writeRepresentation,
+        };
+    },
+    requires: [HttpClient.HttpClient, GitHubToken],
+});
+export function read(path, schema) {
+    return Effect.flatMap(GitHub, (github) => Effect.flatMap(github.read(path), (response) => response.decode(schema)));
+}
+export function list(path, schema) {
+    return Stream.unwrap(Effect.flatMap(GitHub, (github) => github.list(path))).pipe(Stream.mapEffect((response) => response.decode(Schema.Array(schema))), Stream.flatMap(Stream.fromIterable));
+}
+export function write(method, path, body, schema) {
+    return Effect.flatMap(GitHub, (github) => Effect.flatMap(github.write(method, path, body), (response) => response.decode(schema)));
+}
+//# sourceMappingURL=GitHub.js.map

package/dist/GitHub.js.map

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

package/dist/GitHubConfig.d.ts

@@ -0,0 +1,5 @@
+import { Context } from "effect";
+export declare const GitHubConfig: Context.Reference<{
+    readonly apiUrl: string;
+}>;
+//# sourceMappingURL=GitHubConfig.d.ts.map

package/dist/GitHubConfig.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubConfig.d.ts","sourceRoot":"","sources":["../src/GitHubConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,eAAO,MAAM,YAAY;qBAAwC,MAAM;EAErE,CAAC"}

package/dist/GitHubConfig.js

@@ -0,0 +1,5 @@
+import { Context } from "effect";
+export const GitHubConfig = Context.Reference("@shivaedev/effect-github/GitHubConfig", {
+    defaultValue: () => ({ apiUrl: "https://api.github.com" }),
+});
+//# sourceMappingURL=GitHubConfig.js.map

package/dist/GitHubConfig.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubConfig.js","sourceRoot":"","sources":["../src/GitHubConfig.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,QAAQ,CAAC;AAEjC,MAAM,CAAC,MAAM,YAAY,GAAG,OAAO,CAAC,SAAS,CAA8B,uCAAuC,EAAE;IACnH,YAAY,EAAE,GAAG,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,wBAAwB,EAAE,CAAC;CAC1D,CAAC,CAAC"}

package/dist/GitHubToken.d.ts

@@ -0,0 +1,9 @@
+import { Config, Context, Effect, Layer, type Option, type Redacted } from "effect";
+import type { GitHubAppError } from "./errors.ts";
+type Token = Option.Option<Redacted.Redacted<string>>;
+declare const GitHubToken_base: Context.ServiceClass<GitHubToken, "@shivaedev/effect-github/GitHubToken", Effect.Effect<Token, GitHubAppError, never> | Token>;
+export declare class GitHubToken extends GitHubToken_base {
+    static readonly fromEnv: Layer.Layer<GitHubToken, Config.ConfigError, never>;
+}
+export {};
+//# sourceMappingURL=GitHubToken.d.ts.map

package/dist/GitHubToken.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubToken.d.ts","sourceRoot":"","sources":["../src/GitHubToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,QAAQ,CAAC;AACpF,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC;AAElD,KAAK,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;;AAEtD,qBAAa,WAAY,SAAQ,gBAEhC;IACA,MAAM,CAAC,QAAQ,CAAC,OAAO,sDAQrB;CACF"}

package/dist/GitHubToken.js

@@ -0,0 +1,8 @@
+import { Config, Context, Effect, Layer } from "effect";
+export class GitHubToken extends Context.Service()("@shivaedev/effect-github/GitHubToken") {
+    static 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;
+    }));
+}
+//# sourceMappingURL=GitHubToken.js.map

package/dist/GitHubToken.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GitHubToken.js","sourceRoot":"","sources":["../src/GitHubToken.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAA8B,MAAM,QAAQ,CAAC;AAKpF,MAAM,OAAO,WAAY,SAAQ,OAAO,CAAC,OAAO,EAA6D,CAC5G,sCAAsC,CACtC;IACA,MAAM,CAAU,OAAO,GAAG,KAAK,CAAC,MAAM,CAAC,WAAW,CAAC,CAClD,MAAM,CAAC,GAAG,CAAC,QAAQ,CAAC;QACnB,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,IAAI,CACpD,MAAM,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC,EACpD,MAAM,CAAC,MAAM,CACb,CAAC;QACF,OAAO,KAAK,CAAC;IACd,CAAC,CAAC,CACF,CAAC;CACF"}

package/dist/cache.d.ts

@@ -0,0 +1,12 @@
+import type { Schema } from "effect";
+import type { HttpClientResponse } from "effect/http";
+export interface CachedResponse {
+    readonly bytes: Uint8Array;
+    readonly decoded: Map<Schema.Constraint, unknown>;
+    readonly response: HttpClientResponse.HttpClientResponse;
+}
+export declare function responseCache(): {
+    get: (key: string) => CachedResponse | undefined;
+    set(key: string, entry: CachedResponse): void;
+};
+//# sourceMappingURL=cache.d.ts.map

package/dist/cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.d.ts","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAEtD,MAAM,WAAW,cAAc;IAC9B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,GAAG,CAAC,MAAM,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;IAClD,QAAQ,CAAC,QAAQ,EAAE,kBAAkB,CAAC,kBAAkB,CAAC;CACzD;AAED,wBAAgB,aAAa;IAG3B,GAAG,QAAQ,MAAM;IACjB,GAAG,MAAM,MAAM,SAAS,cAAc;EAWvC"}

package/dist/cache.js

@@ -0,0 +1,17 @@
+export function responseCache() {
+    const entries = new Map();
+    return {
+        get: (key) => entries.get(key),
+        set(key, entry) {
+            entries.delete(key);
+            entries.set(key, entry);
+            if (entries.size > 1000) {
+                const first = entries.keys().next();
+                if (!first.done) {
+                    entries.delete(first.value);
+                }
+            }
+        },
+    };
+}
+//# sourceMappingURL=cache.js.map

package/dist/cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache.js","sourceRoot":"","sources":["../src/cache.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,aAAa;IAC5B,MAAM,OAAO,GAAG,IAAI,GAAG,EAA0B,CAAC;IAClD,OAAO;QACN,GAAG,EAAE,CAAC,GAAW,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC;QACtC,GAAG,CAAC,GAAW,EAAE,KAAqB;YACrC,OAAO,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YACpB,OAAO,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YACxB,IAAI,OAAO,CAAC,IAAI,GAAG,IAAI,EAAE,CAAC;gBACzB,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC;oBACjB,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBAC7B,CAAC;YACF,CAAC;QACF,CAAC;KACD,CAAC;AACH,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,23 @@
+import { Schema } from "effect";
+declare const GitHubRateLimited_base: Schema.Class<GitHubRateLimited, Schema.TaggedStruct<"GitHubRateLimited", {
+    readonly resource: Schema.String;
+    readonly retryAt: Schema.DateTimeUtc;
+}>, import("effect/Cause").YieldableError>;
+export declare class GitHubRateLimited extends GitHubRateLimited_base {
+}
+declare const GitHubTransportError_base: Schema.Class<GitHubTransportError, Schema.TaggedStruct<"GitHubTransportError", {
+    readonly path: Schema.String;
+}>, import("effect/Cause").YieldableError>;
+export declare class GitHubTransportError extends GitHubTransportError_base {
+}
+declare const GitHubAppError_base: Schema.Class<GitHubAppError, Schema.TaggedStruct<"GitHubAppError", {
+    readonly stage: Schema.Literals<readonly ["sign", "exchange"]>;
+    readonly status: Schema.optional<Schema.Number>;
+}>, import("effect/Cause").YieldableError>;
+export declare class GitHubAppError extends GitHubAppError_base {
+}
+declare const GitHubWebhookSignatureError_base: Schema.Class<GitHubWebhookSignatureError, Schema.TaggedStruct<"GitHubWebhookSignatureError", {}>, import("effect/Cause").YieldableError>;
+export declare class GitHubWebhookSignatureError extends GitHubWebhookSignatureError_base {
+}
+export {};
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;;AAEhC,qBAAa,iBAAkB,SAAQ,sBAGrC;CAAG;;;;AAEL,qBAAa,oBAAqB,SAAQ,yBAExC;CAAG;;;;;AAEL,qBAAa,cAAe,SAAQ,mBAGlC;CAAG;;AAEL,qBAAa,2BAA4B,SAAQ,gCAAoF;CAAG"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+import { Schema } from "effect";
+export class GitHubRateLimited extends Schema.TaggedError()("GitHubRateLimited", {
+    resource: Schema.String,
+    retryAt: Schema.DateTimeUtc,
+}) {
+}
+export class GitHubTransportError extends Schema.TaggedError()("GitHubTransportError", {
+    path: Schema.String,
+}) {
+}
+export class GitHubAppError extends Schema.TaggedError()("GitHubAppError", {
+    stage: Schema.Literals(["sign", "exchange"]),
+    status: Schema.optional(Schema.Number),
+}) {
+}
+export class GitHubWebhookSignatureError extends Schema.TaggedError()("GitHubWebhookSignatureError", {}) {
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,OAAO,iBAAkB,SAAQ,MAAM,CAAC,WAAW,EAAqB,CAAC,mBAAmB,EAAE;IACnG,QAAQ,EAAE,MAAM,CAAC,MAAM;IACvB,OAAO,EAAE,MAAM,CAAC,WAAW;CAC3B,CAAC;CAAG;AAEL,MAAM,OAAO,oBAAqB,SAAQ,MAAM,CAAC,WAAW,EAAwB,CAAC,sBAAsB,EAAE;IAC5G,IAAI,EAAE,MAAM,CAAC,MAAM;CACnB,CAAC;CAAG;AAEL,MAAM,OAAO,cAAe,SAAQ,MAAM,CAAC,WAAW,EAAkB,CAAC,gBAAgB,EAAE;IAC1F,KAAK,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC5C,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC;CACtC,CAAC;CAAG;AAEL,MAAM,OAAO,2BAA4B,SAAQ,MAAM,CAAC,WAAW,EAA+B,CAAC,6BAA6B,EAAE,EAAE,CAAC;CAAG"}

package/dist/githubApp.d.ts

@@ -0,0 +1,14 @@
+import { Layer, Redacted } from "effect";
+import { HttpClient } from "effect/http";
+import { GitHubToken } from "./GitHubToken.ts";
+export type GitHubAppOptions = {
+    readonly appId: string;
+    readonly privateKey: Redacted.Redacted<string>;
+} & ({
+    readonly installationId: number;
+} | {
+    readonly owner: string;
+    readonly repository: string;
+});
+export declare function githubApp(options: GitHubAppOptions): Layer.Layer<GitHubToken, never, HttpClient.HttpClient>;
+//# sourceMappingURL=githubApp.d.ts.map

package/dist/githubApp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubApp.d.ts","sourceRoot":"","sources":["../src/githubApp.ts"],"names":[],"mappings":"AACA,OAAO,EAAuB,KAAK,EAAU,QAAQ,EAAU,MAAM,QAAQ,CAAC;AAC9E,OAAO,EAAE,UAAU,EAAqB,MAAM,aAAa,CAAC;AAI5D,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,MAAM,MAAM,gBAAgB,GAAG;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,QAAQ,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;CAC/C,GAAG,CAAC;IAAE,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAAC;AAOpG,wBAAgB,SAAS,CAAC,OAAO,EAAE,gBAAgB,0DA+BlD"}

package/dist/githubApp.js

@@ -0,0 +1,51 @@
+import { sign } from "node:crypto";
+import { Clock, Effect, Exit, Layer, Option, Redacted, Schema } from "effect";
+import { HttpClient, HttpClientRequest } from "effect/http";
+import { readBoundedJson } from "@shivaedev/platform/http-client/body.ts";
+import { GitHubAppError } from "./errors.js";
+import { GitHubConfig } from "./GitHubConfig.js";
+import { GitHubToken } from "./GitHubToken.js";
+const Installation = Schema.Struct({ id: Schema.Number });
+const AccessToken = Schema.Struct({ expiresAt: Schema.DateFromString, token: Schema.RedactedFromValue(Schema.String) }).pipe(Schema.encodeKeys({ expiresAt: "expires_at" }));
+export function githubApp(options) {
+    return Layer.effect(GitHubToken)(Effect.gen(function* () {
+        const client = yield* HttpClient.HttpClient;
+        const { apiUrl } = yield* GitHubConfig;
+        const clock = yield* Clock.Clock;
+        let installationId = "installationId" in options ? options.installationId : undefined;
+        const request = appRequests(client, apiUrl);
+        const exchange = Effect.gen(function* () {
+            const now = Math.floor((yield* Clock.currentTimeMillis) / 1000);
+            const jwt = 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 `${input}.${sign("RSA-SHA256", Buffer.from(input), Redacted.value(options.privateKey)).toString("base64url")}`;
+                },
+            });
+            if (installationId === undefined && "owner" in options) {
+                const path = `/repos/${encodeURIComponent(options.owner)}/${encodeURIComponent(options.repository)}/installation`;
+                installationId = (yield* request("GET", path, jwt, Installation)).id;
+            }
+            return yield* request("POST", `/app/installations/${installationId}/access_tokens`, jwt, AccessToken);
+        });
+        const cached = yield* Effect.cachedWithTTL(exchange, (exit) => Exit.isSuccess(exit) ? Math.max(0, exit.value.expiresAt.getTime() - clock.currentTimeMillisUnsafe() - 300_000) : 0);
+        return Effect.map(cached, ({ token }) => Option.some(token));
+    }));
+}
+function appRequests(client, apiUrl) {
+    return Effect.fnUntraced(function* (method, path, jwt, schema) {
+        const response = yield* client
+            .execute(HttpClientRequest.make(method)(new URL(path, apiUrl).href, {
+            headers: { Accept: "application/vnd.github+json", Authorization: `Bearer ${jwt}`, "X-GitHub-Api-Version": "2022-11-28" },
+        }))
+            .pipe(Effect.mapError(() => new GitHubAppError({ stage: "exchange" })));
+        if (response.status < 200 || response.status >= 300) {
+            return yield* new GitHubAppError({ stage: "exchange", status: response.status });
+        }
+        return yield* readBoundedJson(response, 64 * 1024, schema).pipe(Effect.mapError(() => new GitHubAppError({ stage: "exchange" })));
+    });
+}
+//# sourceMappingURL=githubApp.js.map

package/dist/githubApp.js.map

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

package/dist/json.d.ts

@@ -0,0 +1,7 @@
+import { Effect, Schema } from "effect";
+import type { CachedResponse } from "./cache.ts";
+export declare const decodeJson: <TSchema extends Schema.Constraint>(entry: CachedResponse, schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
+export declare function jsonResponse(entry: CachedResponse): {
+    decode: <TSchema extends Schema.Constraint>(schema: TSchema) => Effect.Effect<TSchema["Type"], Schema.SchemaError, TSchema["DecodingServices"]>;
+};
+//# sourceMappingURL=json.d.ts.map

package/dist/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAEjD,eAAO,MAAM,UAAU,GAAgC,OAAO,SAAS,MAAM,CAAC,UAAU,4HAQtF,CAAC;AAEH,wBAAgB,YAAY,CAAC,KAAK,EAAE,cAAc;IACxC,MAAM,GAAG,OAAO,SAAS,MAAM,CAAC,UAAU,UAAU,OAAO;EACpE"}

package/dist/json.js

@@ -0,0 +1,14 @@
+import { Effect, Schema } from "effect";
+export const decodeJson = Effect.fnUntraced(function* (entry, schema) {
+    const cached = entry.decoded.get(schema);
+    if (entry.decoded.has(schema) && Schema.is(schema)(cached)) {
+        return cached;
+    }
+    const value = yield* Schema.decodeUnknownEffect(Schema.fromJsonString(schema))(new TextDecoder().decode(entry.bytes));
+    entry.decoded.set(schema, value);
+    return value;
+});
+export function jsonResponse(entry) {
+    return { decode: (schema) => decodeJson(entry, schema) };
+}
+//# sourceMappingURL=json.js.map

package/dist/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../src/json.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAGxC,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAqC,KAAqB,EAAE,MAAe;IAC/H,MAAM,MAAM,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,EAAE,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;QAC5D,OAAO,MAAM,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,MAAM,CAAC,mBAAmB,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,WAAW,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC;IACtH,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC,CAAC;IACjC,OAAO,KAAK,CAAC;AACd,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,YAAY,CAAC,KAAqB;IACjD,OAAO,EAAE,MAAM,EAAE,CAAoC,MAAe,EAAE,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,EAAE,CAAC;AACtG,CAAC"}

package/dist/rateLimits.d.ts

@@ -0,0 +1,20 @@
+import { DateTime, Effect } from "effect";
+import type { HttpClientResponse } from "effect/http";
+import type { GitHubRateLimited } from "./errors.ts";
+export interface RateLimitObservation {
+    readonly limit: number;
+    readonly remaining: number;
+    readonly reset: DateTime.Utc;
+    readonly resource: string;
+    readonly used: number;
+}
+export declare function rateLimits(): {
+    blocked: Map<string, GitHubRateLimited>;
+    failures: Map<string, number>;
+    observations: Map<string, RateLimitObservation>;
+    observe(response: HttpClientResponse.HttpClientResponse): string;
+    resource: (path: string) => string;
+};
+export type RateLimits = ReturnType<typeof rateLimits>;
+export declare const failRateLimited: (path: string, error: GitHubRateLimited, remaining: number | undefined) => Effect.Effect<never, GitHubRateLimited, never>;
+//# sourceMappingURL=rateLimits.d.ts.map

package/dist/rateLimits.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rateLimits.d.ts","sourceRoot":"","sources":["../src/rateLimits.ts"],"names":[],"mappings":"AAAA,OAAO,EAAS,QAAQ,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,CAAC;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,UAAU;;;;sBAYN,kBAAkB,CAAC,kBAAkB;qBAPhC,MAAM;EA0B9B;AAED,MAAM,MAAM,UAAU,GAAG,UAAU,CAAC,OAAO,UAAU,CAAC,CAAC;AAEvD,eAAO,MAAM,eAAe,2HAQ1B,CAAC"}

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/requests.d.ts

@@ -0,0 +1,9 @@
+import { Effect } from "effect";
+import { type HttpClient, HttpClientRequest } from "effect/http";
+import { ResponseBodyTooLarge } from "@shivaedev/platform/http-client/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";
+export declare function requests(client: HttpClient.HttpClient, token: GitHubToken["Service"], rates: RateLimits): (input: HttpClientRequest.HttpClientRequest, limit: number) => Effect.Effect<CachedResponse, import("./errors.ts").GitHubAppError | import("./errors.ts").GitHubRateLimited | GitHubTransportError | ResponseBodyTooLarge | import("@shivaedev/platform/http-client/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,EAAY,MAAM,EAAoB,MAAM,QAAQ,CAAC;AAC5D,OAAO,EAAE,KAAK,UAAU,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAEjE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,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,EAAmB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAGnE,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,CAAC,UAAU,EAAE,KAAK,EAAE,WAAW,CAAC,SAAS,CAAC,EAAE,KAAK,EAAE,UAAU,6SA0CvG"}