@async/github-app 0.1.1

package/dist/app.js

@@ -0,0 +1,42 @@
+export const asyncGithubApp = {
+    slug: "async-github-app",
+    installUrl: "https://github.com/apps/async-github-app/installations/new",
+    callbackUrl: "https://async.dev/github/callback",
+    webhookEvents: [
+        "push",
+        "create",
+        "delete",
+        "pull_request",
+        "installation",
+        "installation_repositories"
+    ],
+    permissions: {
+        contents: "write",
+        metadata: "read",
+        pull_requests: "write"
+    }
+};
+export function defineGithubApp(options = {}) {
+    const metadata = {
+        ...asyncGithubApp,
+        ...options.metadata,
+        permissions: {
+            ...asyncGithubApp.permissions,
+            ...options.metadata?.permissions
+        },
+        webhookEvents: options.metadata?.webhookEvents ?? asyncGithubApp.webhookEvents
+    };
+    return {
+        metadata,
+        auth: options.auth,
+        permissions: {
+            ...metadata.permissions,
+            ...options.permissions
+        },
+        endpoints: {
+            install: metadata.installUrl,
+            callback: metadata.callbackUrl,
+            ...options.endpoints
+        }
+    };
+}

package/dist/auth.d.ts

@@ -0,0 +1,15 @@
+import type { ActionsBridgeAuthOptions, GitHubAppAuthOptions, GitHubAuthProvider, TokenAuthOptions } from "./types.js";
+export declare class GitHubAuthError extends Error {
+    constructor(message: string);
+}
+export declare function staticTokenAuth(options: TokenAuthOptions): GitHubAuthProvider;
+export declare function githubUserAuth(options: TokenAuthOptions): GitHubAuthProvider;
+export declare function actionsBridgeAuth(options?: ActionsBridgeAuthOptions): GitHubAuthProvider;
+export declare function githubAppAuth(options: GitHubAppAuthOptions): GitHubAuthProvider;
+export interface CreateGitHubAppJwtOptions {
+    readonly appId: string | number;
+    readonly privateKey: string;
+    readonly now?: () => Date;
+}
+export declare function createGitHubAppJwt(options: CreateGitHubAppJwtOptions): string;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAElB,gBAAgB,EACjB,MAAM,YAAY,CAAC;AAGpB,qBAAa,eAAgB,SAAQ,KAAK;gBAC5B,OAAO,EAAE,MAAM;CAI5B;AAOD,wBAAgB,eAAe,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAY7E;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,kBAAkB,CAK5E;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,wBAA6B,GAAG,kBAAkB,CAgB5F;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,oBAAoB,GAAG,kBAAkB,CAwD/E;AAED,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,IAAI,CAAC;CAC3B;AAED,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,yBAAyB,GAAG,MAAM,CAe7E"}

package/dist/auth.js

