@pierre/storage 1.0.3 → 1.2.0

package/dist/index.d.cts

@@ -10,6 +10,93 @@ declare const listFilesResponseSchema: z.ZodObject<{
     ref: string;
     paths: string[];
 }>;
+declare const fileWithMetadataRawSchema: z.ZodObject<{
+    path: z.ZodString;
+    mode: z.ZodString;
+    size: z.ZodNumber;
+    last_commit_sha: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    mode: string;
+    size: number;
+    last_commit_sha: string;
+}, {
+    path: string;
+    mode: string;
+    size: number;
+    last_commit_sha: string;
+}>;
+declare const commitMetadataRawSchema: z.ZodObject<{
+    author: z.ZodString;
+    date: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    date: string;
+    author: string;
+}, {
+    message: string;
+    date: string;
+    author: string;
+}>;
+declare const listFilesWithMetadataResponseSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        mode: z.ZodString;
+        size: z.ZodNumber;
+        last_commit_sha: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }, {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }>, "many">;
+    commits: z.ZodRecord<z.ZodString, z.ZodObject<{
+        author: z.ZodString;
+        date: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        date: string;
+        author: string;
+    }, {
+        message: string;
+        date: string;
+        author: string;
+    }>>;
+    ref: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    commits: Record<string, {
+        message: string;
+        date: string;
+        author: string;
+    }>;
+    files: {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }[];
+    ref: string;
+}, {
+    commits: Record<string, {
+        message: string;
+        date: string;
+        author: string;
+    }>;
+    files: {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }[];
+    ref: string;
+}>;
 declare const branchInfoSchema: z.ZodObject<{
     cursor: z.ZodString;
     name: z.ZodString;
@@ -373,14 +460,14 @@ declare const branchDiffResponseSchema: z.ZodObject<{
         deletions: z.ZodNumber;
         changes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }>;
     files: z.ZodArray<z.ZodObject<{
@@ -432,7 +519,6 @@ declare const branchDiffResponseSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     branch: string;
-    base: string;
     files: {
         path: string;
         state: string;
@@ -443,10 +529,11 @@ declare const branchDiffResponseSchema: z.ZodObject<{
         additions?: number | undefined;
         deletions?: number | undefined;
     }[];
+    base: string;
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -458,7 +545,6 @@ declare const branchDiffResponseSchema: z.ZodObject<{
     }[];
 }, {
     branch: string;
-    base: string;
     files: {
         path: string;
         state: string;
@@ -469,10 +555,11 @@ declare const branchDiffResponseSchema: z.ZodObject<{
         additions?: number | undefined;
         deletions?: number | undefined;
     }[];
+    base: string;
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -491,14 +578,14 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         deletions: z.ZodNumber;
         changes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }>;
     files: z.ZodArray<z.ZodObject<{
@@ -561,9 +648,9 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         deletions?: number | undefined;
     }[];
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -586,9 +673,9 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         deletions?: number | undefined;
     }[];
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -616,6 +703,9 @@ declare const createBranchResponseSchema: z.ZodObject<{
     commit_sha?: string | null | undefined;
 }>;
 type ListFilesResponseRaw = z.infer<typeof listFilesResponseSchema>;
+type RawFileWithMetadata$1 = z.infer<typeof fileWithMetadataRawSchema>;
+type RawCommitMetadata$1 = z.infer<typeof commitMetadataRawSchema>;
+type ListFilesWithMetadataResponseRaw = z.infer<typeof listFilesWithMetadataResponseSchema>;
 type RawBranchInfo$1 = z.infer<typeof branchInfoSchema>;
 type ListBranchesResponseRaw = z.infer<typeof listBranchesResponseSchema>;
 type RawCommitInfo$1 = z.infer<typeof commitInfoRawSchema>;
@@ -660,6 +750,7 @@ interface Repo {
     getFileStream(options: GetFileOptions): Promise<Response>;
     getArchiveStream(options?: ArchiveOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
+    listFilesWithMetadata(options?: ListFilesWithMetadataOptions): Promise<ListFilesWithMetadataResult>;
     listBranches(options?: ListBranchesOptions): Promise<ListBranchesResult>;
     listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
     getNote(options: GetNoteOptions): Promise<GetNoteResult>;
@@ -689,6 +780,11 @@ interface GitStorageInvocationOptions {
 interface FindOneOptions {
     id: string;
 }
+interface RepoOptions {
+    id: string;
+    defaultBranch?: string;
+    createdAt?: string;
+}
 type SupportedRepoProvider = 'github';
 interface PublicGitHubBaseRepoAuth {
     /**
@@ -772,6 +868,30 @@ interface ListFilesResult {
     paths: string[];
     ref: string;
 }
+interface ListFilesWithMetadataOptions extends GitStorageInvocationOptions {
+    ref?: string;
+    ephemeral?: boolean;
+}
+type RawFileWithMetadata = RawFileWithMetadata$1;
+interface FileWithMetadata {
+    path: string;
+    mode: string;
+    size: number;
+    lastCommitSha: string;
+}
+type RawCommitMetadata = RawCommitMetadata$1;
+interface CommitMetadata {
+    author: string;
+    date: Date;
+    rawDate: string;
+    message: string;
+}
+type ListFilesWithMetadataResponse = ListFilesWithMetadataResponseRaw;
+interface ListFilesWithMetadataResult {
+    files: FileWithMetadata[];
+    commits: Record<string, CommitMetadata>;
+    ref: string;
+}
 interface ListBranchesOptions extends GitStorageInvocationOptions {
     cursor?: string;
     limit?: number;
@@ -1241,6 +1361,10 @@ declare class GitStorage {
      * @returns The found repository
      */
     findOne(options: FindOneOptions): Promise<Repo | null>;
+    /**
+     * Create a Repo handle from known metadata without making an HTTP request.
+     */
+    repo(options: RepoOptions): Repo;
     /**
      * Delete a repository by ID
      * @param options The delete options containing the repo ID
@@ -1262,4 +1386,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-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 PublicGitHubBaseRepoAuth, 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 CommitMetadata, 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 FileWithMetadata, 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 ListFilesWithMetadataOptions, type ListFilesWithMetadataResponse, type ListFilesWithMetadataResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PublicGitHubBaseRepoAuth, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawCommitMetadata, type RawFileDiff, type RawFileWithMetadata, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RepoOptions, 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

@@ -10,6 +10,93 @@ declare const listFilesResponseSchema: z.ZodObject<{
     ref: string;
     paths: string[];
 }>;
+declare const fileWithMetadataRawSchema: z.ZodObject<{
+    path: z.ZodString;
+    mode: z.ZodString;
+    size: z.ZodNumber;
+    last_commit_sha: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    path: string;
+    mode: string;
+    size: number;
+    last_commit_sha: string;
+}, {
+    path: string;
+    mode: string;
+    size: number;
+    last_commit_sha: string;
+}>;
+declare const commitMetadataRawSchema: z.ZodObject<{
+    author: z.ZodString;
+    date: z.ZodString;
+    message: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    message: string;
+    date: string;
+    author: string;
+}, {
+    message: string;
+    date: string;
+    author: string;
+}>;
+declare const listFilesWithMetadataResponseSchema: z.ZodObject<{
+    files: z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        mode: z.ZodString;
+        size: z.ZodNumber;
+        last_commit_sha: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }, {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }>, "many">;
+    commits: z.ZodRecord<z.ZodString, z.ZodObject<{
+        author: z.ZodString;
+        date: z.ZodString;
+        message: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        message: string;
+        date: string;
+        author: string;
+    }, {
+        message: string;
+        date: string;
+        author: string;
+    }>>;
+    ref: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    commits: Record<string, {
+        message: string;
+        date: string;
+        author: string;
+    }>;
+    files: {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }[];
+    ref: string;
+}, {
+    commits: Record<string, {
+        message: string;
+        date: string;
+        author: string;
+    }>;
+    files: {
+        path: string;
+        mode: string;
+        size: number;
+        last_commit_sha: string;
+    }[];
+    ref: string;
+}>;
 declare const branchInfoSchema: z.ZodObject<{
     cursor: z.ZodString;
     name: z.ZodString;
@@ -373,14 +460,14 @@ declare const branchDiffResponseSchema: z.ZodObject<{
         deletions: z.ZodNumber;
         changes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }>;
     files: z.ZodArray<z.ZodObject<{
@@ -432,7 +519,6 @@ declare const branchDiffResponseSchema: z.ZodObject<{
     }>, "many">;
 }, "strip", z.ZodTypeAny, {
     branch: string;
-    base: string;
     files: {
         path: string;
         state: string;
@@ -443,10 +529,11 @@ declare const branchDiffResponseSchema: z.ZodObject<{
         additions?: number | undefined;
         deletions?: number | undefined;
     }[];
+    base: string;
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -458,7 +545,6 @@ declare const branchDiffResponseSchema: z.ZodObject<{
     }[];
 }, {
     branch: string;
-    base: string;
     files: {
         path: string;
         state: string;
@@ -469,10 +555,11 @@ declare const branchDiffResponseSchema: z.ZodObject<{
         additions?: number | undefined;
         deletions?: number | undefined;
     }[];
+    base: string;
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -491,14 +578,14 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         deletions: z.ZodNumber;
         changes: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }, {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     }>;
     files: z.ZodArray<z.ZodObject<{
@@ -561,9 +648,9 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         deletions?: number | undefined;
     }[];
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -586,9 +673,9 @@ declare const commitDiffResponseSchema: z.ZodObject<{
         deletions?: number | undefined;
     }[];
     stats: {
+        files: number;
         additions: number;
         deletions: number;
-        files: number;
         changes: number;
     };
     filtered_files: {
@@ -616,6 +703,9 @@ declare const createBranchResponseSchema: z.ZodObject<{
     commit_sha?: string | null | undefined;
 }>;
 type ListFilesResponseRaw = z.infer<typeof listFilesResponseSchema>;
+type RawFileWithMetadata$1 = z.infer<typeof fileWithMetadataRawSchema>;
+type RawCommitMetadata$1 = z.infer<typeof commitMetadataRawSchema>;
+type ListFilesWithMetadataResponseRaw = z.infer<typeof listFilesWithMetadataResponseSchema>;
 type RawBranchInfo$1 = z.infer<typeof branchInfoSchema>;
 type ListBranchesResponseRaw = z.infer<typeof listBranchesResponseSchema>;
 type RawCommitInfo$1 = z.infer<typeof commitInfoRawSchema>;
@@ -660,6 +750,7 @@ interface Repo {
     getFileStream(options: GetFileOptions): Promise<Response>;
     getArchiveStream(options?: ArchiveOptions): Promise<Response>;
     listFiles(options?: ListFilesOptions): Promise<ListFilesResult>;
+    listFilesWithMetadata(options?: ListFilesWithMetadataOptions): Promise<ListFilesWithMetadataResult>;
     listBranches(options?: ListBranchesOptions): Promise<ListBranchesResult>;
     listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
     getNote(options: GetNoteOptions): Promise<GetNoteResult>;
@@ -689,6 +780,11 @@ interface GitStorageInvocationOptions {
 interface FindOneOptions {
     id: string;
 }
+interface RepoOptions {
+    id: string;
+    defaultBranch?: string;
+    createdAt?: string;
+}
 type SupportedRepoProvider = 'github';
 interface PublicGitHubBaseRepoAuth {
     /**
@@ -772,6 +868,30 @@ interface ListFilesResult {
     paths: string[];
     ref: string;
 }
+interface ListFilesWithMetadataOptions extends GitStorageInvocationOptions {
+    ref?: string;
+    ephemeral?: boolean;
+}
+type RawFileWithMetadata = RawFileWithMetadata$1;
+interface FileWithMetadata {
+    path: string;
+    mode: string;
+    size: number;
+    lastCommitSha: string;
+}
+type RawCommitMetadata = RawCommitMetadata$1;
+interface CommitMetadata {
+    author: string;
+    date: Date;
+    rawDate: string;
+    message: string;
+}
+type ListFilesWithMetadataResponse = ListFilesWithMetadataResponseRaw;
+interface ListFilesWithMetadataResult {
+    files: FileWithMetadata[];
+    commits: Record<string, CommitMetadata>;
+    ref: string;
+}
 interface ListBranchesOptions extends GitStorageInvocationOptions {
     cursor?: string;
     limit?: number;
@@ -1241,6 +1361,10 @@ declare class GitStorage {
      * @returns The found repository
      */
     findOne(options: FindOneOptions): Promise<Repo | null>;
+    /**
+     * Create a Repo handle from known metadata without making an HTTP request.
+     */
+    repo(options: RepoOptions): Repo;
     /**
      * Delete a repository by ID
      * @param options The delete options containing the repo ID
@@ -1262,4 +1386,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-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 PublicGitHubBaseRepoAuth, 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 CommitMetadata, 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 FileWithMetadata, 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 ListFilesWithMetadataOptions, type ListFilesWithMetadataResponse, type ListFilesWithMetadataResult, type ListReposOptions, type ListReposResponse, type ListReposResult, type NoteWriteResponse, type NoteWriteResult, type NoteWriteResultPayload, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PublicGitHubBaseRepoAuth, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawCommitMetadata, type RawFileDiff, type RawFileWithMetadata, type RawFilteredFile, type RawRepoBaseInfo, type RawRepoInfo, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, type RepoBaseInfo, type RepoInfo, type RepoOptions, 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

@@ -45,6 +45,22 @@ var listFilesResponseSchema = z.object({
   paths: z.array(z.string()),
   ref: z.string()
 });
+var fileWithMetadataRawSchema = z.object({
+  path: z.string(),
+  mode: z.string(),
+  size: z.number(),
+  last_commit_sha: z.string()
+});
+var commitMetadataRawSchema = z.object({
+  author: z.string(),
+  date: z.string(),
+  message: z.string()
+});
+var listFilesWithMetadataResponseSchema = z.object({
+  files: z.array(fileWithMetadataRawSchema),
+  commits: z.record(commitMetadataRawSchema),
+  ref: z.string()
+});
 var branchInfoSchema = z.object({
   cursor: z.string(),
   name: z.string(),
@@ -508,7 +524,7 @@ function concatChunks(a, b) {
 
 // package.json
 var package_default = {
-  version: "1.0.3"};
+  version: "1.2.0"};
 
 // src/version.ts
 var PACKAGE_NAME = "code-storage-sdk";
@@ -1561,6 +1577,33 @@ function transformListCommitsResult(raw) {
     hasMore: raw.has_more
   };
 }
+function transformFileWithMetadata(raw) {
+  return {
+    path: raw.path,
+    mode: raw.mode,
+    size: raw.size,
+    lastCommitSha: raw.last_commit_sha
+  };
+}
+function transformCommitMetadata(raw) {
+  return {
+    author: raw.author,
+    date: new Date(raw.date),
+    rawDate: raw.date,
+    message: raw.message
+  };
+}
+function transformListFilesWithMetadataResult(raw) {
+  const commits = {};
+  for (const [sha, commit] of Object.entries(raw.commits)) {
+    commits[sha] = transformCommitMetadata(commit);
+  }
+  return {
+    files: raw.files.map(transformFileWithMetadata),
+    commits,
+    ref: raw.ref
+  };
+}
 function normalizeDiffState(rawState) {
   if (!rawState) {
     return "unknown";
@@ -1845,6 +1888,29 @@ var RepoImpl = class {
     const raw = listFilesResponseSchema.parse(await response.json());
     return { paths: raw.paths, ref: raw.ref };
   }
+  async listFilesWithMetadata(options) {
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(this.id, {
+      permissions: ["git:read"],
+      ttl
+    });
+    const params = {};
+    if (options?.ref) {
+      params.ref = options.ref;
+    }
+    if (typeof options?.ephemeral === "boolean") {
+      params.ephemeral = String(options.ephemeral);
+    }
+    const response = await this.api.get(
+      {
+        path: "repos/files/metadata",
+        params: Object.keys(params).length ? params : void 0
+      },
+      jwt
+    );
+    const raw = listFilesWithMetadataResponseSchema.parse(await response.json());
+    return transformListFilesWithMetadataResult(raw);
+  }
   async listBranches(options) {
     const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
     const jwt = await this.generateJWT(this.id, {
@@ -2412,13 +2478,11 @@ var GitStorage = class _GitStorage {
     if (resp.status === 409) {
       throw new Error("Repository already exists");
     }
-    return new RepoImpl(
-      repoId,
-      resolvedDefaultBranch ?? "main",
-      (/* @__PURE__ */ new Date()).toISOString(),
-      this.options,
-      this.generateJWT.bind(this)
-    );
+    return this.repo({
+      id: repoId,
+      defaultBranch: resolvedDefaultBranch ?? "main",
+      createdAt: (/* @__PURE__ */ new Date()).toISOString()
+    });
   }
   /**
    * List repositories for the authenticated organization
@@ -2464,10 +2528,23 @@ var GitStorage = class _GitStorage {
     const body = await resp.json();
     const defaultBranch = body.default_branch ?? "main";
     const createdAt = body.created_at ?? "";
+    return this.repo({
+      id: options.id,
+      defaultBranch,
+      createdAt
+    });
+  }
+  /**
+   * Create a Repo handle from known metadata without making an HTTP request.
+   */
+  repo(options) {
+    if (!options || typeof options.id !== "string" || options.id.trim() === "") {
+      throw new Error("repo requires a non-empty repository id.");
+    }
     return new RepoImpl(
       options.id,
-      defaultBranch,
-      createdAt,
+      options.defaultBranch ?? "main",
+      options.createdAt ?? "",
       this.options,
       this.generateJWT.bind(this)
     );