repo-sdk 0.1.1 → 0.1.2

package/dist/azure-devops.d.ts

@@ -1,4 +1,4 @@
-import { O as ParsedWebhookEvent, P as RepoProvider, v as IncomingWebhookRequest, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { B as TokenProvider, F as RepoProvider, O as ParsedWebhookEvent, v as IncomingWebhookRequest } from "./types-DfiRluvJ.js";
 import { t as VerifyWebhookParams$1 } from "./verify-p6JsExms.js";
 //#region src/providers/azure-devops/auth.d.ts
 /**

package/dist/bitbucket.d.ts

@@ -1,4 +1,4 @@
-import { O as ParsedWebhookEvent, P as RepoProvider, v as IncomingWebhookRequest, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { B as TokenProvider, F as RepoProvider, O as ParsedWebhookEvent, v as IncomingWebhookRequest } from "./types-DfiRluvJ.js";
 import { t as VerifyWebhookParams } from "./verify-p6JsExms.js";
 //#region src/providers/bitbucket/index.d.ts
 interface BitbucketProviderOptions {

package/dist/git-http.d.ts

@@ -1,4 +1,4 @@
-import { P as RepoProvider, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { B as TokenProvider, F as RepoProvider } from "./types-DfiRluvJ.js";
 //#region src/providers/git-http/index.d.ts
 interface GitHttpProviderOptions {
   /**

package/dist/gitea.d.ts

@@ -1,4 +1,4 @@
-import { O as ParsedWebhookEvent, P as RepoProvider, v as IncomingWebhookRequest, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { B as TokenProvider, F as RepoProvider, O as ParsedWebhookEvent, v as IncomingWebhookRequest } from "./types-DfiRluvJ.js";
 import { t as VerifyWebhookParams } from "./verify-p6JsExms.js";
 //#region src/providers/gitea/index.d.ts
 interface GiteaProviderOptions {

package/dist/github.d.ts

@@ -1,4 +1,4 @@
-import { O as ParsedWebhookEvent, P as RepoProvider, v as IncomingWebhookRequest, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { B as TokenProvider, F as RepoProvider, O as ParsedWebhookEvent, v as IncomingWebhookRequest } from "./types-DfiRluvJ.js";
 import { t as VerifyWebhookParams } from "./verify-p6JsExms.js";
 //#region src/providers/github/app-auth.d.ts
 interface InstallationToken {

package/dist/gitlab.d.ts

@@ -1,4 +1,4 @@
-import { O as ParsedWebhookEvent, P as RepoProvider, v as IncomingWebhookRequest, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { B as TokenProvider, F as RepoProvider, O as ParsedWebhookEvent, v as IncomingWebhookRequest } from "./types-DfiRluvJ.js";
 import { t as VerifyWebhookParams } from "./verify-p6JsExms.js";
 //#region src/providers/gitlab/index.d.ts
 interface GitLabProviderOptions {

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { A as ProviderSearchRefsParams, B as UpdateWebhookParams, C as ListTagsParams, D as Page, E as NamespaceKind, F as Repository, H as Webhook, I as ResolveRefParams, L as SearchRefsParams, M as RefType, N as RepoCapabilities, O as ParsedWebhookEvent, P as RepoProvider, R as Tag, S as ListRepositoriesParams, T as Namespace, U as WebhookEventType, V as UserRef, W as WebhookVerificationMethod, _ as GitActor, a as CloneUrl, b as ListCommitsParams, c as DeleteWebhookParams, d as GetBranchParams, f as GetCloneUrlParams, g as GetWebhookParams, h as GetTagParams, i as Branch, j as RefMatch, k as ProviderName, l as DownloadArchiveParams, m as GetRepositoryParams, n as ArchiveFormat, o as Commit, p as GetCommitParams, r as AuthenticatedUser, s as CreateWebhookParams, t as Archive, u as GetAuthenticatedUserParams, v as IncomingWebhookRequest, w as ListWebhooksParams, x as ListNamespacesParams, y as ListBranchesParams, z as TokenProvider } from "./types-CTeiAxMy.js";
+import { A as ProviderRefMatch, B as TokenProvider, C as ListTagsParams, D as Page, E as NamespaceKind, F as RepoProvider, G as WebhookVerificationMethod, H as UserRef, I as Repository, L as ResolveRefParams, M as RefMatch, N as RefType, O as ParsedWebhookEvent, P as RepoCapabilities, R as SearchRefsParams, S as ListRepositoriesParams, T as Namespace, U as Webhook, V as UpdateWebhookParams, W as WebhookEventType, _ as GitActor, a as CloneUrl, b as ListCommitsParams, c as DeleteWebhookParams, d as GetBranchParams, f as GetCloneUrlParams, g as GetWebhookParams, h as GetTagParams, i as Branch, j as ProviderSearchRefsParams, k as ProviderName, l as DownloadArchiveParams, m as GetRepositoryParams, n as ArchiveFormat, o as Commit, p as GetCommitParams, r as AuthenticatedUser, s as CreateWebhookParams, t as Archive, u as GetAuthenticatedUserParams, v as IncomingWebhookRequest, w as ListWebhooksParams, x as ListNamespacesParams, y as ListBranchesParams, z as Tag } from "./types-DfiRluvJ.js";
 //#region src/client.d.ts
 interface RetryOptions {
   rateLimit?: boolean;
@@ -92,4 +92,4 @@ declare class RepoError extends Error {
   constructor(message: string, options: RepoErrorOptions);
 }
 //#endregion
-export { type Archive, type ArchiveFormat, type AuthenticatedUser, type Branch, type CloneUrl, type Commit, type CreateClientOptions, type CreateWebhookParams, type DeleteWebhookParams, type DetectWebhookProviderInput, type DownloadArchiveParams, type GetAuthenticatedUserParams, type GetBranchParams, type GetCloneUrlParams, type GetCommitParams, type GetRepositoryParams, type GetTagParams, type GetWebhookParams, type GitActor, type IncomingWebhookRequest, type ListBranchesParams, type ListCommitsParams, type ListNamespacesParams, type ListRepositoriesParams, type ListTagsParams, type ListWebhooksParams, type Namespace, type NamespaceKind, type Page, type ParsedWebhookEvent, type ProviderName, type ProviderSearchRefsParams, type RefMatch, type RefType, type RepoCapabilities, type RepoClient, RepoError, type RepoErrorCode, type RepoErrorOptions, type RepoProvider, type Repository, type ResolveRefParams, type RetryOptions, type SearchRefsParams, type Tag, type TokenProvider, type UpdateWebhookParams, type UserRef, type Webhook, type WebhookEventType, type WebhookVerificationMethod, createClient, detectWebhookProvider };
+export { type Archive, type ArchiveFormat, type AuthenticatedUser, type Branch, type CloneUrl, type Commit, type CreateClientOptions, type CreateWebhookParams, type DeleteWebhookParams, type DetectWebhookProviderInput, type DownloadArchiveParams, type GetAuthenticatedUserParams, type GetBranchParams, type GetCloneUrlParams, type GetCommitParams, type GetRepositoryParams, type GetTagParams, type GetWebhookParams, type GitActor, type IncomingWebhookRequest, type ListBranchesParams, type ListCommitsParams, type ListNamespacesParams, type ListRepositoriesParams, type ListTagsParams, type ListWebhooksParams, type Namespace, type NamespaceKind, type Page, type ParsedWebhookEvent, type ProviderName, type ProviderRefMatch, type ProviderSearchRefsParams, type RefMatch, type RefType, type RepoCapabilities, type RepoClient, RepoError, type RepoErrorCode, type RepoErrorOptions, type RepoProvider, type Repository, type ResolveRefParams, type RetryOptions, type SearchRefsParams, type Tag, type TokenProvider, type UpdateWebhookParams, type UserRef, type Webhook, type WebhookEventType, type WebhookVerificationMethod, createClient, detectWebhookProvider };

package/dist/index.js

@@ -10,29 +10,39 @@ const ALL_REF_TYPES = [
 	"commit"
 ];
 const COMMIT_SHA_PATTERN = /^[0-9a-f]{4,40}$/i;
-function branchMatch(branch) {
+const FULL_COMMIT_SHA_PATTERN = /^[0-9a-f]{40}$/i;
+const BRANCH_REF_PREFIX = "refs/heads/";
+const TAG_REF_PREFIX = "refs/tags/";
+function qualifyRef(match) {
+	const ref = match.type === "branch" ? `${BRANCH_REF_PREFIX}${match.name}` : match.type === "tag" ? `${TAG_REF_PREFIX}${match.name}` : match.sha;
 	return {
+		...match,
+		ref
+	};
+}
+function branchMatch(branch) {
+	return qualifyRef({
 		type: "branch",
 		name: branch.name,
 		sha: branch.sha,
 		raw: branch.raw
-	};
+	});
 }
 function tagMatch(tag) {
-	return {
+	return qualifyRef({
 		type: "tag",
 		name: tag.name,
 		sha: tag.sha,
 		raw: tag.raw
-	};
+	});
 }
 function commitMatch(commit) {
-	return {
+	return qualifyRef({
 		type: "commit",
 		name: commit.sha,
 		sha: commit.sha,
 		raw: commit.raw
-	};
+	});
 }
 function createClient(options) {
 	const { provider } = options;
@@ -192,7 +202,7 @@ function createClient(options) {
 					types: refTypes,
 					limit,
 					signal
-				})) : [], types.includes("commit") && COMMIT_SHA_PATTERN.test(query) ? withRetry(() => provider.getCommit({
+				})).then((matches) => matches.map(qualifyRef)) : [], types.includes("commit") && COMMIT_SHA_PATTERN.test(query) ? withRetry(() => provider.getCommit({
 					repo,
 					ref: query,
 					signal
@@ -205,8 +215,16 @@ function createClient(options) {
 			resolve: async (params) => {
 				requireNonEmpty(params.repo, "repo");
 				requireNonEmpty(params.ref, "ref");
-				const { repo, ref, type, signal } = params;
-				if (ref === "HEAD" && (type === void 0 || type === "branch")) {
+				const { repo, signal } = params;
+				let { ref, type } = params;
+				const impliedType = ref.startsWith(BRANCH_REF_PREFIX) ? "branch" : ref.startsWith(TAG_REF_PREFIX) ? "tag" : void 0;
+				if (impliedType !== void 0) {
+					if (type !== void 0 && type !== impliedType) fail("validation", `Fully-qualified ref '${ref}' contradicts type '${type}'`);
+					type = impliedType;
+					ref = ref.slice(impliedType === "branch" ? 11 : 10);
+					requireNonEmpty(ref, "ref");
+				}
+				if (impliedType === void 0 && ref === "HEAD" && (type === void 0 || type === "branch")) {
 					const defaultBranch = (await withRetry(() => provider.getRepository({
 						repo,
 						signal
@@ -226,6 +244,17 @@ function createClient(options) {
 					ref,
 					signal
 				})));
+				let commitProbeError;
+				if (type === void 0 && FULL_COMMIT_SHA_PATTERN.test(ref)) try {
+					return commitMatch(await withRetry(() => provider.getCommit({
+						repo,
+						ref,
+						signal
+					})));
+				} catch (error) {
+					if (error instanceof RepoError && (error.code === "not_found" || error.code === "validation" || error.code === "unsupported")) commitProbeError = error;
+					else throw error;
+				}
 				const [tagResult, branchResult] = await Promise.allSettled([type === "branch" ? void 0 : withRetry(() => provider.getTag({
 					repo,
 					name: ref,
@@ -242,11 +271,14 @@ function createClient(options) {
 				if (branchResult.status === "fulfilled") {
 					if (branchResult.value !== void 0) return branchMatch(branchResult.value);
 				} else if (!isMiss(branchResult)) throw branchResult.reason;
-				if (type === void 0 && COMMIT_SHA_PATTERN.test(ref)) return commitMatch(await withRetry(() => provider.getCommit({
-					repo,
-					ref,
-					signal
-				})));
+				if (type === void 0 && COMMIT_SHA_PATTERN.test(ref)) {
+					if (commitProbeError !== void 0) throw commitProbeError;
+					return commitMatch(await withRetry(() => provider.getCommit({
+						repo,
+						ref,
+						signal
+					})));
+				}
 				throw new RepoError(`Ref not found: ${ref}`, {
 					code: "not_found",
 					provider: provider.name

package/dist/testing.d.ts

@@ -1,4 +1,4 @@
-import { E as NamespaceKind, F as Repository, H as Webhook, N as RepoCapabilities, P as RepoProvider, R as Tag, T as Namespace, U as WebhookEventType, i as Branch, k as ProviderName, o as Commit } from "./types-CTeiAxMy.js";
+import { E as NamespaceKind, F as RepoProvider, I as Repository, P as RepoCapabilities, T as Namespace, U as Webhook, W as WebhookEventType, i as Branch, k as ProviderName, o as Commit, z as Tag } from "./types-DfiRluvJ.js";
 //#region src/providers/testing/index.d.ts
 interface InMemoryNamespaceSeed {
   id: string;

package/dist/{types-CTeiAxMy.d.ts → types-DfiRluvJ.d.ts}

@@ -93,10 +93,14 @@ type RefType = 'branch' | 'tag' | 'commit';
 interface RefMatch {
   type: RefType;
   name: string;
+  /** Fully-qualified form — `refs/heads/<name>` for branches, `refs/tags/<name>` for tags, the SHA itself for commits. Any `ref` value round-trips through `refs.resolve`. */
+  ref: string;
   /** SHA the ref points to. In `refs.search` results on GitHub and Gitea, annotated tags carry the tag object SHA rather than the commit; `refs.resolve` and `tags.get` always return the peeled commit SHA. */
   sha: string;
   raw: unknown;
 }
