@enbox/gitd 0.0.1

package/dist/types/github-shim/issues.d.ts

@@ -0,0 +1,24 @@
+/**
+ * GitHub API shim — `/repos/:did/:repo/issues` endpoints.
+ *
+ * Maps DWN issue records to GitHub REST API v3 issue responses.
+ *
+ * Endpoints:
+ *   GET  /repos/:did/:repo/issues                    List issues
+ *   GET  /repos/:did/:repo/issues/:number            Issue detail
+ *   GET  /repos/:did/:repo/issues/:number/comments   Issue comments
+ *   POST /repos/:did/:repo/issues                    Create issue
+ *   PATCH /repos/:did/:repo/issues/:number           Update issue
+ *   POST /repos/:did/:repo/issues/:number/comments   Create comment
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+import type { JsonResponse } from './helpers.js';
+export declare function handleListIssues(ctx: AgentContext, targetDid: string, repoName: string, url: URL): Promise<JsonResponse>;
+export declare function handleGetIssue(ctx: AgentContext, targetDid: string, repoName: string, number: string, url: URL): Promise<JsonResponse>;
+export declare function handleListIssueComments(ctx: AgentContext, targetDid: string, repoName: string, number: string, url: URL): Promise<JsonResponse>;
+export declare function handleCreateIssue(ctx: AgentContext, targetDid: string, repoName: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+export declare function handleUpdateIssue(ctx: AgentContext, targetDid: string, repoName: string, number: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+export declare function handleCreateIssueComment(ctx: AgentContext, targetDid: string, repoName: string, number: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+//# sourceMappingURL=issues.d.ts.map

package/dist/types/github-shim/issues.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"issues.d.ts","sourceRoot":"","sources":["../../../src/github-shim/issues.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA8DjD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/D,OAAO,CAAC,YAAY,CAAC,CAqDvB;AAMD,wBAAsB,cAAc,CAClC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/E,OAAO,CAAC,YAAY,CAAC,CAgCvB;AAMD,wBAAsB,uBAAuB,CAC3C,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/E,OAAO,CAAC,YAAY,CAAC,CA0DvB;AAMD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzC,OAAO,CAAC,YAAY,CAAC,CA8BvB;AAMD,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzD,OAAO,CAAC,YAAY,CAAC,CA2CvB;AAMD,wBAAsB,wBAAwB,CAC5C,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzD,OAAO,CAAC,YAAY,CAAC,CAgDvB"}

package/dist/types/github-shim/pulls.d.ts

@@ -0,0 +1,31 @@
+/**
+ * GitHub API shim — `/repos/:did/:repo/pulls` endpoints.
+ *
+ * Maps DWN patch records to GitHub REST API v3 pull request responses.
+ *
+ * Endpoints:
+ *   GET   /repos/:did/:repo/pulls                    List pull requests
+ *   GET   /repos/:did/:repo/pulls/:number            Pull request detail
+ *   GET   /repos/:did/:repo/pulls/:number/reviews    Pull request reviews
+ *   POST  /repos/:did/:repo/pulls                    Create pull request
+ *   PATCH /repos/:did/:repo/pulls/:number            Update pull request
+ *   PUT   /repos/:did/:repo/pulls/:number/merge      Merge pull request
+ *   POST  /repos/:did/:repo/pulls/:number/reviews    Create review
+ *
+ * Status mapping:
+ *   - `open`   -> state: "open"
+ *   - `closed` -> state: "closed", merged: false
+ *   - `merged` -> state: "closed", merged: true
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+import type { JsonResponse } from './helpers.js';
+export declare function handleListPulls(ctx: AgentContext, targetDid: string, repoName: string, url: URL): Promise<JsonResponse>;
+export declare function handleGetPull(ctx: AgentContext, targetDid: string, repoName: string, number: string, url: URL): Promise<JsonResponse>;
+export declare function handleListPullReviews(ctx: AgentContext, targetDid: string, repoName: string, number: string, url: URL): Promise<JsonResponse>;
+export declare function handleCreatePull(ctx: AgentContext, targetDid: string, repoName: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+export declare function handleUpdatePull(ctx: AgentContext, targetDid: string, repoName: string, number: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+export declare function handleMergePull(ctx: AgentContext, targetDid: string, repoName: string, number: string, reqBody: Record<string, unknown>, _url: URL): Promise<JsonResponse>;
+export declare function handleCreatePullReview(ctx: AgentContext, targetDid: string, repoName: string, number: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+//# sourceMappingURL=pulls.d.ts.map

package/dist/types/github-shim/pulls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pulls.d.ts","sourceRoot":"","sources":["../../../src/github-shim/pulls.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAoGjD,wBAAsB,eAAe,CACnC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/D,OAAO,CAAC,YAAY,CAAC,CAoDvB;AAMD,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/E,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAMD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/E,OAAO,CAAC,YAAY,CAAC,CA4DvB;AAMD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzC,OAAO,CAAC,YAAY,CAAC,CAuCvB;AAMD,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzD,OAAO,CAAC,YAAY,CAAC,CA8CvB;AAMD,wBAAsB,eAAe,CACnC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,GAAG,GAC1D,OAAO,CAAC,YAAY,CAAC,CAmDvB;AAMD,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzD,OAAO,CAAC,YAAY,CAAC,CAmDvB"}

package/dist/types/github-shim/releases.d.ts

@@ -0,0 +1,18 @@
+/**
+ * GitHub API shim — `/repos/:did/:repo/releases` endpoints.
+ *
+ * Maps DWN release records to GitHub REST API v3 release responses.
+ *
+ * Endpoints:
+ *   GET  /repos/:did/:repo/releases            List releases
+ *   GET  /repos/:did/:repo/releases/tags/:tag  Release by tag name
+ *   POST /repos/:did/:repo/releases            Create release
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+import type { JsonResponse } from './helpers.js';
+export declare function handleListReleases(ctx: AgentContext, targetDid: string, repoName: string, url: URL): Promise<JsonResponse>;
+export declare function handleGetReleaseByTag(ctx: AgentContext, targetDid: string, repoName: string, tag: string, url: URL): Promise<JsonResponse>;
+export declare function handleCreateRelease(ctx: AgentContext, targetDid: string, repoName: string, reqBody: Record<string, unknown>, url: URL): Promise<JsonResponse>;
+//# sourceMappingURL=releases.d.ts.map

package/dist/types/github-shim/releases.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../../src/github-shim/releases.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AA4DjD,wBAAsB,kBAAkB,CACtC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/D,OAAO,CAAC,YAAY,CAAC,CAiCvB;AAMD,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC5E,OAAO,CAAC,YAAY,CAAC,CAuBvB;AAMD,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EACtD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,EAAE,GAAG,GACzC,OAAO,CAAC,YAAY,CAAC,CAmCvB"}

package/dist/types/github-shim/repos.d.ts

@@ -0,0 +1,21 @@
+/**
+ * GitHub API shim — `/repos/:did/:repo` endpoint.
+ *
+ * Maps the DWN singleton repo record to a GitHub REST API v3
+ * repository response.  The `:repo` segment is validated against the
+ * stored repo name but is otherwise informational — repos are singletons
+ * per DID in gitd.
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+import type { JsonResponse, RepoInfo } from './helpers.js';
+/** Build a GitHub-style repository object from DWN data. */
+export declare function buildRepoResponse(repo: RepoInfo, targetDid: string, repoName: string, baseUrl: string): Record<string, unknown>;
+/**
+ * Handle `GET /repos/:did/:repo`.
+ *
+ * Returns a GitHub-style repository JSON response.
+ */
+export declare function handleGetRepo(ctx: AgentContext, targetDid: string, repoName: string, url: URL): Promise<JsonResponse>;
+//# sourceMappingURL=repos.d.ts.map

