@skuba-lib/api 2.2.0 → 3.0.0-add-cdk-NodejsFunction-20260620003026

package/lib/github-D12IboDc.cjs

@@ -1,296 +0,0 @@
-const require_rolldown_runtime = require("./rolldown-runtime-DakpK96I.cjs");
-const require_error = require("./error-BnrwrJEG.cjs");
-const require_git = require("./git-D98vomnD.cjs");
-let fs_extra = require("fs-extra");
-fs_extra = require_rolldown_runtime.__toESM(fs_extra, 1);
-let path = require("path");
-path = require_rolldown_runtime.__toESM(path, 1);
-//#region src/github/octokit.ts
-const createRestClient = async (options) => new (await (import("@octokit/rest"))).Octokit(options);
-const graphql = async (query, parameters) => (await import("@octokit/graphql")).graphql(query, parameters);
-//#endregion
-//#region src/github/checkRun.ts
-const GITHUB_MAX_ANNOTATIONS = 50;
-/**
-* Suffixes the title with the number of annotations added, e.g.
-*
-* ```text
-* Build #12 failed (24 annotations added)
-* ```
-*/
-const suffixTitle = (title, inputAnnotations) => {
-	return `${title} (${require_error.pluralise(inputAnnotations > GITHUB_MAX_ANNOTATIONS ? GITHUB_MAX_ANNOTATIONS : inputAnnotations, "annotation")} added)`;
-};
-/**
-* Enriches the summary with more context about the check run.
-*/
-const createEnrichedSummary = (summary, inputAnnotations) => [summary, ...inputAnnotations > GITHUB_MAX_ANNOTATIONS ? [`${inputAnnotations} annotations were provided, but only the first ${GITHUB_MAX_ANNOTATIONS} are visible in GitHub.`] : []].join("\n\n");
-/**
-* Asynchronously creates a GitHub check run with annotations.
-*
-* The first 50 `annotations` are written in full to GitHub.
-*
-* A `GITHUB_API_TOKEN` or `GITHUB_TOKEN` with the `checks:write` permission
-* must be present on the environment.
-*/
-const createCheckRun = async ({ annotations, conclusion, name, summary, text, title }) => {
-	const dir = process.cwd();
-	const [commitId, { owner, repo }] = await Promise.all([require_git.getHeadCommitId({ dir }), require_git.getOwnerAndRepo({ dir })]);
-	await (await createRestClient({ auth: require_git.apiTokenFromEnvironment() })).checks.create({
-		conclusion,
-		head_sha: commitId,
-		name,
-		output: {
-			annotations: annotations.slice(0, GITHUB_MAX_ANNOTATIONS),
-			summary: createEnrichedSummary(summary, annotations.length),
-			text,
-			title: suffixTitle(title, annotations.length)
-		},
-		owner,
-		repo
-	});
-};
-//#endregion
-//#region src/github/pullRequest.ts
-/**
-* Gets the number of the current pull request.
-*
-* This tries to extract the pull request from common CI environment variables,
-* and falls back to querying the GitHub Repos API for the latest pull request
-* associated with the head commit. An error is thrown if there are no
-* associated pull requests, or if they are all closed or locked.
-*/
-const getPullRequestNumber = async (params = {}) => {
-	const env = params.env ?? process.env;
-	const dir = process.cwd();
-	const number = Number(env.BUILDKITE_PULL_REQUEST ?? env.GITHUB_REF?.replace(/^refs\/pull\/(\d+)\/.*$/, "$1"));
-	if (Number.isSafeInteger(number)) return number;
-	const client = params.client ?? await createRestClient({ auth: require_git.apiTokenFromEnvironment() });
-	const [commitId, { owner, repo }] = await Promise.all([require_git.getHeadCommitId({
-		dir,
-		env
-	}), require_git.getOwnerAndRepo({ dir })]);
-	const pullRequestData = (await client.repos.listPullRequestsAssociatedWithCommit({
-		commit_sha: commitId,
-		owner,
-		repo
-	})).data.filter((pr) => pr.state === "open" && !pr.locked).sort((a, b) => b.updated_at.localeCompare(a.updated_at))[0];
-	if (!pullRequestData) throw new Error(`Commit ${commitId} is not associated with an open GitHub pull request`);
-	return pullRequestData.number;
-};
-//#endregion
-//#region src/github/issueComment.ts
-const getUserId = async (client) => {
-	const { data } = await client.users.getAuthenticated();
-	return data.id;
-};
-/**
-* Asynchronously creates or updates a GitHub issue comment.
-*
-* This emulates `put` behaviour by overwriting the first existing comment by
-* the same author on the issue, enabling use cases like a persistent bot
-* comment at the top of the pull request that reflects the current status of a
-* CI check.
-*
-* A `GITHUB_API_TOKEN` or `GITHUB_TOKEN` with write permissions must be present
-* on the environment.
-*/
-const putIssueComment = async (params) => {
-	if (params.body === null && !params.internalId) throw new Error("Cannot remove comment without an internalId");
-	const env = params.env ?? process.env;
-	const dir = process.cwd();
-	const { owner, repo } = await require_git.getOwnerAndRepo({ dir });
-	const client = await createRestClient({ auth: require_git.apiTokenFromEnvironment() });
-	const issueNumber = params.issueNumber ?? await getPullRequestNumber({
-		client,
-		env
-	});
-	if (!issueNumber) throw new Error("Failed to infer an issue number");
-	const comments = await client.issues.listComments({
-		issue_number: issueNumber,
-		owner,
-		repo
-	});
-	const userId = params.userId === "seek-build-agency" ? 87109344 : params.userId ?? await getUserId(client);
-	const commentId = comments.data.find((comment) => comment.user?.id === userId && (params.internalId ? comment.body?.endsWith(`\n\n<!-- ${params.internalId} -->`) : true))?.id;
-	if (params.body === null) {
-		if (commentId) await client.issues.deleteComment({
-			comment_id: commentId,
-			owner,
-			repo
-		});
-		return null;
-	}
-	const body = params.internalId ? [params.body.trim(), `<!-- ${params.internalId} -->`].join("\n\n") : params.body.trim();
-	return { id: (await (commentId ? client.issues.updateComment({
-		body,
-		comment_id: commentId,
-		issue_number: issueNumber,
-		owner,
-		repo
-	}) : client.issues.createComment({
-		body,
-		issue_number: issueNumber,
-		owner,
-		repo
-	}))).data.id };
-};
-//#endregion
-//#region src/github/push.ts
-/**
-* Retrieves all file changes from the local Git repository using
-* `getChangedFiles`, then uploads the changes to a specified GitHub branch
-* using `uploadFileChanges`.
-*
-* Returns the commit ID, or `undefined` if there are no changes to commit.
-*
-* The file changes will appear as verified commits on GitHub.
-*
-* This will not update the local Git repository unless `updateLocal` is
-* specified.
-*/
-const uploadAllFileChanges = async ({ branch, dir, messageHeadline, ignore, messageBody, updateLocal = false }) => {
-	const changedFiles = await require_git.getChangedFiles({
-		dir,
-		ignore
-	});
-	if (!changedFiles.length) return;
-	const fileChanges = await readFileChanges(dir, changedFiles);
-	const commitId = await uploadFileChanges({
-		dir,
-		branch,
-		messageHeadline,
-		messageBody,
-		fileChanges
-	});
-	if (updateLocal) {
-		await Promise.all([...fileChanges.additions, ...fileChanges.deletions].map((file) => fs_extra.default.rm(file.path)));
-		await require_git.fastForwardBranch({
-			ref: branch,
-			auth: { type: "gitHubApp" },
-			dir
-		});
-	}
-	return commitId;
-};
-/**
-* Takes a list of `ChangedFiles`, reads them from the file system, and maps
-* them to GitHub GraphQL `FileChanges`.
-*
-* https://docs.github.com/en/graphql/reference/input-objects#filechanges
-*/
-const readFileChanges = async (dir, changedFiles) => {
-	const { added, deleted } = changedFiles.reduce((files, changedFile) => {
-		const filePath = changedFile.path;
-		if (changedFile.state === "deleted") files.deleted.push(filePath);
-		else files.added.push(filePath);
-		return files;
-	}, {
-		added: [],
-		deleted: []
-	});
-	const gitRoot = await require_git.findRoot({ dir });
-	const toRootPath = (filePath) => {
-		if (!gitRoot) return filePath;
-		return path.default.resolve(gitRoot, filePath);
-	};
-	return {
-		additions: await Promise.all(added.map(async (filePath) => ({
-			path: filePath,
-			contents: await fs_extra.default.promises.readFile(toRootPath(filePath), { encoding: "base64" })
-		}))),
-		deletions: deleted.map((filePath) => ({ path: filePath }))
-	};
-};
-/**
-* Uploads file changes from the local workspace to a specified GitHub branch.
-*
-* The file changes will appear as verified commits on GitHub.
-*
-* This will not update the local Git repository.
-*/
-const uploadFileChanges = async ({ dir, branch, messageHeadline, messageBody, fileChanges }) => {
-	const authToken = require_git.apiTokenFromEnvironment();
-	if (!authToken) throw new Error("Could not read a GitHub API token from the environment. Please set GITHUB_API_TOKEN or GITHUB_TOKEN.");
-	const [{ owner, repo }, headCommitId] = await Promise.all([require_git.getOwnerAndRepo({ dir }), require_git.getHeadCommitId({ dir })]);
-	return (await graphql(`
-      mutation Mutation($input: CreateCommitOnBranchInput!) {
-        createCommitOnBranch(input: $input) {
-          commit {
-            oid
-          }
-        }
-      }
-    `, {
-		input: {
-			branch: {
-				repositoryNameWithOwner: `${owner}/${repo}`,
-				branchName: branch
-			},
-			message: {
-				headline: messageHeadline,
-				body: messageBody
-			},
-			expectedHeadOid: headCommitId,
-			clientMutationId: "skuba",
-			fileChanges
-		},
-		headers: { authorization: `Bearer ${authToken}` }
-	})).createCommitOnBranch.commit.oid;
-};
-//#endregion
-//#region src/github/index.ts
-var github_exports = /* @__PURE__ */ require_rolldown_runtime.__exportAll({
-	apiTokenFromEnvironment: () => require_git.apiTokenFromEnvironment,
-	buildNameFromEnvironment: () => require_git.buildNameFromEnvironment,
-	createCheckRun: () => createCheckRun,
-	enabledFromEnvironment: () => require_git.enabledFromEnvironment,
-	getPullRequestNumber: () => getPullRequestNumber,
-	putIssueComment: () => putIssueComment,
-	readFileChanges: () => readFileChanges,
-	uploadAllFileChanges: () => uploadAllFileChanges,
-	uploadFileChanges: () => uploadFileChanges
-});
-//#endregion
-Object.defineProperty(exports, "createCheckRun", {
-	enumerable: true,
-	get: function() {
-		return createCheckRun;
-	}
-});
-Object.defineProperty(exports, "getPullRequestNumber", {
-	enumerable: true,
-	get: function() {
-		return getPullRequestNumber;
-	}
-});
-Object.defineProperty(exports, "github_exports", {
-	enumerable: true,
-	get: function() {
-		return github_exports;
-	}
-});
-Object.defineProperty(exports, "putIssueComment", {
-	enumerable: true,
-	get: function() {
-		return putIssueComment;
-	}
-});
-Object.defineProperty(exports, "readFileChanges", {
-	enumerable: true,
-	get: function() {
-		return readFileChanges;
-	}
-});
-Object.defineProperty(exports, "uploadAllFileChanges", {
-	enumerable: true,
-	get: function() {
-		return uploadAllFileChanges;
-	}
-});
-Object.defineProperty(exports, "uploadFileChanges", {
-	enumerable: true,
-	get: function() {
-		return uploadFileChanges;
-	}
-});

