@c4a/extract-proto 0.7.10-alpha.1 → 0.7.10-alpha.2

package/index.d.ts

@@ -0,0 +1,586 @@
+import { z } from 'zod';
+
+declare const indexerEvidenceAdapterResultSchema: z.ZodEffects<z.ZodObject<{
+	protocol: z.ZodLiteral<"context.indexer.evidence-adapter-result/v1">;
+	adapter: z.ZodObject<{
+		id: z.ZodEffects<z.ZodString, string, string>;
+		package: z.ZodString;
+		export: z.ZodString;
+		version: z.ZodString;
+		digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	}, {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	}>;
+	authorized_scope: z.ZodObject<{
+		source_ref: z.ZodString;
+		module_refs: z.ZodArray<z.ZodString, "many">;
+		scope_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	}, {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	}>;
+	input_digest: z.ZodString;
+	precedence: z.ZodNumber;
+	files: z.ZodArray<z.ZodEffects<z.ZodObject<{
+		file_ref: z.ZodString;
+		source_ref: z.ZodString;
+		module_ref: z.ZodNullable<z.ZodString>;
+		normalized_path: z.ZodEffects<z.ZodString, string, string>;
+		role: z.ZodEnum<[
+			"primary-owner",
+			"enricher"
+		]>;
+		coverage_tier: z.ZodEnum<[
+			"ast-catalog",
+			"lightweight-evidence"
+		]>;
+		disposition: z.ZodEnum<[
+			"analyzed",
+			"unsupported",
+			"excluded"
+		]>;
+		facts: z.ZodArray<z.ZodObject<{
+			fact_ref: z.ZodString;
+			kind: z.ZodEffects<z.ZodString, string, string>;
+			locator: z.ZodObject<{
+				source_ref: z.ZodString;
+				module_ref: z.ZodNullable<z.ZodString>;
+				normalized_path: z.ZodEffects<z.ZodString, string, string>;
+				qualified_item_path: z.ZodString;
+				signature_digest: z.ZodString;
+			}, "strict", z.ZodTypeAny, {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			}, {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			}>;
+			payload_digest: z.ZodString;
+			denominator: z.ZodEnum<[
+				"none",
+				"eligible-file",
+				"loc",
+				"symbol",
+				"protocol-item"
+			]>;
+		}, "strict", z.ZodTypeAny, {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}, {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}>, "many">;
+	}, "strict", z.ZodTypeAny, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}>, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}, {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}>, "many">;
+	diagnostics: z.ZodArray<z.ZodObject<{
+		code: z.ZodEffects<z.ZodString, string, string>;
+		fact_ref: z.ZodOptional<z.ZodString>;
+		severity: z.ZodEnum<[
+			"info",
+			"warning",
+			"error"
+		]>;
+		detail_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}, {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}>, "many">;
+	toolchain: z.ZodArray<z.ZodEffects<z.ZodObject<{
+		step: z.ZodEffects<z.ZodString, string, string>;
+		package: z.ZodString;
+		export: z.ZodString;
+		version: z.ZodString;
+		digest: z.ZodString;
+		capabilities: z.ZodArray<z.ZodEffects<z.ZodString, string, string>, "many">;
+		input_digest: z.ZodString;
+		output_digest: z.ZodString;
+	}, "strict", z.ZodTypeAny, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}>, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}, {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}>, "many">;
+	output_digest: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}>, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}, {
+	input_digest: string;
+	output_digest: string;
+	protocol: "context.indexer.evidence-adapter-result/v1";
+	adapter: {
+		package: string;
+		id: string;
+		version: string;
+		digest: string;
+		export: string;
+	};
+	authorized_scope: {
+		source_ref: string;
+		module_refs: string[];
+		scope_digest: string;
+	};
+	precedence: number;
+	files: {
+		source_ref: string;
+		module_ref: string | null;
+		normalized_path: string;
+		file_ref: string;
+		role: "primary-owner" | "enricher";
+		coverage_tier: "ast-catalog" | "lightweight-evidence";
+		disposition: "analyzed" | "unsupported" | "excluded";
+		facts: {
+			kind: string;
+			fact_ref: string;
+			locator: {
+				source_ref: string;
+				module_ref: string | null;
+				normalized_path: string;
+				qualified_item_path: string;
+				signature_digest: string;
+			};
+			payload_digest: string;
+			denominator: "symbol" | "none" | "eligible-file" | "loc" | "protocol-item";
+		}[];
+	}[];
+	diagnostics: {
+		code: string;
+		severity: "warning" | "info" | "error";
+		detail_digest: string;
+		fact_ref?: string | undefined;
+	}[];
+	toolchain: {
+		package: string;
+		version: string;
+		digest: string;
+		export: string;
+		step: string;
+		capabilities: string[];
+		input_digest: string;
+		output_digest: string;
+	}[];
+}>;
+type IndexerEvidenceAdapterResult = z.infer<typeof indexerEvidenceAdapterResultSchema>;
+type IndexerEvidenceAdapterFactPayloadValue = null | boolean | number | string | IndexerEvidenceAdapterFactPayloadValue[] | {
+	[key: string]: IndexerEvidenceAdapterFactPayloadValue;
+};
+interface IndexerEvidenceAdapterFactPayload {
+	fact_ref: string;
+	payload: IndexerEvidenceAdapterFactPayloadValue;
+}
+interface IndexerEvidenceAdapterMaterialization {
+	result: IndexerEvidenceAdapterResult;
+	fact_payloads: IndexerEvidenceAdapterFactPayload[];
+}
+export interface ProtoToken {
+	kind: "identifier" | "string" | "number" | "symbol";
+	value: string;
+	line: number;
+	column: number;
+}
+export declare class ProtoSyntaxError extends Error {
+	readonly line: number;
+	readonly column: number;
+	constructor(message: string, line: number, column: number);
+}
+export declare function lexProto(source: string): ProtoToken[];
+interface ProtoField {
+	name: string;
+	type: string;
+	number: string;
+	optional?: boolean;
+	repeated: boolean;
+	oneof?: string;
+	defaultValue?: string;
+	location: {
+		line: number;
+		column: number;
+	};
+}
+export interface ProtoLocator {
+	path: string;
+	line: number;
+	column: number;
+}
+export interface ProtoImport {
+	path: string;
+	resolved_path: string;
+	modifier: "normal" | "public" | "weak" | "option";
+	locator: ProtoLocator;
+}
+export interface ProtoOption {
+	owner: string;
+	name: string;
+	locator: ProtoLocator;
+}
+export interface ProtoType {
+	kind: "message" | "enum";
+	name: string;
+	qualified_name: string;
+	fields?: ProtoField[];
+	locator: ProtoLocator;
+}
+export interface ProtoMethod {
+	name: string;
+	input_type: string;
+	output_type: string;
+	client_streaming: boolean;
+	server_streaming: boolean;
+	locator: ProtoLocator;
+}
+export interface ProtoService {
+	name: string;
+	methods: ProtoMethod[];
+	locator: ProtoLocator;
+}
+export interface ProtoDocument {
+	path: string;
+	disposition: "analyzed" | "unsupported" | "excluded";
+	syntax: string | null;
+	package: string | null;
+	imports: ProtoImport[];
+	options: ProtoOption[];
+	types: ProtoType[];
+	services: ProtoService[];
+	diagnostic: string | null;
+}
+export declare function parseProtoSources(files: Readonly<Record<string, string>>, options?: {
+	import_roots?: readonly string[];
+}): ProtoDocument[];
+export declare const PROTO_EVIDENCE_ADAPTER_EXPORT = "protoSourcesToEvidenceAdapterMaterialization";
+export interface ProtoEvidenceAdapterInvocation {
+	adapter: IndexerEvidenceAdapterResult["adapter"];
+	authorized_scope: IndexerEvidenceAdapterResult["authorized_scope"];
+	input_digest: string;
+	precedence: number;
+	import_roots?: readonly string[];
+	module_refs?: Readonly<Record<string, string | null>>;
+	role?: "primary-owner" | "enricher";
+}
+/** Parses only the caller-provided source map and converts it to the common Evidence ABI. */
+export declare function protoSourcesToEvidenceAdapterResult(files: Readonly<Record<string, string>>, invocation: ProtoEvidenceAdapterInvocation): IndexerEvidenceAdapterResult;
+export declare function protoSourcesToEvidenceAdapterMaterialization(files: Readonly<Record<string, string>>, invocation: ProtoEvidenceAdapterInvocation): IndexerEvidenceAdapterMaterialization;
+
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@c4a/extract-proto",
-  "version": "0.7.10-alpha.1",
+  "version": "0.7.10-alpha.2",
   "type": "module",
   "description": "Protocol Buffers IDL catalog parser for Context",
   "license": "MIT",
@@ -18,5 +18,9 @@
   "engines": {
     "node": ">=20"
   },
-  "main": "./index.js"
+  "dependencies": {
+    "zod": "^3.23.8"
+  },
+  "main": "./index.js",
+  "types": "./index.d.ts"
 }