package/dist/types/github-shim/repos.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repos.d.ts","sourceRoot":"","sources":["../../../src/github-shim/repos.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAgB3D,4DAA4D;AAC5D,wBAAgB,iBAAiB,CAC/B,IAAI,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GACnE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8CzB;AAED;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,GAAG,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC/D,OAAO,CAAC,YAAY,CAAC,CAQvB"}

package/dist/types/github-shim/server.d.ts

@@ -0,0 +1,53 @@
+/**
+ * GitHub API compatibility shim — HTTP server and router.
+ *
+ * Translates GitHub REST API v3 requests into DWN queries / writes and
+ * returns GitHub-compatible JSON responses.  This allows existing tools
+ * that speak the GitHub API (VS Code extensions, `gh` CLI, CI/CD
+ * systems) to interact with any DWN-enabled git forge.
+ *
+ * Read endpoints (GET):
+ *   GET  /repos/:did/:repo                          Repository info
+ *   GET  /repos/:did/:repo/issues                   List issues
+ *   GET  /repos/:did/:repo/issues/:number           Issue detail
+ *   GET  /repos/:did/:repo/issues/:number/comments  Issue comments
+ *   GET  /repos/:did/:repo/pulls                    List pull requests
+ *   GET  /repos/:did/:repo/pulls/:number            Pull request detail
+ *   GET  /repos/:did/:repo/pulls/:number/reviews    Pull request reviews
+ *   GET  /repos/:did/:repo/releases                 List releases
+ *   GET  /repos/:did/:repo/releases/tags/:tag       Release by tag
+ *   GET  /users/:did                                User profile
+ *
+ * Write endpoints (POST/PATCH/PUT):
+ *   POST  /repos/:did/:repo/issues                    Create issue
+ *   PATCH /repos/:did/:repo/issues/:number            Update issue
+ *   POST  /repos/:did/:repo/issues/:number/comments   Create issue comment
+ *   POST  /repos/:did/:repo/pulls                     Create pull request
+ *   PATCH /repos/:did/:repo/pulls/:number             Update pull request
+ *   PUT   /repos/:did/:repo/pulls/:number/merge       Merge pull request
+ *   POST  /repos/:did/:repo/pulls/:number/reviews     Create pull review
+ *   POST  /repos/:did/:repo/releases                  Create release
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+import type { JsonResponse } from './helpers.js';
+import type { Server } from 'node:http';
+export type ShimServerOptions = {
+    ctx: AgentContext;
+    port: number;
+};
+/**
+ * Route an incoming request to the appropriate handler.
+ *
+ * This function is exported for testing — tests can call it directly
+ * with a constructed URL without starting an HTTP server.
+ *
+ * @param method  HTTP method (defaults to `'GET'` for backward compat).
+ * @param reqBody Parsed JSON body for POST/PATCH/PUT requests.
+ * @param authHeader The Authorization header value (for write endpoint auth).
+ */
+export declare function handleShimRequest(ctx: AgentContext, url: URL, method?: string, reqBody?: Record<string, unknown>, authHeader?: string | null): Promise<JsonResponse>;
+/** Start the GitHub API shim server. Returns the server instance. */
+export declare function startShimServer(options: ShimServerOptions): Server;
+//# sourceMappingURL=server.d.ts.map