@@ -0,0 +1,101 @@
+import { createSign } from "node:crypto";
+import { base64Url, DEFAULT_GITHUB_API_BASE_URL, redactSensitive } from "./util.js";
+export class GitHubAuthError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "GitHubAuthError";
+    }
+}
+export function staticTokenAuth(options) {
+    return {
+        kind: "static-token",
+        baseUrl: options.baseUrl ?? DEFAULT_GITHUB_API_BASE_URL,
+        async getToken() {
+            if (!options.token) {
+                throw new GitHubAuthError("A non-empty GitHub token is required.");
+            }
+            return options.token;
+        }
+    };
+}
+export function githubUserAuth(options) {
+    return {
+        ...staticTokenAuth(options),
+        kind: "github-user"
+    };
+}
+export function actionsBridgeAuth(options = {}) {
+    const tokenEnv = options.tokenEnv ?? "GITHUB_TOKEN";
+    const env = options.env ?? process.env;
+    return {
+        kind: "actions-bridge",
+        baseUrl: options.baseUrl ?? DEFAULT_GITHUB_API_BASE_URL,
+        async getToken() {
+            const token = env[tokenEnv];
+            if (!token) {
+                throw new GitHubAuthError(`Missing ${tokenEnv}; Actions bridge mode needs a repo-local GitHub token.`);
+            }
+            return token;
+        }
+    };
+}
+export function githubAppAuth(options) {
+    const apiFetch = options.fetch ?? fetch;
+    const now = options.now ?? (() => new Date());
+    let cached;
+    return {
+        kind: "github-app-installation",
+        baseUrl: options.baseUrl ?? DEFAULT_GITHUB_API_BASE_URL,
+        async getToken(scope) {
+            const currentMs = now().getTime();
+            if (cached && cached.expiresAtMs - 60_000 > currentMs) {
+                return cached.token;
+            }
+            const jwt = createGitHubAppJwt({
+                appId: options.appId,
+                privateKey: options.privateKey,
+                now
+            });
+            const init = {
+                method: "POST",
+                headers: {
+                    accept: "application/vnd.github+json",
+                    authorization: `Bearer ${jwt}`,
+                    "content-type": "application/json",
+                    "x-github-api-version": "2022-11-28"
+                }
+            };
+            if (scope?.permissions) {
+                init.body = JSON.stringify({ permissions: scope.permissions });
+            }
+            const response = await apiFetch(`${this.baseUrl}/app/installations/${encodeURIComponent(String(options.installationId))}/access_tokens`, init);
+            if (!response.ok) {
+                throw new GitHubAuthError(`GitHub installation token exchange failed with ${response.status}: ${redactSensitive(await response.text())}`);
+            }
+            const payload = await response.json();
+            if (!payload.token || !payload.expires_at) {
+                throw new GitHubAuthError("GitHub installation token exchange returned an invalid payload.");
+            }
+            cached = {
+                token: payload.token,
+                expiresAtMs: Date.parse(payload.expires_at)
+            };
+            return payload.token;
+        }
+    };
+}
+export function createGitHubAppJwt(options) {
+    const nowSeconds = Math.floor((options.now?.() ?? new Date()).getTime() / 1000);
+    const header = base64Url(JSON.stringify({ alg: "RS256", typ: "JWT" }));
+    const payload = base64Url(JSON.stringify({
+        iat: nowSeconds - 60,
+        exp: nowSeconds + 540,
+        iss: String(options.appId)
+    }));
+    const signingInput = `${header}.${payload}`;
+    const signer = createSign("RSA-SHA256");
+    signer.update(signingInput);
+    signer.end();
+    const signature = signer.sign(options.privateKey);
+    return `${signingInput}.${base64Url(signature)}`;
+}

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,85 @@
+#!/usr/bin/env node
+import { applyActionsBridge, renderActionsBridgeWorkflow } from "./actions.js";
+import { redactSensitive } from "./util.js";
+async function main(argv) {
+    const [scope, command, ...rest] = argv;
+    if (scope !== "actions") {
+        usage();
+        process.exitCode = 1;
+        return;
+    }
+    if (command === "render-workflow") {
+        const endpoint = readFlag(rest, "--endpoint");
+        const branchPrefix = readFlag(rest, "--branch-prefix");
+        const pullRequest = parseOptionalBooleanFlag(rest, "--pull-request");
+        const allowedPathGlobs = readFlags(rest, "--allowed-path");
+        process.stdout.write(renderActionsBridgeWorkflow({
+            ...(endpoint ? { asyncEndpoint: endpoint } : {}),
+            ...(branchPrefix ? { branchPrefix } : {}),
+            ...(pullRequest !== undefined ? { pullRequest } : {}),
+            ...(allowedPathGlobs.length > 0 ? { allowedPathGlobs } : {})
+        }));
+        return;
+    }
+    if (command === "pull") {
+        const endpoint = readFlag(rest, "--endpoint") ?? process.env.ASYNC_PROJECT_URL;
+        const projectToken = process.env.ASYNC_PROJECT_TOKEN;
+        const repository = process.env.GITHUB_REPOSITORY;
+        const branchPrefix = readFlag(rest, "--branch-prefix");
+        const pullRequest = parseOptionalBooleanFlag(rest, "--pull-request");
+        const allowedPathGlobs = readFlags(rest, "--allowed-path");
+        if (!endpoint || !projectToken || !repository) {
+            throw new Error("actions pull requires ASYNC_PROJECT_URL, ASYNC_PROJECT_TOKEN, and GITHUB_REPOSITORY.");
+        }
+        const result = await applyActionsBridge({
+            endpoint,
+            projectToken,
+            repository,
+            ...(branchPrefix ? { branchPrefix } : {}),
+            ...(pullRequest !== undefined ? { pullRequest } : {}),
+            ...(allowedPathGlobs.length > 0 ? { allowedPathGlobs } : {})
+        });
+        process.stdout.write(`${JSON.stringify(result)}\n`);
+        return;
+    }
+    usage();
+    process.exitCode = 1;
+}
+function readFlag(args, name) {
+    const index = args.indexOf(name);
+    if (index === -1) {
+        return undefined;
+    }
+    return args[index + 1];
+}
+function readFlags(args, name) {
+    const values = [];
+    for (let index = 0; index < args.length; index += 1) {
+        const value = args[index + 1];
+        if (args[index] === name && value) {
+            values.push(value);
+            index += 1;
+        }
+    }
+    return values;
+}
+function parseOptionalBooleanFlag(args, name) {
+    const value = readFlag(args, name);
+    if (value === undefined)
+        return undefined;
+    if (value === "true")
+        return true;
+    if (value === "false")
+        return false;
+    throw new Error(`${name} must be true or false.`);
+}
+function usage() {
+    process.stderr.write(`Usage:
+  async-github-app actions render-workflow [--endpoint <url>] [--branch-prefix <prefix>] [--allowed-path <glob>...] [--pull-request true|false]
+  async-github-app actions pull [--endpoint <url>] [--branch-prefix <prefix>] [--allowed-path <glob>...] [--pull-request true|false]
+`);
+}
+main(process.argv.slice(2)).catch((error) => {
+    process.stderr.write(`${redactSensitive(error instanceof Error ? error.message : error)}\n`);
+    process.exitCode = 1;
+});

