@pierre/storage 0.4.0 → 0.4.1

package/dist/index.d.cts

@@ -455,6 +455,7 @@ interface Repo {
     listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
     getBranchDiff(options: GetBranchDiffOptions): Promise<GetBranchDiffResult>;
     getCommitDiff(options: GetCommitDiffOptions): Promise<GetCommitDiffResult>;
+    grep(options: GrepOptions): Promise<GrepResult>;
     pullUpstream(options?: PullUpstreamOptions): Promise<void>;
     restoreCommit(options: RestoreCommitOptions): Promise<RestoreCommitResult>;
     createBranch(options: CreateBranchOptions): Promise<CreateBranchResult>;
@@ -592,6 +593,57 @@ interface GetCommitDiffResult {
     files: FileDiff[];
     filteredFiles: FilteredFile[];
 }
+interface GrepOptions extends GitStorageInvocationOptions {
+    ref?: string;
+    paths?: string[];
+    query: {
+        pattern: string;
+        /**
+         * Default is case-sensitive.
+         * When omitted, the server default is used.
+         */
+        caseSensitive?: boolean;
+    };
+    fileFilters?: {
+        includeGlobs?: string[];
+        excludeGlobs?: string[];
+        extensionFilters?: string[];
+    };
+    context?: {
+        before?: number;
+        after?: number;
+    };
+    limits?: {
+        maxLines?: number;
+        maxMatchesPerFile?: number;
+    };
+    pagination?: {
+        cursor?: string;
+        limit?: number;
+    };
+}
+interface GrepLine {
+    lineNumber: number;
+    text: string;
+    type: string;
+}
+interface GrepFileMatch {
+    path: string;
+    lines: GrepLine[];
+}
+interface GrepResult {
+    query: {
+        pattern: string;
+        caseSensitive: boolean;
+    };
+    repo: {
+        ref: string;
+        commit: string;
+    };
+    matches: GrepFileMatch[];
+    nextCursor?: string;
+    hasMore: boolean;
+}
 interface DiffStats {
     files: number;
     additions: number;
@@ -910,4 +962,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, 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 CreateRepoOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, GitStorage, type GitStorageOptions, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, 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 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 CreateRepoOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, 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 OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, 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

@@ -455,6 +455,7 @@ interface Repo {
     listCommits(options?: ListCommitsOptions): Promise<ListCommitsResult>;
     getBranchDiff(options: GetBranchDiffOptions): Promise<GetBranchDiffResult>;
     getCommitDiff(options: GetCommitDiffOptions): Promise<GetCommitDiffResult>;
+    grep(options: GrepOptions): Promise<GrepResult>;
     pullUpstream(options?: PullUpstreamOptions): Promise<void>;
     restoreCommit(options: RestoreCommitOptions): Promise<RestoreCommitResult>;
     createBranch(options: CreateBranchOptions): Promise<CreateBranchResult>;
@@ -592,6 +593,57 @@ interface GetCommitDiffResult {
     files: FileDiff[];
     filteredFiles: FilteredFile[];
 }
+interface GrepOptions extends GitStorageInvocationOptions {
+    ref?: string;
+    paths?: string[];
+    query: {
+        pattern: string;
+        /**
+         * Default is case-sensitive.
+         * When omitted, the server default is used.
+         */
+        caseSensitive?: boolean;
+    };
+    fileFilters?: {
+        includeGlobs?: string[];
+        excludeGlobs?: string[];
+        extensionFilters?: string[];
+    };
+    context?: {
+        before?: number;
+        after?: number;
+    };
+    limits?: {
+        maxLines?: number;
+        maxMatchesPerFile?: number;
+    };
+    pagination?: {
+        cursor?: string;
+        limit?: number;
+    };
+}
+interface GrepLine {
+    lineNumber: number;
+    text: string;
+    type: string;
+}
+interface GrepFileMatch {
+    path: string;
+    lines: GrepLine[];
+}
+interface GrepResult {
+    query: {
+        pattern: string;
+        caseSensitive: boolean;
+    };
+    repo: {
+        ref: string;
+        commit: string;
+    };
+    matches: GrepFileMatch[];
+    nextCursor?: string;
+    hasMore: boolean;
+}
 interface DiffStats {
     files: number;
     additions: number;
@@ -910,4 +962,4 @@ declare function createClient(options: GitStorageOptions): GitStorage;
 
 type StorageOptions = GitStorageOptions;
 
-export { ApiError, 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 CreateRepoOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, GitStorage, type GitStorageOptions, type LegacyCreateCommitOptions, type ListBranchesOptions, type ListBranchesResponse, type ListBranchesResult, type ListCommitsOptions, type ListCommitsResponse, type ListCommitsResult, type ListFilesOptions, type ListFilesResponse, type ListFilesResult, type OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, 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 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 CreateRepoOptions, type DeleteRepoOptions, type DeleteRepoResult, type DiffFileBase, type DiffFileState, type DiffSource, type DiffStats, type FileDiff, type FileLike, type FilteredFile, type FindOneOptions, type GetBranchDiffOptions, type GetBranchDiffResponse, type GetBranchDiffResult, type GetCommitDiffOptions, type GetCommitDiffResponse, type GetCommitDiffResult, type GetFileOptions, type GetRemoteURLOptions, type GitFileMode, 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 OverrideableGitStorageOptions, type ParsedWebhookSignature, type PullUpstreamOptions, type RawBranchInfo, type RawCommitInfo, type RawFileDiff, type RawFilteredFile, type RawWebhookPushEvent, type ReadableStreamLike, type ReadableStreamReaderLike, type RefUpdate, RefUpdateError, type RefUpdateReason, type Repo, 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

@@ -150,6 +150,28 @@ var restoreCommitResponseSchema = z.object({
   commit: restoreCommitCommitSchema.partial().optional().nullable(),
   result: refUpdateResultWithOptionalsSchema
 });
+var grepLineSchema = z.object({
+  line_number: z.number(),
+  text: z.string(),
+  type: z.string()
+});
+var grepFileMatchSchema = z.object({
+  path: z.string(),
+  lines: z.array(grepLineSchema)
+});
+var grepResponseSchema = z.object({
+  query: z.object({
+    pattern: z.string(),
+    case_sensitive: z.boolean()
+  }),
+  repo: z.object({
+    ref: z.string(),
+    commit: z.string()
+  }),
+  matches: z.array(grepFileMatchSchema),
+  next_cursor: z.string().nullable().optional(),
+  has_more: z.boolean()
+});
 var errorEnvelopeSchema = z.object({
   error: z.string()
 });
@@ -444,7 +466,7 @@ function concatChunks(a, b) {
 
 // package.json
 var package_default = {
-  version: "0.4.0"};
+  version: "0.4.1"};
 
 // src/version.ts
 var PACKAGE_NAME = "code-storage-sdk";
@@ -1513,6 +1535,19 @@ function transformCreateBranchResult(raw) {
     commitSha: raw.commit_sha ?? void 0
   };
 }
+function transformGrepLine(raw) {
+  return {
+    lineNumber: raw.line_number,
+    text: raw.text,
+    type: raw.type
+  };
+}
+function transformGrepFileMatch(raw) {
+  return {
+    path: raw.path,
+    lines: raw.lines.map(transformGrepLine)
+  };
+}
 var RepoImpl = class {
   constructor(id, options, generateJWT) {
     this.id = id;
@@ -1665,6 +1700,69 @@ var RepoImpl = class {
     const raw = commitDiffResponseSchema.parse(await response.json());
     return transformCommitDiffResult(raw);
   }
+  async grep(options) {
+    const pattern = options?.query?.pattern?.trim();
+    if (!pattern) {
+      throw new Error("grep query.pattern is required");
+    }
+    const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
+    const jwt = await this.generateJWT(this.id, {
+      permissions: ["git:read"],
+      ttl
+    });
+    const body = {
+      query: {
+        pattern,
+        ...typeof options.query.caseSensitive === "boolean" ? { case_sensitive: options.query.caseSensitive } : {}
+      }
+    };
+    if (options.ref) {
+      body.rev = options.ref;
+    }
+    if (Array.isArray(options.paths) && options.paths.length > 0) {
+      body.paths = options.paths;
+    }
+    if (options.fileFilters) {
+      body.file_filters = {
+        ...options.fileFilters.includeGlobs ? { include_globs: options.fileFilters.includeGlobs } : {},
+        ...options.fileFilters.excludeGlobs ? { exclude_globs: options.fileFilters.excludeGlobs } : {},
+        ...options.fileFilters.extensionFilters ? { extension_filters: options.fileFilters.extensionFilters } : {}
+      };
+    }
+    if (options.context) {
+      body.context = {
+        ...typeof options.context.before === "number" ? { before: options.context.before } : {},
+        ...typeof options.context.after === "number" ? { after: options.context.after } : {}
+      };
+    }
+    if (options.limits) {
+      body.limits = {
+        ...typeof options.limits.maxLines === "number" ? { max_lines: options.limits.maxLines } : {},
+        ...typeof options.limits.maxMatchesPerFile === "number" ? { max_matches_per_file: options.limits.maxMatchesPerFile } : {}
+      };
+    }
+    if (options.pagination) {
+      body.pagination = {
+        ...typeof options.pagination.cursor === "string" && options.pagination.cursor.trim() !== "" ? { cursor: options.pagination.cursor } : {},
+        ...typeof options.pagination.limit === "number" ? { limit: options.pagination.limit } : {}
+      };
+    }
+    const response = await this.api.post({ path: "repos/grep", body }, jwt);
+    const raw = grepResponseSchema.parse(await response.json());
+    return {
+      query: {
+        pattern: raw.query.pattern,
+        caseSensitive: raw.query.case_sensitive
+      },
+      repo: {
+        ref: raw.repo.ref,
+        commit: raw.repo.commit
+      },
+      matches: raw.matches.map(transformGrepFileMatch),
+      nextCursor: raw.next_cursor ?? void 0,
+      hasMore: raw.has_more
+    };
+  }
   async pullUpstream(options = {}) {
     const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
     const jwt = await this.generateJWT(this.id, {