package/dist/types/github-shim/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../../src/github-shim/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAgBxC,MAAM,MAAM,iBAAiB,GAAG;IAC9B,GAAG,EAAG,YAAY,CAAC;IACnB,IAAI,EAAG,MAAM,CAAC;CACf,CAAC;AA0BF;;;;;;;;;GASG;AACH,wBAAsB,iBAAiB,CACrC,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,GAAG,EACR,MAAM,GAAE,MAAc,EACtB,OAAO,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACrC,UAAU,GAAE,MAAM,GAAG,IAAW,GAC/B,OAAO,CAAC,YAAY,CAAC,CA2CvB;AA0FD,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,iBAAiB,GAAG,MAAM,CAsGlE"}

package/dist/types/github-shim/users.d.ts

@@ -0,0 +1,17 @@
+/**
+ * GitHub API shim — `/users/:did` endpoint.
+ *
+ * Synthesizes a GitHub-style user object from a DID.  Since DIDs are
+ * self-sovereign identifiers, we don't have profile data beyond the
+ * DID itself — fields like `name`, `bio`, etc. are left empty.
+ *
+ * @module
+ */
+import type { JsonResponse } from './helpers.js';
+/**
+ * Handle `GET /users/:did`.
+ *
+ * Returns a GitHub-style user profile JSON response.
+ */
+export declare function handleGetUser(targetDid: string, url: URL): Promise<JsonResponse>;
+//# sourceMappingURL=users.d.ts.map