+/** `RefMatch` as produced by provider adapters, before the client derives the fully-qualified `ref`. */
+type ProviderRefMatch = Omit<RefMatch, 'ref'>;
 interface Webhook {
   id: string;
   url: string;
@@ -188,8 +192,9 @@ interface GetTagParams extends BaseParams {
 }
 interface ResolveRefParams extends BaseParams {
   repo: string;
+  /** A branch or tag name, a fully-qualified ref (`refs/heads/…`, `refs/tags/…`), a 4–40 hex commit SHA, or `HEAD`. */
   ref: string;
-  /** Restrict resolution to one ref type; when omitted, branches and tags are tried (tag wins on collision) before falling back to commit SHAs. */
+  /** Restrict resolution to one ref type; when omitted, a full 40-hex `ref` is tried as a commit first, then branches and tags (tag wins on collision), then abbreviated commit SHAs. A fully-qualified `ref` implies its type; passing a contradicting `type` throws a validation error. */
   type?: RefType;
 }
 interface SearchRefsParams extends BaseParams {
@@ -269,7 +274,7 @@ interface RepoProvider {
   /** Exact-match a tag by name, peeled to the commit SHA for annotated tags; throws `not_found` on a miss. */
   getTag(params: GetTagParams): Promise<Tag>;
   /** Prefix-match refs of the requested types, branches before tags, at most `limit` results. */
-  searchRefs(params: ProviderSearchRefsParams): Promise<RefMatch[]>;
+  searchRefs(params: ProviderSearchRefsParams): Promise<ProviderRefMatch[]>;
   downloadArchive(params: DownloadArchiveParams): Promise<Archive>;
   getCloneUrl(params: GetCloneUrlParams): Promise<CloneUrl>;
   createWebhook(params: CreateWebhookParams): Promise<Webhook>;
@@ -279,4 +284,4 @@ interface RepoProvider {
   deleteWebhook(params: DeleteWebhookParams): Promise<void>;
 }
 //#endregion
-export { ProviderSearchRefsParams as A, UpdateWebhookParams as B, ListTagsParams as C, Page as D, NamespaceKind as E, Repository as F, Webhook as H, ResolveRefParams as I, SearchRefsParams as L, RefType as M, RepoCapabilities as N, ParsedWebhookEvent as O, RepoProvider as P, Tag as R, ListRepositoriesParams as S, Namespace as T, WebhookEventType as U, UserRef as V, WebhookVerificationMethod as W, GitActor as _, CloneUrl as a, ListCommitsParams as b, DeleteWebhookParams as c, GetBranchParams as d, GetCloneUrlParams as f, GetWebhookParams as g, GetTagParams as h, Branch as i, RefMatch as j, ProviderName as k, DownloadArchiveParams as l, GetRepositoryParams as m, ArchiveFormat as n, Commit as o, GetCommitParams as p, AuthenticatedUser as r, CreateWebhookParams as s, Archive as t, GetAuthenticatedUserParams as u, IncomingWebhookRequest as v, ListWebhooksParams as w, ListNamespacesParams as x, ListBranchesParams as y, TokenProvider as z };
+export { ProviderRefMatch as A, TokenProvider as B, ListTagsParams as C, Page as D, NamespaceKind as E, RepoProvider as F, WebhookVerificationMethod as G, UserRef as H, Repository as I, ResolveRefParams as L, RefMatch as M, RefType as N, ParsedWebhookEvent as O, RepoCapabilities as P, SearchRefsParams as R, ListRepositoriesParams as S, Namespace as T, Webhook as U, UpdateWebhookParams as V, WebhookEventType as W, GitActor as _, CloneUrl as a, ListCommitsParams as b, DeleteWebhookParams as c, GetBranchParams as d, GetCloneUrlParams as f, GetWebhookParams as g, GetTagParams as h, Branch as i, ProviderSearchRefsParams as j, ProviderName as k, DownloadArchiveParams as l, GetRepositoryParams as m, ArchiveFormat as n, Commit as o, GetCommitParams as p, AuthenticatedUser as r, CreateWebhookParams as s, Archive as t, GetAuthenticatedUserParams as u, IncomingWebhookRequest as v, ListWebhooksParams as w, ListNamespacesParams as x, ListBranchesParams as y, Tag as z };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "repo-sdk",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Unified TypeScript SDK for git providers — GitHub, GitLab, Bitbucket, Azure DevOps, Gitea",
   "license": "MIT",
   "author": "Robin Genz <mail@robingenz.dev>",