package/lib/index-C9WMO_Y9.d.cts

@@ -1,278 +0,0 @@
-//#region src/git/commit.d.ts
-interface Identity {
-  email?: string;
-  name?: string;
-}
-interface CommitParameters {
-  author?: Identity;
-  committer?: Identity;
-  dir: string;
-  message: string;
-}
-/**
- * Writes a commit to the local Git repository.
- */
-declare const commit: ({
-  author,
-  committer,
-  dir,
-  message
-}: CommitParameters) => Promise<string>;
-//#endregion
-//#region src/git/getChangedFiles.d.ts
-type ChangedFileState = 'added' | 'modified' | 'deleted';
-interface ChangedFile {
-  path: string;
-  state: ChangedFileState;
-}
-interface ChangedFilesParameters {
-  dir: string;
-  /**
-   * File changes to exclude from the result.
-   *
-   * Defaults to `[]` (no exclusions).
-   */
-  ignore?: ChangedFile[];
-}
-/**
- * Returns all the files which have been added, modified or deleted in the
- * working directory of the local Git repository since the last commit.
- */
-declare const getChangedFiles: ({
-  dir,
-  ignore
-}: ChangedFilesParameters) => Promise<ChangedFile[]>;
-//#endregion
-//#region src/git/commitAllChanges.d.ts
-interface CommitAllParameters {
-  dir: string;
-  message: string;
-  author?: Identity;
-  committer?: Identity;
-  /**
-   * File changes to exclude from the commit.
-   *
-   * Defaults to `[]` (no exclusions).
-   */
-  ignore?: ChangedFile[];
-}
-/**
- * Stages all changes and writes a commit to the local Git repository.
- */
-declare const commitAllChanges: ({
-  dir,
-  message,
-  author,
-  committer,
-  ignore
-}: CommitAllParameters) => Promise<string | undefined>;
-//#endregion
-//#region src/git/currentBranch.d.ts
-interface CurrentBranchParameters {
-  dir?: string;
-  env?: Record<string, string | undefined>;
-}
-/**
- * Tries to return a Git branch name from CI environment variables, falling back
- * to the local Git repository when the current working `dir` is supplied.
- */
-declare const currentBranch: ({
-  dir,
-  env
-}?: CurrentBranchParameters) => Promise<string | undefined>;
-//#endregion
-//#region src/git/findRoot.d.ts
-interface FindRootParameters {
-  dir: string;
-}
-/**
- * Returns the first Git root directory encountered walking up from the provided
- * `dir`.
- */
-declare const findRoot: ({
-  dir
-}: FindRootParameters) => Promise<string | null>;
-//#endregion
-//#region src/git/log.d.ts
-interface GetHeadCommitParameters {
-  dir: string;
-  env?: Record<string, string | undefined>;
-}
-/**
- * Gets the object ID of the head commit.
- *
- * This tries to extract the commit ID from common CI environment variables,
- * and falls back to the local Git repository log.
- */
-declare const getHeadCommitId: ({
-  dir,
-  env
-}: GetHeadCommitParameters) => Promise<string>;
-/**
- * Gets the message of the head commit.
- *
- * This tries to extract the message from common CI environment variables,
- * and falls back to the local Git repository log.
- */
-declare const getHeadCommitMessage: ({
-  dir,
-  env
-}: GetHeadCommitParameters) => Promise<string>;
-//#endregion
-//#region src/git/remote.d.ts
-interface GetOwnerAndRepoParameters {
-  dir: string;
-  env?: Record<string, string | undefined>;
-}
-/**
- * Extracts the owner and repository names from CI environment variables,
- * falling back to local Git remotes.
- *
- * Currently, only GitHub repository URLs are supported:
- *
- * ```console
- * git@github.com:seek-oss/skuba.git
- * https://github.com/seek-oss/skuba.git
- * ```
- */
-declare const getOwnerAndRepo: ({
-  dir,
-  env
-}: GetOwnerAndRepoParameters) => Promise<{
-  owner: string;
-  repo: string;
-}>;
-//#endregion
-//#region src/git/push.d.ts
-/**
- * Use a GitHub app token to auth the Git push.
- *
- * This defaults to the `GITHUB_API_TOKEN` and `GITHUB_TOKEN` environment
- * variables if `token` is not provided.
- */
-interface GitHubAppAuth$1 {
-  type: 'gitHubApp';
-  token?: string;
-}
-interface PushParameters {
-  /**
-   * The auth mechanism for the push.
-   *
-   * Currently, only GitHub app tokens are supported.
-   */
-  auth: GitHubAppAuth$1;
-  dir: string;
-  /**
-   * The reference to push to the remote.
-   *
-   * This may be a commit, branch or tag in the local repository.
-   */
-  ref: string;
-  remote?: string;
-  /**
-   * The destination branch or tag on the remote.
-   *
-   * This defaults to `ref`.
-   */
-  remoteRef?: string;
-  /**
-   * Forcefully override any conflicts.
-   *
-   * This defaults to `false`.
-   */
-  force?: boolean;
-}
-interface PushResult {
-  ok: boolean;
-  error: string | null;
-  refs: Record<string, {
-    ok: boolean;
-    error: string;
-  }>;
-  headers?: Record<string, string> | undefined;
-}
-/**
- * Pushes the specified `ref` from the local Git repository to a remote.
- */
-declare const push: ({
-  auth,
-  dir,
-  ref,
-  remote,
-  remoteRef,
-  force
-}: PushParameters) => Promise<PushResult>;
-//#endregion
-//#region src/git/pull.d.ts
-/**
- * Use a GitHub app token to auth the Git push.
- *
- * This defaults to the `GITHUB_API_TOKEN` and `GITHUB_TOKEN` environment
- * variables if `token` is not provided.
- */
-interface GitHubAppAuth {
-  type: 'gitHubApp';
-  token?: string;
-}
-interface PullParameters {
-  /**
-   * The auth mechanism for the push.
-   *
-   * Currently, only GitHub app tokens are supported.
-   */
-  auth: GitHubAppAuth;
-  dir: string;
-  /**
-   * The local branch to fast forward.
-   */
-  ref: string;
-  remote?: string;
-  /**
-   * The branch or tag on the remote to reference.
-   *
-   * This defaults to `ref`.
-   */
-  remoteRef?: string;
-}
-/**
- * Fast forwards the specified `ref` on the local Git repository to match the remote branch.
- */
-declare const fastForwardBranch: ({
-  auth,
-  dir,
-  ref,
-  remote,
-  remoteRef
-}: PullParameters) => Promise<void>;
-//#endregion
-//#region src/git/reset.d.ts
-interface ResetParameters {
-  dir: string;
-  branch: string;
-  commitId: string;
-  hard?: boolean;
-}
-/**
- * Resets the specified branch in the local Git repository to a particular
- * commit.
- */
-declare const reset: ({
-  dir,
-  branch,
-  commitId,
-  hard
-}: ResetParameters) => Promise<void>;
-//#endregion
-//#region src/git/isFileGitIgnored.d.ts
-declare const isFileGitIgnored: ({
-  absolutePath,
-  gitRoot
-}: {
-  absolutePath: string;
-  gitRoot: string;
-}) => Promise<boolean>;
-declare namespace index_d_exports {
-  export { ChangedFile, commit, commitAllChanges, currentBranch, fastForwardBranch, findRoot, getChangedFiles, getHeadCommitId, getHeadCommitMessage, getOwnerAndRepo, isFileGitIgnored, push, reset };
-}
-//#endregion
-export { push as a, getHeadCommitMessage as c, commitAllChanges as d, ChangedFile as f, fastForwardBranch as i, findRoot as l, commit as m, isFileGitIgnored as n, getOwnerAndRepo as o, getChangedFiles as p, reset as r, getHeadCommitId as s, index_d_exports as t, currentBranch as u };