package/dist/types/github-shim/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../src/github-shim/users.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAajD;;;;GAIG;AACH,wBAAsB,aAAa,CACjC,SAAS,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,GAC1B,OAAO,CAAC,YAAY,CAAC,CAgCvB"}

package/dist/types/index.d.ts

@@ -0,0 +1,26 @@
+/**
+ * @enbox/gitd — Decentralized forge protocols for DWN.
+ *
+ * Protocol definitions for a decentralized GitHub alternative.
+ * See PLAN.md for full architecture documentation.
+ *
+ * Each protocol exports:
+ * - Data shape types for each record type (e.g. `IssueData`, `RepoData`)
+ * - A `SchemaMap` type mapping type names to data shapes
+ * - A raw `ProtocolDefinition` (e.g. `ForgeRepoDefinition`)
+ * - A typed protocol created via `defineProtocol()` (e.g. `ForgeRepoProtocol`)
+ *
+ * @packageDocumentation
+ */
+export * from './repo.js';
+export * from './refs.js';
+export * from './issues.js';
+export * from './patches.js';
+export * from './ci.js';
+export * from './releases.js';
+export * from './registry.js';
+export * from './social.js';
+export * from './notifications.js';
+export * from './wiki.js';
+export * from './org.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC"}

package/dist/types/indexer/api.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Indexer REST API — serves JSON responses from the materialized views
+ * in the IndexerStore.
+ *
+ * Endpoints:
+ *
+ *   GET /api/repos                   List all repos (sorted by stars)
+ *   GET /api/repos/search?q=<query>  Search repos by name/topic/language
+ *   GET /api/repos/trending          Trending repos (recent star activity)
+ *   GET /api/repos/:did              Repo detail for a specific DID
+ *   GET /api/repos/:did/stars        Stars for a specific repo
+ *   GET /api/users/:did              User profile summary
+ *   GET /api/stats                   Indexer statistics
+ *
+ * All responses are JSON with `Content-Type: application/json`.
+ *
+ * @module
+ */
+import type { Server } from 'node:http';
+import type { IndexerStore } from './store.js';
+export type ApiServerOptions = {
+    store: IndexerStore;
+    port: number;
+};
+/** Route an incoming request to the appropriate API handler. */
+export declare function handleApiRequest(store: IndexerStore, url: URL): {
+    status: number;
+    body: string;
+};
+/** Start the indexer API server. */
+export declare function startApiServer(options: ApiServerOptions): Server;
+//# sourceMappingURL=api.d.ts.map

package/dist/types/indexer/api.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api.d.ts","sourceRoot":"","sources":["../../../src/indexer/api.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAIxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAM/C,MAAM,MAAM,gBAAgB,GAAG;IAC7B,KAAK,EAAG,YAAY,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;CACf,CAAC;AAMF,gEAAgE;AAChE,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,YAAY,EACnB,GAAG,EAAE,GAAG,GACP;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,CAsElC;AAMD,oCAAoC;AACpC,wBAAgB,cAAc,CAAC,OAAO,EAAE,gBAAgB,GAAG,MAAM,CAkChE"}

package/dist/types/indexer/crawler.d.ts