package/dist/content.d.ts

@@ -0,0 +1,42 @@
+export type ContentFormat = "json" | "jsonc" | "markdown" | "mdx";
+export interface JsonRenderOptions {
+    readonly indent?: number;
+}
+export interface JsoncRenderOptions extends JsonRenderOptions {
+    readonly allowWrite?: boolean;
+}
+export interface MarkdownOptions {
+    readonly bodyField?: string;
+}
+export interface ContentMappingOptions {
+    readonly resource: string;
+    readonly pattern: string;
+    readonly format: ContentFormat;
+    readonly idFromPath?: (path: string) => string;
+    readonly pathFromRecord?: (record: Record<string, unknown>) => string;
+    readonly bodyField?: string;
+}
+export interface ContentMapping {
+    readonly resource: string;
+    readonly pattern: string;
+    readonly format: ContentFormat;
+    readonly bodyField: string;
+    idFromPath(path: string): string;
+    pathFromRecord(record: Record<string, unknown>): string;
+    parse(source: string): unknown;
+    serialize(record: unknown): string;
+}
+export declare class JsoncWriteError extends Error {
+    constructor();
+}
+export declare function parseJsonContent<T = unknown>(source: string): T;
+export declare function renderJsonContent(value: unknown, options?: JsonRenderOptions): string;
+export declare function parseJsoncContent<T = unknown>(source: string): T;
+export declare function renderJsoncContent(value: unknown, options?: JsoncRenderOptions): string;
+export declare function parseMarkdownRecord(source: string, options?: MarkdownOptions): Record<string, unknown>;
+export declare function renderMarkdownRecord(record: Record<string, unknown>, options?: MarkdownOptions): string;
+export declare const parseMdxRecord: typeof parseMarkdownRecord;
+export declare const renderMdxRecord: typeof renderMarkdownRecord;
+export declare function contentMapping(options: ContentMappingOptions): ContentMapping;
+export declare function stripJsonc(source: string): string;
+//# sourceMappingURL=content.d.ts.map

package/dist/content.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../src/content.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,OAAO,GAAG,UAAU,GAAG,KAAK,CAAC;AAElE,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,MAAM,WAAW,kBAAmB,SAAQ,iBAAiB;IAC3D,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAC;IAC/C,QAAQ,CAAC,cAAc,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,MAAM,CAAC;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACjC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC;IACxD,KAAK,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC;IAC/B,SAAS,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;CACpC;AAED,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED,wBAAgB,gBAAgB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAE/D;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,iBAAsB,GAAG,MAAM,CAEzF;AAED,wBAAgB,iBAAiB,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,CAAC,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,kBAAuB,GAAG,MAAM,CAM3F;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAO1G;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,GAAE,eAAoB,GAAG,MAAM,CAc3G;AAED,eAAO,MAAM,cAAc,4BAAsB,CAAC;AAClD,eAAO,MAAM,eAAe,6BAAuB,CAAC;AAEpD,wBAAgB,cAAc,CAAC,OAAO,EAAE,qBAAqB,GAAG,cAAc,CA6C7E;AAED,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CA+DjD"}

package/dist/content.js

