@pierre/storage 0.9.2 → 1.0.0

package/dist/index.d.cts

@@ -631,6 +631,7 @@ interface Repo {
     getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getFileStream(options: GetFileOptions): Promise<Response>;
+    getArchiveStream(options?: ArchiveOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
     listBranches(options?: ListBranchesOptions): Promise<ListBranchesResult>;
     listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
@@ -719,6 +720,12 @@ interface GetFileOptions extends GitStorageInvocationOptions {
     ephemeral?: boolean;
     ephemeralBase?: boolean;
 }
+interface ArchiveOptions extends GitStorageInvocationOptions {
+    ref?: string;
+    includeGlobs?: string[];
+    excludeGlobs?: string[];
+    archivePrefix?: string;
+}
 interface PullUpstreamOptions extends GitStorageInvocationOptions {
     ref?: string;
 }
@@ -849,6 +856,10 @@ interface GetCommitDiffResult {
 }
 interface GrepOptions extends GitStorageInvocationOptions {
     ref?: string;
+    /**
+     * @deprecated Use ref instead.
+     */
+    rev?: string;
     paths?: string[];
     query: {
         pattern: string;
@@ -1172,12 +1183,6 @@ declare function validateWebhook(payload: string | Buffer, headers: Record<strin
     payload?: WebhookEventPayload;
 }>;
 
-/**
- * Pierre Git Storage SDK
- *
- * A TypeScript SDK for interacting with Pierre's git storage system
- */
-
 declare class GitStorage {
     private options;
     private api;
@@ -1221,4 +1226,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, type AppendNoteOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };
+export { ApiError, type AppendNoteOptions, type ArchiveOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };

package/dist/index.d.ts

@@ -631,6 +631,7 @@ interface Repo {
     getRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getEphemeralRemoteURL(options?: GetRemoteURLOptions): Promise<string>;
     getFileStream(options: GetFileOptions): Promise<Response>;
+    getArchiveStream(options?: ArchiveOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
     listBranches(options?: ListBranchesOptions): Promise<ListBranchesResult>;
     listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
@@ -719,6 +720,12 @@ interface GetFileOptions extends GitStorageInvocationOptions {
     ephemeral?: boolean;
     ephemeralBase?: boolean;
 }
+interface ArchiveOptions extends GitStorageInvocationOptions {
+    ref?: string;
+    includeGlobs?: string[];
+    excludeGlobs?: string[];
+    archivePrefix?: string;
+}
 interface PullUpstreamOptions extends GitStorageInvocationOptions {
     ref?: string;
 }
@@ -849,6 +856,10 @@ interface GetCommitDiffResult {
 }
 interface GrepOptions extends GitStorageInvocationOptions {
     ref?: string;
+    /**
+     * @deprecated Use ref instead.
+     */
+    rev?: string;
     paths?: string[];
     query: {
         pattern: string;
@@ -1172,12 +1183,6 @@ declare function validateWebhook(payload: string | Buffer, headers: Record<strin
     payload?: WebhookEventPayload;
 }>;
 
-/**
- * Pierre Git Storage SDK
- *
- * A TypeScript SDK for interacting with Pierre's git storage system
- */
-
 declare class GitStorage {
     private options;
     private api;
@@ -1221,4 +1226,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, type AppendNoteOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };
+export { ApiError, type AppendNoteOptions, type ArchiveOptions, type BaseRepo, type BlobLike, type BranchInfo, GitStorage as CodeStorage, type CommitBuilder, type CommitFileOptions, type CommitFileSource, type CommitInfo, type CommitResult, type CommitSignature, type CommitTextFileOptions, type CreateBranchOptions, type CreateBranchResponse, type CreateBranchResult, type CreateCommitBranchOptions, type CreateCommitFromDiffOptions, type CreateCommitOptions, type CreateNoteOptions, type CreateRepoOptions, type DeleteNoteOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type ForkBaseRepo, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetNoteOptions, type GetNoteResponse, type GetNoteResult, type GetRemoteURLOptions, type GitFileMode, type GitHubBaseRepo, GitStorage, type GitStorageOptions, type GrepFileMatch, type GrepLine, type GrepOptions, type GrepResult, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RestoreCommitOptions, type RestoreCommitResult, type StorageOptions, type SupportedRepoProvider, type TextEncoding, type ValidAPIVersion, type ValidMethod, type ValidPath, type WebhookEventPayload, type WebhookPushEvent, type WebhookUnknownEvent, type WebhookValidationOptions, type WebhookValidationResult, createClient, parseSignatureHeader, validateWebhook, validateWebhookSignature };

package/dist/index.js

@@ -159,7 +159,9 @@ var commitPackCommitSchema = z.object({
   pack_bytes: z.number(),
   blob_count: z.number()
 });
-var restoreCommitCommitSchema = commitPackCommitSchema.omit({ blob_count: true });
+var restoreCommitCommitSchema = commitPackCommitSchema.omit({
+  blob_count: true
+});
 var refUpdateResultWithOptionalsSchema = z.object({
   branch: z.string().optional(),
   old_sha: z.string().optional(),
@@ -269,7 +271,11 @@ async function parseCommitPackError(response, fallbackMessage) {
       if (typeof result.status === "string" && result.status.trim() !== "") {
         statusLabel = result.status.trim();
       }
-      refUpdate = toPartialRefUpdateFields(result.branch, result.old_sha, result.new_sha);
+      refUpdate = toPartialRefUpdateFields(
+        result.branch,
+        result.old_sha,
+        result.new_sha
+      );
       if (typeof result.message === "string" && result.message.trim() !== "") {
         message = result.message.trim();
       }
@@ -500,7 +506,7 @@ function concatChunks(a, b) {
 
 // package.json
 var package_default = {
-  version: "0.9.2"};
+  version: "1.0.0"};
 
 // src/version.ts
 var PACKAGE_NAME = "code-storage-sdk";
@@ -546,7 +552,9 @@ var CommitBuilderImpl = class {
         delete this.options.baseBranch;
       } else {
         if (trimmedBase.startsWith("refs/")) {
-          throw new Error("createCommit baseBranch must not include refs/ prefix");
+          throw new Error(
+            "createCommit baseBranch must not include refs/ prefix"
+          );
         }
         this.options.baseBranch = trimmedBase;
       }
@@ -693,10 +701,7 @@ var FetchCommitTransport = class {
     const response = await fetch(this.url, init);
     if (!response.ok) {
       const fallbackMessage = `createCommit request failed (${response.status} ${response.statusText})`;
-      const { statusMessage, statusLabel, refUpdate } = await parseCommitPackError(
-        response,
-        fallbackMessage
-      );
+      const { statusMessage, statusLabel, refUpdate } = await parseCommitPackError(response, fallbackMessage);
       throw new RefUpdateError(statusMessage, {
         status: statusLabel,
         message: statusMessage,
@@ -823,7 +828,9 @@ var DiffCommitExecutor = class {
       throw new Error("createCommitFromDiff commitMessage is required");
     }
     if (!trimmedAuthorName || !trimmedAuthorEmail) {
-      throw new Error("createCommitFromDiff author name and email are required");
+      throw new Error(
+        "createCommitFromDiff author name and email are required"
+      );
     }
     this.options.commitMessage = trimmedMessage;
     this.options.author = {
@@ -839,7 +846,9 @@ var DiffCommitExecutor = class {
         delete this.options.baseBranch;
       } else {
         if (trimmedBase.startsWith("refs/")) {
-          throw new Error("createCommitFromDiff baseBranch must not include refs/ prefix");
+          throw new Error(
+            "createCommitFromDiff baseBranch must not include refs/ prefix"
+          );
         }
         this.options.baseBranch = trimmedBase;
       }
@@ -905,7 +914,10 @@ var FetchDiffCommitTransport = class {
     this.url = `${trimmedBase}/api/v${config.version}/repos/diff-commit`;
   }
   async send(request) {
-    const bodyIterable = buildMessageIterable2(request.metadata, request.diffChunks);
+    const bodyIterable = buildMessageIterable2(
+      request.metadata,
+      request.diffChunks
+    );
     const body = toRequestBody(bodyIterable);
     const init = {
       method: "POST",
@@ -924,10 +936,7 @@ var FetchDiffCommitTransport = class {
     const response = await fetch(this.url, init);
     if (!response.ok) {
       const fallbackMessage = `createCommitFromDiff request failed (${response.status} ${response.statusText})`;
-      const { statusMessage, statusLabel, refUpdate } = await parseCommitPackError(
-        response,
-        fallbackMessage
-      );
+      const { statusMessage, statusLabel, refUpdate } = await parseCommitPackError(response, fallbackMessage);
       throw new RefUpdateError(statusMessage, {
         status: statusLabel,
         message: statusMessage,
@@ -969,7 +978,9 @@ function normalizeDiffCommitOptions(options) {
     const name = options.committer.name?.trim();
     const email = options.committer.email?.trim();
     if (!name || !email) {
-      throw new Error("createCommitFromDiff committer name and email are required when provided");
+      throw new Error(
+        "createCommitFromDiff committer name and email are required when provided"
+      );
     }
     committer = { name, email };
   }
@@ -995,12 +1006,16 @@ function normalizeBranchName2(value) {
   if (trimmed.startsWith("refs/heads/")) {
     const branch = trimmed.slice("refs/heads/".length).trim();
     if (!branch) {
-      throw new Error("createCommitFromDiff targetBranch must include a branch name");
+      throw new Error(
+        "createCommitFromDiff targetBranch must include a branch name"
+      );
     }
     return branch;
   }
   if (trimmed.startsWith("refs/")) {
-    throw new Error("createCommitFromDiff targetBranch must not include refs/ prefix");
+    throw new Error(
+      "createCommitFromDiff targetBranch must not include refs/ prefix"
+    );
   }
   return trimmed;
 }
@@ -1480,7 +1495,11 @@ function parseRestoreCommitPayload(payload) {
       failure: {
         status: result.status,
         message: result.message,
-        refUpdate: toPartialRefUpdate(result.branch, result.old_sha, result.new_sha)
+        refUpdate: toPartialRefUpdate(
+          result.branch,
+          result.old_sha,
+          result.new_sha
+        )
       }
     };
   }
@@ -1498,7 +1517,10 @@ function httpStatusToRestoreStatus(status) {
 }
 function getApiInstance(baseUrl, version) {
   if (!apiInstanceMap.has(`${baseUrl}--${version}`)) {
-    apiInstanceMap.set(`${baseUrl}--${version}`, new ApiFetcher(baseUrl, version));
+    apiInstanceMap.set(
+      `${baseUrl}--${version}`,
+      new ApiFetcher(baseUrl, version)
+    );
   }
   return apiInstanceMap.get(`${baseUrl}--${version}`);
 }
@@ -1734,13 +1756,17 @@ var RepoImpl = class {
   }
   api;
   async getRemoteURL(urlOptions) {
-    const url = new URL(`https://${this.options.storageBaseUrl}/${this.id}.git`);
+    const url = new URL(
+      `https://${this.options.storageBaseUrl}/${this.id}.git`
+    );
     url.username = `t`;
     url.password = await this.generateJWT(this.id, urlOptions);
     return url.toString();
   }
   async getEphemeralRemoteURL(urlOptions) {
-    const url = new URL(`https://${this.options.storageBaseUrl}/${this.id}+ephemeral.git`);
+    const url = new URL(
+      `https://${this.options.storageBaseUrl}/${this.id}+ephemeral.git`
+    );
     url.username = `t`;
     url.password = await this.generateJWT(this.id, urlOptions);
     return url.toString();
@@ -1765,6 +1791,32 @@ var RepoImpl = class {
     }
     return this.api.get({ path: "repos/file", params }, jwt);
   }
+  async getArchiveStream(options = {}) {
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(this.id, {
+      permissions: ["git:read"],
+      ttl
+    });
+    const body = {};
+    const ref = options.ref?.trim();
+    if (ref) {
+      body.ref = ref;
+    }
+    if (Array.isArray(options.includeGlobs) && options.includeGlobs.length > 0) {
+      body.include_globs = options.includeGlobs;
+    }
+    if (Array.isArray(options.excludeGlobs) && options.excludeGlobs.length > 0) {
+      body.exclude_globs = options.excludeGlobs;
+    }
+    if (typeof options.archivePrefix === "string") {
+      const prefix = options.archivePrefix.trim();
+      if (prefix) {
+        body.archive = { prefix };
+      }
+    }
+    const path = Object.keys(body).length > 0 ? { path: "repos/archive", body } : "repos/archive";
+    return this.api.post(path, jwt);
+  }
   async listFiles(options) {
     const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
     const jwt = await this.generateJWT(this.id, {
@@ -1779,7 +1831,10 @@ var RepoImpl = class {
       params.ephemeral = String(options.ephemeral);
     }
     const response = await this.api.get(
-      { path: "repos/files", params: Object.keys(params).length ? params : void 0 },
+      {
+        path: "repos/files",
+        params: Object.keys(params).length ? params : void 0
+      },
       jwt
     );
     const raw = listFilesResponseSchema.parse(await response.json());
@@ -1803,7 +1858,10 @@ var RepoImpl = class {
         params.limit = limit.toString();
       }
     }
-    const response = await this.api.get({ path: "repos/branches", params }, jwt);
+    const response = await this.api.get(
+      { path: "repos/branches", params },
+      jwt
+    );
     const raw = listBranchesResponseSchema.parse(await response.json());
     return transformListBranchesResult({
       ...raw,
@@ -1846,7 +1904,10 @@ var RepoImpl = class {
       permissions: ["git:read"],
       ttl
     });
-    const response = await this.api.get({ path: "repos/notes", params: { sha } }, jwt);
+    const response = await this.api.get(
+      { path: "repos/notes", params: { sha } },
+      jwt
+    );
     const raw = noteReadResponseSchema.parse(await response.json());
     return transformNoteReadResult(raw);
   }
@@ -1878,7 +1939,11 @@ var RepoImpl = class {
         {
           status: result.result.status,
           message: result.result.message,
-          refUpdate: toPartialRefUpdate(result.targetRef, result.baseCommit, result.newRefSha)
+          refUpdate: toPartialRefUpdate(
+            result.targetRef,
+            result.baseCommit,
+            result.newRefSha
+          )
         }
       );
     }
@@ -1912,7 +1977,11 @@ var RepoImpl = class {
         {
           status: result.result.status,
           message: result.result.message,
-          refUpdate: toPartialRefUpdate(result.targetRef, result.baseCommit, result.newRefSha)
+          refUpdate: toPartialRefUpdate(
+            result.targetRef,
+            result.baseCommit,
+            result.newRefSha
+          )
         }
       );
     }
@@ -1939,7 +2008,9 @@ var RepoImpl = class {
       const authorName = options.author.name?.trim();
       const authorEmail = options.author.email?.trim();
       if (!authorName || !authorEmail) {
-        throw new Error("deleteNote author name and email are required when provided");
+        throw new Error(
+          "deleteNote author name and email are required when provided"
+        );
       }
       body.author = {
         name: authorName,
@@ -1956,7 +2027,11 @@ var RepoImpl = class {
         {
           status: result.result.status,
           message: result.result.message,
-          refUpdate: toPartialRefUpdate(result.targetRef, result.baseCommit, result.newRefSha)
+          refUpdate: toPartialRefUpdate(
+            result.targetRef,
+            result.baseCommit,
+            result.newRefSha
+          )
         }
       );
     }
@@ -1983,7 +2058,10 @@ var RepoImpl = class {
     if (options.paths && options.paths.length > 0) {
       params.path = options.paths;
     }
-    const response = await this.api.get({ path: "repos/branches/diff", params }, jwt);
+    const response = await this.api.get(
+      { path: "repos/branches/diff", params },
+      jwt
+    );
     const raw = branchDiffResponseSchema.parse(await response.json());
     return transformBranchDiffResult(raw);
   }
@@ -2022,8 +2100,9 @@ var RepoImpl = class {
         ...typeof options.query.caseSensitive === "boolean" ? { case_sensitive: options.query.caseSensitive } : {}
       }
     };
-    if (options.ref) {
-      body.rev = options.ref;
+    const ref = options.ref?.trim() || options.rev?.trim();
+    if (ref) {
+      body.ref = ref;
     }
     if (Array.isArray(options.paths) && options.paths.length > 0) {
       body.paths = options.paths;
@@ -2079,9 +2158,14 @@ var RepoImpl = class {
     if (options.ref) {
       body.ref = options.ref;
     }
-    const response = await this.api.post({ path: "repos/pull-upstream", body }, jwt);
+    const response = await this.api.post(
+      { path: "repos/pull-upstream", body },
+      jwt
+    );
     if (response.status !== 202) {
-      throw new Error(`Pull Upstream failed: ${response.status} ${await response.text()}`);
+      throw new Error(
+        `Pull Upstream failed: ${response.status} ${await response.text()}`
+      );
     }
     return;
   }
@@ -2109,7 +2193,10 @@ var RepoImpl = class {
     if (options.targetIsEphemeral === true) {
       body.target_is_ephemeral = true;
     }
-    const response = await this.api.post({ path: "repos/branches/create", body }, jwt);
+    const response = await this.api.post(
+      { path: "repos/branches/create", body },
+      jwt
+    );
     const raw = createBranchResponseSchema.parse(await response.json());
     return transformCreateBranchResult(raw);
   }
@@ -2119,7 +2206,9 @@ var RepoImpl = class {
       throw new Error("restoreCommit targetBranch is required");
     }
     if (targetBranch.startsWith("refs/")) {
-      throw new Error("restoreCommit targetBranch must not include refs/ prefix");
+      throw new Error(
+        "restoreCommit targetBranch must not include refs/ prefix"
+      );
     }
     const targetCommitSha = options?.targetCommitSha?.trim();
     if (!targetCommitSha) {
@@ -2155,7 +2244,9 @@ var RepoImpl = class {
       const committerName = options.committer.name?.trim();
       const committerEmail = options.committer.email?.trim();
       if (!committerName || !committerEmail) {
-        throw new Error("restoreCommit committer name and email are required when provided");
+        throw new Error(
+          "restoreCommit committer name and email are required when provided"
+        );
       }
       metadata.committer = {
         name: committerName,
@@ -2273,7 +2364,7 @@ var GitStorage = class _GitStorage {
     let resolvedDefaultBranch;
     if (baseRepo) {
       if ("id" in baseRepo) {
-        const baseRepoToken = await this.generateJWT(`${this.options.name}/${baseRepo.id}`, {
+        const baseRepoToken = await this.generateJWT(baseRepo.id, {
           permissions: ["git:read"],
           ttl
         });
@@ -2305,10 +2396,14 @@ var GitStorage = class _GitStorage {
       path: "repos",
       body: {
         ...baseRepoOptions && { base_repo: baseRepoOptions },
-        ...resolvedDefaultBranch && { default_branch: resolvedDefaultBranch }
+        ...resolvedDefaultBranch && {
+          default_branch: resolvedDefaultBranch
+        }
       }
     } : "repos";
-    const resp = await this.api.post(createRepoPath, jwt, { allowedStatus: [409] });
+    const resp = await this.api.post(createRepoPath, jwt, {
+      allowedStatus: [409]
+    });
     if (resp.status === 409) {
       throw new Error("Repository already exists");
     }
@@ -2362,7 +2457,12 @@ var GitStorage = class _GitStorage {
     }
     const body = await resp.json();
     const defaultBranch = body.default_branch ?? "main";
-    return new RepoImpl(options.id, defaultBranch, this.options, this.generateJWT.bind(this));
+    return new RepoImpl(
+      options.id,
+      defaultBranch,
+      this.options,
+      this.generateJWT.bind(this)
+    );
   }
   /**
    * Delete a repository by ID
@@ -2375,7 +2475,9 @@ var GitStorage = class _GitStorage {
       permissions: ["repo:write"],
       ttl
     });
-    const resp = await this.api.delete("repos/delete", jwt, { allowedStatus: [404, 409] });
+    const resp = await this.api.delete("repos/delete", jwt, {
+      allowedStatus: [404, 409]
+    });
     if (resp.status === 404) {
       throw new Error("Repository not found");
     }
@@ -2401,7 +2503,10 @@ var GitStorage = class _GitStorage {
    */
   async generateJWT(repoId, options) {
     const permissions = options?.permissions || ["git:write", "git:read"];
-    const ttl = resolveInvocationTtlSeconds(options, this.options.defaultTTL ?? 365 * 24 * 60 * 60);
+    const ttl = resolveInvocationTtlSeconds(
+      options,
+      this.options.defaultTTL ?? 365 * 24 * 60 * 60
+    );
     const now = Math.floor(Date.now() / 1e3);
     const payload = {
       iss: this.options.name,