@@ -0,0 +1,72 @@
+/**
+ * DWN record crawler — queries remote DWNs to build the indexer's
+ * materialized views.
+ *
+ * Uses the `from` parameter on TypedWeb5 queries so the SDK routes
+ * each request to the target DID's DWN endpoint (resolved from their
+ * DID document).  All queried records are `published: true` and have
+ * `{ who: 'anyone', can: ['read'] }`, so no permission grants are
+ * needed.
+ *
+ * The crawler operates incrementally — it tracks the last crawl
+ * timestamp per DID and only processes records created after that
+ * point.
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+import type { IndexerStore } from './store.js';
+/** Options for a crawl run. */
+export type CrawlOptions = {
+    /** Maximum DIDs to crawl per run. */
+    maxDids?: number;
+    /** Crawl only these DIDs (overrides store DID list). */
+    dids?: string[];
+};
+/** Result of a crawl run. */
+export type CrawlResult = {
+    crawledDids: number;
+    newRepos: number;
+    newStars: number;
+    newFollows: number;
+    errors: {
+        did: string;
+        error: string;
+    }[];
+};
+/** Crawls DWN records from registered DIDs and populates the store. */
+export declare class IndexerCrawler {
+    private readonly _ctx;
+    private readonly _store;
+    constructor(ctx: AgentContext, store: IndexerStore);
+    /**
+     * Run a single crawl pass over all registered DIDs.
+     *
+     * For each DID, queries repos, stars, and follows.  Errors on
+     * individual DIDs are captured and returned, not thrown.
+     */
+    crawl(options?: CrawlOptions): Promise<CrawlResult>;
+    /**
+     * Crawl a single DID — queries repos, stars, follows, and repo
+     * metadata (issues, patches, releases counts).
+     */
+    crawlDid(did: string): Promise<{
+        repos: number;
+        stars: number;
+        follows: number;
+    }>;
+    /**
+     * Discover DIDs by following the social graph from a seed DID.
+     *
+     * Queries stars and follows for the seed DID, adds discovered DIDs
+     * to the store, and optionally recurses to a given depth.
+     */
+    discover(seedDid: string, depth?: number): Promise<string[]>;
+    /**
+     * Start a periodic crawl loop.  Crawls all DIDs, then waits
+     * `intervalMs` before the next pass.  Returns a cleanup function
+     * to stop the loop.
+     */
+    startLoop(intervalMs?: number): () => void;
+}
+//# sourceMappingURL=crawler.d.ts.map

package/dist/types/indexer/crawler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"crawler.d.ts","sourceRoot":"","sources":["../../../src/indexer/crawler.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;GAeG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,KAAK,EAAe,YAAY,EAAE,MAAM,YAAY,CAAC;AAM5D,+BAA+B;AAC/B,MAAM,MAAM,YAAY,GAAG;IACzB,qCAAqC;IACrC,OAAO,CAAC,EAAG,MAAM,CAAC;IAClB,wDAAwD;IACxD,IAAI,CAAC,EAAG,MAAM,EAAE,CAAC;CAClB,CAAC;AAEF,6BAA6B;AAC7B,MAAM,MAAM,WAAW,GAAG;IACxB,WAAW,EAAG,MAAM,CAAC;IACrB,QAAQ,EAAG,MAAM,CAAC;IAClB,QAAQ,EAAG,MAAM,CAAC;IAClB,UAAU,EAAG,MAAM,CAAC;IACpB,MAAM,EAAG;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC3C,CAAC;AAMF,uEAAuE;AACvE,qBAAa,cAAc;IACzB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAgB;IACrC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;gBAEpB,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,YAAY;IAKzD;;;;;OAKG;IACU,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,WAAW,CAAC;IA0BhE;;;OAGG;IACU,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IA8G9F;;;;;OAKG;IACU,QAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAU,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA6C5E;;;;OAIG;IACI,SAAS,CAAC,UAAU,GAAE,MAAe,GAAG,MAAM,IAAI;CAgC1D"}