@@ -0,0 +1,269 @@
+import { ensureTrailingNewline, hasOwn } from "./util.js";
+export class JsoncWriteError extends Error {
+    constructor() {
+        super("JSONC writes are disabled by default because comments and formatting cannot be preserved safely. Pass allowWrite: true to render canonical JSON content intentionally.");
+        this.name = "JsoncWriteError";
+    }
+}
+export function parseJsonContent(source) {
+    return JSON.parse(source);
+}
+export function renderJsonContent(value, options = {}) {
+    return ensureTrailingNewline(JSON.stringify(value, null, options.indent ?? 2));
+}
+export function parseJsoncContent(source) {
+    return JSON.parse(stripJsonc(source));
+}
+export function renderJsoncContent(value, options = {}) {
+    if (!options.allowWrite) {
+        throw new JsoncWriteError();
+    }
+    return renderJsonContent(value, options);
+}
+export function parseMarkdownRecord(source, options = {}) {
+    const bodyField = options.bodyField ?? "body";
+    const { data, body } = splitFrontmatter(source);
+    return {
+        ...data,
+        [bodyField]: body
+    };
+}
+export function renderMarkdownRecord(record, options = {}) {
+    const bodyField = options.bodyField ?? "body";
+    const body = typeof record[bodyField] === "string" ? record[bodyField] : "";
+    const frontmatter = Object.keys(record)
+        .filter((key) => key !== bodyField && record[key] !== undefined)
+        .sort()
+        .map((key) => `${key}: ${renderFrontmatterScalar(record[key])}`)
+        .join("\n");
+    if (!frontmatter) {
+        return ensureTrailingNewline(body);
+    }
+    return ensureTrailingNewline(`---\n${frontmatter}\n---\n${body}`);
+}
+export const parseMdxRecord = parseMarkdownRecord;
+export const renderMdxRecord = renderMarkdownRecord;
+export function contentMapping(options) {
+    const bodyField = options.bodyField ?? "body";
+    const compiled = compilePattern(options.pattern);
+    return {
+        resource: options.resource,
+        pattern: options.pattern,
+        format: options.format,
+        bodyField,
+        idFromPath: options.idFromPath ?? ((path) => {
+            const match = compiled.match(path);
+            if (!match) {
+                throw new Error(`Path "${path}" does not match content mapping pattern "${options.pattern}".`);
+            }
+            return match.id ?? Object.values(match)[0] ?? path;
+        }),
+        pathFromRecord: options.pathFromRecord ?? ((record) => compiled.fill(record)),
+        parse(source) {
+            if (options.format === "json") {
+                return parseJsonContent(source);
+            }
+            if (options.format === "jsonc") {
+                return parseJsoncContent(source);
+            }
+            return parseMarkdownRecord(source, { bodyField });
+        },
+        serialize(record) {
+            if (options.format === "json") {
+                return renderJsonContent(record);
+            }
+            if (options.format === "jsonc") {
+                return renderJsoncContent(record);
+            }
+            if (!isRecord(record)) {
+                throw new Error(`${options.format.toUpperCase()} content mappings require object records.`);
+            }
+            return renderMarkdownRecord(record, { bodyField });
+        }
+    };
+}
+export function stripJsonc(source) {
+    let output = "";
+    let inString = false;
+    let escaped = false;
+    let lineComment = false;
+    let blockComment = false;
+    for (let index = 0; index < source.length; index += 1) {
+        const current = source[index] ?? "";
+        const next = source[index + 1] ?? "";
+        if (lineComment) {
+            if (current === "\n") {
+                lineComment = false;
+                output += current;
+            }
+            continue;
+        }
+        if (blockComment) {
+            if (current === "*" && next === "/") {
+                blockComment = false;
+                index += 1;
+            }
+            else if (current === "\n") {
+                output += "\n";
+            }
+            continue;
+        }
+        if (inString) {
+            output += current;
+            if (escaped) {
+                escaped = false;
+            }
+            else if (current === "\\") {
+                escaped = true;
+            }
+            else if (current === "\"") {
+                inString = false;
+            }
+            continue;
+        }
+        if (current === "\"") {
+            inString = true;
+            output += current;
+            continue;
+        }
+        if (current === "/" && next === "/") {
+            lineComment = true;
+            index += 1;
+            continue;
+        }
+        if (current === "/" && next === "*") {
+            blockComment = true;
+            index += 1;
+            continue;
+        }
+        output += current;
+    }
+    return removeTrailingCommas(output);
+}
+function removeTrailingCommas(source) {
+    let output = "";
+    let inString = false;
+    let escaped = false;
+    for (let index = 0; index < source.length; index += 1) {
+        const current = source[index] ?? "";
+        if (inString) {
+            output += current;
+            if (escaped) {
+                escaped = false;
+            }
+            else if (current === "\\") {
+                escaped = true;
+            }
+            else if (current === "\"") {
+                inString = false;
+            }
+            continue;
+        }
+        if (current === "\"") {
+            inString = true;
+            output += current;
+            continue;
+        }
+        if (current === ",") {
+            const rest = source.slice(index + 1);
+            if (/^\s*[}\]]/u.test(rest)) {
+                continue;
+            }
+        }
+        output += current;
+    }
+    return output;
+}
+function splitFrontmatter(source) {
+    if (!source.startsWith("---\n")) {
+        return { data: {}, body: source };
+    }
+    const end = source.indexOf("\n---", 4);
+    if (end === -1) {
+        return { data: {}, body: source };
+    }
+    const rawFrontmatter = source.slice(4, end);
+    const bodyStart = source[end + 4] === "\n" ? end + 5 : end + 4;
+    return {
+        data: parseFrontmatter(rawFrontmatter),
+        body: source.slice(bodyStart)
+    };
+}
+function parseFrontmatter(source) {
+    const data = {};
+    for (const line of source.split(/\r?\n/u)) {
+        if (!line.trim() || line.trimStart().startsWith("#")) {
+            continue;
+        }
+        const separator = line.indexOf(":");
+        if (separator === -1) {
+            continue;
+        }
+        const key = line.slice(0, separator).trim();
+        const value = line.slice(separator + 1).trim();
+        if (key) {
+            data[key] = parseFrontmatterScalar(value);
+        }
+    }
+    return data;
+}
+function parseFrontmatterScalar(value) {
+    if (value === "true") {
+        return true;
+    }
+    if (value === "false") {
+        return false;
+    }
+    if (value === "null") {
+        return null;
+    }
+    if (/^-?\d+(?:\.\d+)?$/u.test(value)) {
+        return Number(value);
+    }
+    if ((value.startsWith("\"") && value.endsWith("\"")) ||
+        value.startsWith("[") ||
+        value.startsWith("{")) {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+function renderFrontmatterScalar(value) {
+    if (typeof value === "string") {
+        return JSON.stringify(value);
+    }
+    if (typeof value === "number" || typeof value === "boolean" || value === null) {
+        return String(value);
+    }
+    return JSON.stringify(value);
+}
+function compilePattern(pattern) {
+    const placeholders = [...pattern.matchAll(/\{([A-Za-z_][A-Za-z0-9_]*)\}/gu)].map((match) => match[1]);
+    const regexSource = pattern
+        .replace(/[.+?^${}()|[\]\\]/gu, "\\$&")
+        .replace(/\\\{([A-Za-z_][A-Za-z0-9_]*)\\\}/gu, "(?<$1>[^/]+)");
+    const regex = new RegExp(`^${regexSource}$`, "u");
+    return {
+        match(path) {
+            const matched = regex.exec(path);
+            return matched?.groups;
+        },
+        fill(record) {
+            let path = pattern;
+            for (const placeholder of placeholders) {
+                if (!hasOwn(record, placeholder) || record[placeholder] === undefined) {
+                    throw new Error(`Record is missing "${placeholder}" required by content mapping pattern "${pattern}".`);
+                }
+                path = path.replaceAll(`{${placeholder}}`, encodeURIComponent(String(record[placeholder])));
+            }
+            return path;
+        }
+    };
+}
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}

package/dist/github.d.ts

@@ -0,0 +1,11 @@
+import type { GitHubAuthProvider, GitHubClient, GitHubRepo, GitHubRepoInput } from "./types.js";
+export declare class GitHubApiError extends Error {
+    readonly status: number;
+    readonly method: string;
+    readonly path: string;
+    constructor(message: string, status: number, method: string, path: string);
+}
+export declare function createGitHubClient(auth: GitHubAuthProvider): GitHubClient;
+export declare function parseGitHubRepo(input: GitHubRepoInput): GitHubRepo;
+export declare function formatGitHubRepo(input: GitHubRepoInput): string;
+//# 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,KAAK,EASV,kBAAkB,EAClB,YAAY,EACZ,UAAU,EACV,eAAe,EAMhB,MAAM,YAAY,CAAC;AAIpB,qBAAa,cAAe,SAAQ,KAAK;IAGrC,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM;IACvB,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAHrB,OAAO,EAAE,MAAM,EACN,MAAM,EAAE,MAAM,EACd,MAAM,EAAE,MAAM,EACd,IAAI,EAAE,MAAM;CAKxB;AAED,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CA2CzE;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,UAAU,CAWlE;AAED,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAG/D"}