@dreki-gg/pi-doc-search 0.2.0

package/extensions/doc-search/types.ts

@@ -0,0 +1,142 @@
+export interface DocSearchConfigFile {
+  apiKey?: string;
+  cache?: {
+    resolveTtlHours?: number;
+    docsTtlHours?: number;
+  };
+}
+
+export interface DocSearchSettings {
+  extensionDir: string;
+  configPath: string;
+  cacheDir: string;
+  apiKey?: string;
+  resolveTtlMs: number;
+  docsTtlMs: number;
+  configError?: string;
+}
+
+export interface SearchResult {
+  id: string;
+  title: string;
+  description: string;
+  totalSnippets?: number;
+  trustScore?: number;
+  benchmarkScore?: number;
+  versions?: string[];
+  source?: string;
+}
+
+export interface SearchResponse {
+  results: SearchResult[];
+  searchFilterApplied?: boolean;
+  error?: string;
+}
+
+export interface Context7ApiError {
+  kind: 'auth' | 'rate_limit' | 'not_found' | 'network' | 'invalid_response' | 'unknown';
+  status?: number;
+  message: string;
+  upstreamMessage?: string;
+}
+
+export type Context7ApiResult<T> = { ok: true; data: T } | { ok: false; error: Context7ApiError };
+
+export interface ResolveCacheEntry {
+  kind: 'resolve';
+  cacheKey: string;
+  objectKey: string;
+  libraryName: string;
+  normalizedLibraryName: string;
+  query: string;
+  createdAt: string;
+  expiresAt: string;
+  results: SearchResult[];
+}
+
+export interface ResolveCacheIndexEntry {
+  kind: 'resolve';
+  cacheKey: string;
+  objectKey: string;
+  libraryName: string;
+  normalizedLibraryName: string;
+  query: string;
+  createdAt: string;
+  expiresAt: string;
+  resultCount: number;
+}
+
+export interface DocCacheEntry {
+  kind: 'docs';
+  docRef: string;
+  objectKey: string;
+  libraryId: string;
+  libraryName: string;
+  normalizedLibraryName: string;
+  libraryVersion?: string;
+  libraryVersionRaw?: string;
+  query: string;
+  topic?: string;
+  effectiveQuery: string;
+  page: number;
+  createdAt: string;
+  expiresAt: string;
+  rawText: string;
+  curatedText: string;
+}
+
+export interface DocCacheIndexEntry {
+  kind: 'docs';
+  docRef: string;
+  objectKey: string;
+  libraryId: string;
+  libraryName: string;
+  normalizedLibraryName: string;
+  libraryVersion?: string;
+  libraryVersionRaw?: string;
+  query: string;
+  topic?: string;
+  effectiveQuery: string;
+  page: number;
+  createdAt: string;
+  expiresAt: string;
+  rawLength: number;
+  curatedLength: number;
+}
+
+export interface CacheLookup<T> {
+  entry?: T;
+  fresh: boolean;
+}
+
+export interface CacheSearchSelector {
+  docRef?: string;
+  libraryId?: string;
+  libraryName?: string;
+  libraryVersion?: string;
+  query?: string;
+  topic?: string;
+  page?: number;
+}
+
+export interface CuratedDocResult {
+  text: string;
+  truncated: boolean;
+  selectedSectionCount: number;
+  rawLength: number;
+}
+
+export interface ResolveLibraryParams {
+  libraryName: string;
+  query?: string;
+}
+
+export interface GetLibraryDocsParams {
+  libraryId?: string;
+  libraryName?: string;
+  query?: string;
+  topic?: string;
+  page?: number;
+}
+
+export interface GetCachedDocRawParams extends CacheSearchSelector {}

package/package.json

@@ -0,0 +1,50 @@
+{
+  "name": "@dreki-gg/pi-doc-search",
+  "version": "0.2.0",
+  "description": "Library doc-search tools for pi, powered by Context7 \u2014 direct HTTP, persistent cache, no MCP dependency",
+  "keywords": [
+    "pi-package",
+    "pi",
+    "docs",
+    "documentation",
+    "context7"
+  ],
+  "author": "Juan Albarran <jalbarrandev@gmail.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jalbarrang/pi-doc-search.git"
+  },
+  "type": "module",
+  "scripts": {
+    "typecheck": "tsc --noEmit",
+    "lint": "oxlint extensions",
+    "format": "oxfmt --write extensions",
+    "format:check": "oxfmt --check extensions"
+  },
+  "pi": {
+    "extensions": [
+      "./extensions/doc-search"
+    ]
+  },
+  "devDependencies": {
+    "@types/node": "24",
+    "oxfmt": "^0.43.0",
+    "oxlint": "^1.58.0",
+    "typescript": "^6.0.0",
+    "@earendil-works/pi-coding-agent": "^0.75.4",
+    "typebox": "^1.0.55"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*",
+    "typebox": "*"
+  },
+  "peerDependenciesMeta": {
+    "@earendil-works/pi-coding-agent": {
+      "optional": true
+    },
+    "typebox": {
+      "optional": true
+    }
+  }
+}

package/release-please-config.json

@@ -0,0 +1,9 @@
+{
+  "$schema": "https://raw.githubusercontent.com/googleapis/release-please/main/schemas/config.json",
+  "release-type": "node",
+  "bump-minor-pre-major": true,
+  "include-component-in-tag": false,
+  "packages": {
+    ".": {}
+  }
+}

package/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ESNext",
+    "moduleResolution": "bundler",
+    "strict": true,
+    "noEmit": true,
+    "skipLibCheck": true,
+    "esModuleInterop": true,
+    "resolveJsonModule": true,
+    "isolatedModules": true,
+    "incremental": true,
+    "tsBuildInfoFile": "./node_modules/.cache/doc-search.tsbuildinfo",
+    "rootDir": "."
+  },
+  "include": ["extensions/**/*.ts"]
+}