package/dist/types/indexer/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Indexer module — crawls DWN records and serves aggregated views.
+ *
+ * @module
+ */
+export { handleApiRequest, startApiServer } from './api.js';
+export type { ApiServerOptions } from './api.js';
+export { IndexerCrawler } from './crawler.js';
+export type { CrawlOptions, CrawlResult } from './crawler.js';
+export { IndexerStore } from './store.js';
+export type { CrawlCursor, IndexedFollow, IndexedRepo, IndexedStar, RepoWithStars, SearchResult, UserProfile, } from './store.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/types/indexer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/indexer/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,UAAU,CAAC;AAC5D,YAAY,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAEjD,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAC9C,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAE9D,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,YAAY,EACV,WAAW,EACX,aAAa,EACb,WAAW,EACX,WAAW,EACX,aAAa,EACb,YAAY,EACZ,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/types/indexer/main.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env bun
+/**
+ * Indexer entry point — starts the crawler loop and REST API server.
+ *
+ * Usage:
+ *   gitd indexer [--port <api-port>] [--interval <seconds>] [--seed <did>]
+ *
+ * Environment:
+ *   GITD_PASSWORD       Vault password (prompted if not set)
+ *   GITD_INDEXER_PORT   API port (default: 8090)
+ *   GITD_INDEXER_INTERVAL  Crawl interval in seconds (default: 60)
+ *
+ * The indexer requires a local Web5 agent for signing DWN query
+ * messages.  On first run it initializes the agent vault.  Subsequent
+ * runs unlock the existing vault.
+ *
+ * @module
+ */
+import type { AgentContext } from '../cli/agent.js';
+export declare function indexerCommand(ctx: AgentContext, args: string[]): Promise<void>;
+//# sourceMappingURL=main.d.ts.map

package/dist/types/indexer/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/indexer/main.ts"],"names":[],"mappings":";AACA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAWpD,wBAAsB,cAAc,CAAC,GAAG,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAoDrF"}

package/dist/types/indexer/store.d.ts