package/lib/index-CNxgBJm_.d.cts

@@ -1,39 +0,0 @@
-//#region src/buildkite/annotate.d.ts
-type AnnotationStyle = 'success' | 'info' | 'warning' | 'error';
-interface AnnotationOptions {
-  context?: string;
-  /**
-   * Scopes an annotation's context to the Buildkite step ID.
-   *
-   * This lets you emit distinct annotations per step, and only takes effect if
-   * the `BUILDKITE_STEP_ID` environment variable is present.
-   */
-  scopeContextToStep?: boolean;
-  style?: AnnotationStyle;
-}
-/**
- * Asynchronously uploads a Buildkite annotation.
- *
- * If the following environment variables are not present,
- * the function will silently return without attempting to annotate:
- *
- * - `BUILDKITE`
- * - `BUILDKITE_AGENT_ACCESS_TOKEN`
- * - `BUILDKITE_JOB_ID`
- *
- * The `buildkite-agent` binary must also be on your `PATH`.
- */
-declare const annotate: (markdown: string, opts?: AnnotationOptions) => Promise<void>;
-//#endregion
-//#region src/buildkite/md.d.ts
-/**
- * @internal
- */
-declare const md: {
-  terminal: (code: string) => string;
-};
-declare namespace index_d_exports {
-  export { AnnotationStyle, annotate, md };
-}
-//#endregion
-export { annotate as i, md as n, AnnotationStyle as r, index_d_exports as t };