@pierre/storage 0.4.0 → 0.4.2

package/package.json

@@ -1,39 +1,40 @@
 {
-  "name": "@pierre/storage",
-  "version": "0.4.0",
-  "description": "Pierre Git Storage SDK",
-  "license": "MIT",
-  "type": "module",
-  "main": "./dist/index.cjs",
-  "module": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "exports": {
-    ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs",
-      "default": "./dist/index.js"
-    }
-  },
-  "files": [
-    "dist",
-    "src"
-  ],
-  "dependencies": {
-    "jose": "^5.10.0",
-    "snakecase-keys": "^9.0.2",
-    "zod": "^3.23.8"
-  },
-  "devDependencies": {
-    "tsup": "8.5.0",
-    "typescript": "5.8.3",
-    "vitest": "3.2.4"
-  },
-  "publishConfig": {
-    "access": "public"
-  },
-  "scripts": {
-    "build": "tsup",
-    "dev": "tsup --watch"
-  }
-}
+	"name": "@pierre/storage",
+	"version": "0.4.2",
+	"description": "Pierre Git Storage SDK",
+	"license": "MIT",
+	"type": "module",
+	"main": "./dist/index.cjs",
+	"module": "./dist/index.js",
+	"types": "./dist/index.d.ts",
+	"exports": {
+		".": {
+			"types": "./dist/index.d.ts",
+			"import": "./dist/index.js",
+			"require": "./dist/index.cjs",
+			"default": "./dist/index.js"
+		}
+	},
+	"files": [
+		"dist",
+		"src"
+	],
+	"scripts": {
+		"build": "tsup",
+		"dev": "tsup --watch",
+		"prepublishOnly": "pnpm build"
+	},
+	"dependencies": {
+		"jose": "^5.10.0",
+		"snakecase-keys": "^9.0.2",
+		"zod": "^3.23.8"
+	},
+	"devDependencies": {
+		"tsup": "8.5.0",
+		"typescript": "5.8.3",
+		"vitest": "3.2.4"
+	},
+	"publishConfig": {
+		"access": "public"
+	}
+}

package/src/index.ts

@@ -15,6 +15,7 @@ import {
 	branchDiffResponseSchema,
 	commitDiffResponseSchema,
 	createBranchResponseSchema,
+	grepResponseSchema,
 	listBranchesResponseSchema,
 	listCommitsResponseSchema,
 	listFilesResponseSchema,
@@ -47,6 +48,10 @@ import type {
 	GetFileOptions,
 	GetRemoteURLOptions,
 	GitStorageOptions,
+	GrepFileMatch,
+	GrepLine,
+	GrepOptions,
+	GrepResult,
 	ListBranchesOptions,
 	ListBranchesResponse,
 	ListBranchesResult,
@@ -332,6 +337,24 @@ function transformCreateBranchResult(raw: CreateBranchResponse): CreateBranchRes
 	};
 }
 
+function transformGrepLine(raw: { line_number: number; text: string; type: string }): GrepLine {
+	return {
+		lineNumber: raw.line_number,
+		text: raw.text,
+		type: raw.type,
+	};
+}
+
+function transformGrepFileMatch(raw: {
+	path: string;
+	lines: { line_number: number; text: string; type: string }[];
+}): GrepFileMatch {
+	return {
+		path: raw.path,
+		lines: raw.lines.map(transformGrepLine),
+	};
+}
+
 /**
  * Implementation of the Repo interface
  */
@@ -524,6 +547,91 @@ class RepoImpl implements Repo {
 		return transformCommitDiffResult(raw);
 	}
 
+	async grep(options: GrepOptions): Promise<GrepResult> {
+		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: Record<string, unknown> = {
+			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 ?? undefined,
+			hasMore: raw.has_more,
+		};
+	}
+
 	async pullUpstream(options: PullUpstreamOptions = {}): Promise<void> {
 		const ttl = resolveInvocationTtlSeconds(options, DEFAULT_TOKEN_TTL_SECONDS);
 		const jwt = await this.generateJWT(this.id, {

package/src/schemas.ts

@@ -128,6 +128,31 @@ export const restoreCommitResponseSchema = z.object({
 	result: refUpdateResultWithOptionalsSchema,
 });
 
+export const grepLineSchema = z.object({
+	line_number: z.number(),
+	text: z.string(),
+	type: z.string(),
+});
+
+export const grepFileMatchSchema = z.object({
+	path: z.string(),
+	lines: z.array(grepLineSchema),
+});
+
+export const 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(),
+});
+
 export const errorEnvelopeSchema = z.object({
 	error: z.string(),
 });
@@ -144,3 +169,4 @@ export type GetCommitDiffResponseRaw = z.infer<typeof commitDiffResponseSchema>;
 export type CreateBranchResponseRaw = z.infer<typeof createBranchResponseSchema>;
 export type CommitPackAckRaw = z.infer<typeof commitPackAckSchema>;
 export type RestoreCommitAckRaw = z.infer<typeof restoreCommitAckSchema>;
+export type GrepResponseRaw = z.infer<typeof grepResponseSchema>;

package/src/types.ts

@@ -46,6 +46,7 @@ export 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>;
@@ -223,6 +224,62 @@ export interface GetCommitDiffResult {
 	filteredFiles: FilteredFile[];
 }
 
+// Grep API types
+export 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;
+	};
+}
+
+export interface GrepLine {
+	lineNumber: number;
+	text: string;
+	type: string;
+}
+
+export interface GrepFileMatch {
+	path: string;
+	lines: GrepLine[];
+}
+
+export interface GrepResult {
+	query: {
+		pattern: string;
+		caseSensitive: boolean;
+	};
+	repo: {
+		ref: string;
+		commit: string;
+	};
+	matches: GrepFileMatch[];
+	nextCursor?: string;
+	hasMore: boolean;
+}
+
 // Shared diff types
 export interface DiffStats {
 	files: number;