@@ -0,0 +1,168 @@
+/**
+ * In-memory indexer store — maintains materialized views of data
+ * crawled from distributed DWN records.
+ *
+ * Each entity is keyed by a unique composite identifier (DID + recordId
+ * or similar) and stored in a Map.  Aggregation methods compute star
+ * counts, trending scores, search results, etc. on the fly.
+ *
+ * A production deployment would back this with PostgreSQL or similar,
+ * but the in-memory implementation keeps the MVP dependency-free and
+ * testable.
+ *
+ * @module
+ */
+/** Indexed repo metadata. */
+export type IndexedRepo = {
+    did: string;
+    recordId: string;
+    contextId: string;
+    name: string;
+    description: string;
+    defaultBranch: string;
+    visibility: string;
+    language: string;
+    topics: string[];
+    openIssues: number;
+    openPatches: number;
+    releaseCount: number;
+    lastUpdated: string;
+    indexedAt: string;
+};
+/** Indexed star record. */
+export type IndexedStar = {
+    starrerDid: string;
+    repoDid: string;
+    repoRecordId: string;
+    dateCreated: string;
+};
+/** Indexed follow record. */
+export type IndexedFollow = {
+    followerDid: string;
+    targetDid: string;
+    dateCreated: string;
+};
+/** Crawl cursor — tracks progress per DID for incremental crawling. */
+export type CrawlCursor = {
+    did: string;
+    lastCrawled: string;
+};
+/** Aggregated repo view with star count. */
+export type RepoWithStars = IndexedRepo & {
+    starCount: number;
+};
+/** Search result with relevance score. */
+export type SearchResult = RepoWithStars & {
+    score: number;
+};
+/** User profile summary. */
+export type UserProfile = {
+    did: string;
+    repoCount: number;
+    starCount: number;
+    followerCount: number;
+    followingCount: number;
+};
+/** Configurable size limits for the in-memory store. */
+export type IndexerStoreLimits = {
+    /** Maximum number of tracked DIDs. @default 100_000 */
+    maxDids?: number;
+    /** Maximum number of indexed repos. @default 100_000 */
+    maxRepos?: number;
+    /** Maximum number of indexed stars. @default 500_000 */
+    maxStars?: number;
+    /** Maximum number of indexed follows. @default 500_000 */
+    maxFollows?: number;
+};
+/** In-memory indexer store with configurable size limits. */
+export declare class IndexerStore {
+    /** Repos keyed by `did:recordId`. */
+    private _repos;
+    /** Stars keyed by `starrerDid:repoDid:repoRecordId`. */
+    private _stars;
+    /** Follows keyed by `followerDid:targetDid`. */
+    private _follows;
+    /** Known DIDs to crawl. */
+    private _dids;
+    /** Per-DID crawl cursors. */
+    private _cursors;
+    /** Size limits for LRU-style eviction. */
+    private _limits;
+    constructor(limits?: IndexerStoreLimits);
+    /** Register a DID for crawling. Evicts oldest entry if at capacity. */
+    addDid(did: string): void;
+    /** Remove a DID from the crawl list. */
+    removeDid(did: string): void;
+    /** Get all registered DIDs. */
+    getDids(): string[];
+    /** Get the crawl cursor for a DID. */
+    getCursor(did: string): CrawlCursor | undefined;
+    /** Update the crawl cursor for a DID. */
+    setCursor(did: string, lastCrawled: string): void;
+    /** Upsert an indexed repo. Evicts oldest entry if at capacity. */
+    putRepo(repo: IndexedRepo): void;
+    /** Get an indexed repo by DID (returns first match). */
+    getRepo(did: string): IndexedRepo | undefined;
+    /** Get all indexed repos. */
+    getAllRepos(): IndexedRepo[];
+    /** Upsert an indexed star. Evicts oldest entry if at capacity. */
+    putStar(star: IndexedStar): void;
+    /** Remove a star. */
+    removeStar(starrerDid: string, repoDid: string, repoRecordId: string): void;
+    /** Get star count for a repo. */
+    getStarCount(repoDid: string, repoRecordId: string): number;
+    /** Get all stars for a repo. */
+    getStarsForRepo(repoDid: string, repoRecordId: string): IndexedStar[];
+    /** Get all repos starred by a user. */
+    getStarredByUser(did: string): IndexedStar[];
+    /** Upsert an indexed follow. Evicts oldest entry if at capacity. */
+    putFollow(follow: IndexedFollow): void;
+    /** Remove a follow. */
+    removeFollow(followerDid: string, targetDid: string): void;
+    /** Get follower count for a user. */
+    getFollowerCount(did: string): number;
+    /** Get following count for a user. */
+    getFollowingCount(did: string): number;
+    /** Get repos with star counts, sorted by star count descending. */
+    getReposWithStars(): RepoWithStars[];
+    /**
+     * Trending repos — sorted by recent star activity.
+     *
+     * Trending is computed as the number of stars received within
+     * `windowMs` (default: 7 days), weighted by recency.
+     */
+    getTrending(limit?: number, windowMs?: number): RepoWithStars[];
+    /**
+     * Search repos by name, description, topics, or language.
+     *
+     * Returns results sorted by relevance score.  Scoring:
+     *   - Name exact match: 10
+     *   - Name prefix match: 5
+     *   - Name substring match: 3
+     *   - Topic match: 4
+     *   - Language match: 2
+     *   - Description substring match: 1
+     *   - Star count bonus: 0.1 per star (capped at 5)
+     */
+    search(query: string, limit?: number): SearchResult[];
+    /** Get user profile summary. */
+    getUserProfile(did: string): UserProfile;
+    /**
+     * List repos by language, sorted by star count.
+     */
+    getReposByLanguage(language: string): RepoWithStars[];
+    /**
+     * List repos by topic, sorted by star count.
+     */
+    getReposByTopic(topic: string): RepoWithStars[];
+    /** Get store statistics. */
+    getStats(): {
+        dids: number;
+        repos: number;
+        stars: number;
+        follows: number;
+    };
+    /** Clear all data. */
+    clear(): void;
+}
+//# sourceMappingURL=store.d.ts.map

package/dist/types/indexer/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../../src/indexer/store.ts"],"names":[],"mappings":"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"}