@enbox/gitd 0.0.1

package/dist/types/wiki.d.ts

@@ -0,0 +1,143 @@
+/**
+ * Forge Wiki Protocol — collaborative documentation with edit history.
+ *
+ * Wiki pages are mutable (updated in place). Each edit creates an `$immutable`
+ * `pageHistory` record capturing the diff, providing a permanent audit trail.
+ *
+ * Composes with the Forge Repo protocol via `uses` for role-based authorization.
+ *
+ * @module
+ */
+/** Data shape for a wiki page (body is markdown, stored as data payload). */
+export type PageData = {
+    slug: string;
+    title: string;
+};
+/** Data shape for a wiki page history entry. */
+export type PageHistoryData = {
+    editedBy: string;
+    summary?: string;
+    diff?: string;
+    previousCid?: string;
+};
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ForgeWikiSchemaMap = {
+    page: PageData;
+    pageHistory: PageHistoryData;
+};
+export declare const ForgeWikiDefinition: {
+    readonly protocol: "https://enbox.org/protocols/forge/wiki";
+    readonly published: true;
+    readonly uses: {
+        readonly repo: "https://enbox.org/protocols/forge/repo";
+    };
+    readonly types: {
+        readonly page: {
+            readonly schema: "https://enbox.org/schemas/forge/wiki-page";
+            readonly dataFormats: ["text/markdown"];
+        };
+        readonly pageHistory: {
+            readonly schema: "https://enbox.org/schemas/forge/wiki-history";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly repo: {
+            readonly $ref: "repo:repo";
+            readonly page: {
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "repo:repo/maintainer";
+                    readonly can: ["create", "update", "delete"];
+                }, {
+                    readonly role: "repo:repo/contributor";
+                    readonly can: ["create", "update"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["slug", "title"];
+                    readonly $allowUndefinedTags: false;
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                };
+                readonly pageHistory: {
+                    readonly $immutable: true;
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly role: "repo:repo/maintainer";
+                        readonly can: ["create"];
+                    }, {
+                        readonly role: "repo:repo/contributor";
+                        readonly can: ["create"];
+                    }];
+                };
+            };
+        };
+    };
+};
+/** Typed Forge Wiki protocol for use with `dwn.using()`. */
+export declare const ForgeWikiProtocol: import("@enbox/api").TypedProtocol<{
+    readonly protocol: "https://enbox.org/protocols/forge/wiki";
+    readonly published: true;
+    readonly uses: {
+        readonly repo: "https://enbox.org/protocols/forge/repo";
+    };
+    readonly types: {
+        readonly page: {
+            readonly schema: "https://enbox.org/schemas/forge/wiki-page";
+            readonly dataFormats: ["text/markdown"];
+        };
+        readonly pageHistory: {
+            readonly schema: "https://enbox.org/schemas/forge/wiki-history";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly repo: {
+            readonly $ref: "repo:repo";
+            readonly page: {
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "repo:repo/maintainer";
+                    readonly can: ["create", "update", "delete"];
+                }, {
+                    readonly role: "repo:repo/contributor";
+                    readonly can: ["create", "update"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["slug", "title"];
+                    readonly $allowUndefinedTags: false;
+                    readonly slug: {
+                        readonly type: "string";
+                    };
+                    readonly title: {
+                        readonly type: "string";
+                    };
+                };
+                readonly pageHistory: {
+                    readonly $immutable: true;
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly role: "repo:repo/maintainer";
+                        readonly can: ["create"];
+                    }, {
+                        readonly role: "repo:repo/contributor";
+                        readonly can: ["create"];
+                    }];
+                };
+            };
+        };
+    };
+}, ForgeWikiSchemaMap>;
+//# sourceMappingURL=wiki.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"wiki.d.ts","sourceRoot":"","sources":["../../src/wiki.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAUH,6EAA6E;AAC7E,MAAM,MAAM,QAAQ,GAAG;IACrB,IAAI,EAAG,MAAM,CAAC;IACd,KAAK,EAAG,MAAM,CAAC;CAChB,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAG,MAAM,CAAC;IAClB,OAAO,CAAC,EAAG,MAAM,CAAC;IAClB,IAAI,CAAC,EAAG,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAG,QAAQ,CAAC;IAChB,WAAW,EAAG,eAAe,CAAC;CAC/B,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CO,CAAC;AAMxC,4DAA4D;AAC5D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAG7B,CAAC"}

package/package.json

@@ -0,0 +1,108 @@
+{
+  "name": "@enbox/gitd",
+  "version": "0.0.1",
+  "description": "Decentralized forge (GitHub alternative) built on DWN protocols",
+  "type": "module",
+  "main": "./dist/esm/index.js",
+  "module": "./dist/esm/index.js",
+  "types": "./dist/types/index.d.ts",
+  "bin": {
+    "gitd": "./dist/esm/cli/main.js",
+    "git-remote-did": "./dist/esm/git-remote/main.js",
+    "git-remote-did-credential": "./dist/esm/git-remote/credential-main.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "clean": "rimraf dist",
+    "build:esm": "rimraf dist/esm dist/types && tsc -p tsconfig.json",
+    "build": "bun run clean && bun run build:esm",
+    "lint": "eslint . --max-warnings 0",
+    "lint:fix": "eslint . --fix",
+    "test:node": "bun test .spec.ts",
+    "changeset": "changeset",
+    "version": "changeset version && bun install",
+    "release": "bun run build && changeset publish"
+  },
+  "license": "Apache-2.0",
+  "files": [
+    "dist",
+    "schemas",
+    "src"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/types/index.d.ts",
+      "import": "./dist/esm/index.js"
+    },
+    "./git-server": {
+      "types": "./dist/types/git-server/index.d.ts",
+      "import": "./dist/esm/git-server/index.js"
+    },
+    "./git-remote": {
+      "types": "./dist/types/git-remote/index.d.ts",
+      "import": "./dist/esm/git-remote/index.js"
+    },
+    "./indexer": {
+      "types": "./dist/types/indexer/index.d.ts",
+      "import": "./dist/esm/indexer/index.js"
+    },
+    "./github-shim": {
+      "types": "./dist/types/github-shim/index.d.ts",
+      "import": "./dist/esm/github-shim/index.js"
+    },
+    "./resolver": {
+      "types": "./dist/types/resolver/index.d.ts",
+      "import": "./dist/esm/resolver/index.js"
+    },
+    "./shims": {
+      "types": "./dist/types/shims/index.d.ts",
+      "import": "./dist/esm/shims/index.js"
+    },
+    "./shims/npm": {
+      "types": "./dist/types/shims/npm/index.d.ts",
+      "import": "./dist/esm/shims/npm/index.js"
+    },
+    "./shims/go": {
+      "types": "./dist/types/shims/go/index.d.ts",
+      "import": "./dist/esm/shims/go/index.js"
+    },
+    "./shims/oci": {
+      "types": "./dist/types/shims/oci/index.d.ts",
+      "import": "./dist/esm/shims/oci/index.js"
+    },
+    "./daemon": {
+      "types": "./dist/types/daemon/index.d.ts",
+      "import": "./dist/esm/daemon/index.js"
+    }
+  },
+  "keywords": [
+    "decentralized",
+    "dwn",
+    "git",
+    "forge",
+    "protocols"
+  ],
+  "engines": {
+    "bun": ">=1.0.0"
+  },
+  "dependencies": {
+    "@enbox/api": "0.3.0",
+    "@enbox/crypto": "0.0.6",
+    "@enbox/dids": "0.0.7",
+    "@enbox/dwn-sdk-js": "0.1.0"
+  },
+  "devDependencies": {
+    "@changesets/changelog-github": "^0.5.2",
+    "@changesets/cli": "^2.29.8",
+    "@eslint/js": "9.7.0",
+    "@stylistic/eslint-plugin": "^5.9.0",
+    "@typescript-eslint/eslint-plugin": "8.32.1",
+    "@typescript-eslint/parser": "8.32.1",
+    "bun-types": "latest",
+    "eslint": "9.7.0",
+    "rimraf": "5.0.7",
+    "typescript": "5.5.4"
+  }
+}

package/schemas/ci/check-run.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/check-run",
+  "title": "CheckRunData",
+  "description": "An individual check run within a check suite",
+  "type": "object",
+  "properties": {
+    "summary": {
+      "type": "string"
+    },
+    "text": {
+      "type": "string"
+    },
+    "startedAt": {
+      "type": "string"
+    },
+    "completedAt": {
+      "type": "string"
+    }
+  },
+  "required": [],
+  "additionalProperties": false
+}

package/schemas/ci/check-suite.json

@@ -0,0 +1,23 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/check-suite",
+  "title": "CheckSuiteData",
+  "description": "A CI check suite associated with a branch",
+  "type": "object",
+  "properties": {
+    "headBranch": {
+      "type": "string"
+    },
+    "conclusion": {
+      "type": "string"
+    },
+    "startedAt": {
+      "type": "string"
+    },
+    "completedAt": {
+      "type": "string"
+    }
+  },
+  "required": ["headBranch"],
+  "additionalProperties": false
+}

package/schemas/issues/assignment.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/assignment",
+  "title": "AssignmentData",
+  "description": "An assignment of a user to an issue",
+  "type": "object",
+  "properties": {
+    "assigneeDid": {
+      "type": "string"
+    },
+    "alias": {
+      "type": "string"
+    }
+  },
+  "required": ["assigneeDid"],
+  "additionalProperties": false
+}

package/schemas/issues/comment.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/comment",
+  "title": "CommentData",
+  "description": "A comment on an issue",
+  "type": "object",
+  "properties": {
+    "body": {
+      "type": "string"
+    }
+  },
+  "required": ["body"],
+  "additionalProperties": false
+}

package/schemas/issues/issue.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/issue",
+  "title": "IssueData",
+  "description": "An issue in a forge repository",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "body": {
+      "type": "string"
+    },
+    "number": {
+      "type": "number"
+    }
+  },
+  "required": ["title", "body"],
+  "additionalProperties": false
+}

package/schemas/issues/label.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/label",
+  "title": "LabelData",
+  "description": "A label applied to an issue",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    },
+    "color": {
+      "type": "string"
+    }
+  },
+  "required": ["name", "color"],
+  "additionalProperties": false
+}

package/schemas/issues/reaction.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/reaction",
+  "title": "ReactionData",
+  "description": "An emoji reaction on an issue or comment",
+  "type": "object",
+  "properties": {
+    "emoji": {
+      "type": "string"
+    }
+  },
+  "required": ["emoji"],
+  "additionalProperties": false
+}

package/schemas/issues/status-change.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/status-change",
+  "title": "StatusChangeData",
+  "description": "A status change on an issue",
+  "type": "object",
+  "properties": {
+    "reason": {
+      "type": "string"
+    }
+  },
+  "required": [],
+  "additionalProperties": false
+}

package/schemas/notifications/notification.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/notification",
+  "title": "NotificationData",
+  "description": "A notification delivered to a user",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "body": {
+      "type": "string"
+    },
+    "url": {
+      "type": "string"
+    }
+  },
+  "required": ["title"],
+  "additionalProperties": false
+}

package/schemas/org/org-member.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/org-member",
+  "title": "OrgMemberData",
+  "description": "A member of an organization",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string"
+    },
+    "alias": {
+      "type": "string"
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/org/org.json

@@ -0,0 +1,26 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/org",
+  "title": "OrgData",
+  "description": "An organization that owns repositories and has members",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    },
+    "displayName": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    },
+    "avatar": {
+      "type": "string"
+    },
+    "website": {
+      "type": "string"
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/org/team-member.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/team-member",
+  "title": "TeamMemberData",
+  "description": "A member of a team within an organization",
+  "type": "object",
+  "properties": {
+    "did": {
+      "type": "string"
+    },
+    "alias": {
+      "type": "string"
+    }
+  },
+  "required": ["did"],
+  "additionalProperties": false
+}

package/schemas/org/team.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/team",
+  "title": "TeamData",
+  "description": "A team within an organization",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string"
+    },
+    "description": {
+      "type": "string"
+    }
+  },
+  "required": ["name"],
+  "additionalProperties": false
+}

package/schemas/patches/merge-result.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/merge-result",
+  "title": "MergeResultData",
+  "description": "The result of merging a patch, recording who performed the merge.",
+  "type": "object",
+  "properties": {
+    "mergedBy": {
+      "type": "string"
+    }
+  },
+  "required": ["mergedBy"],
+  "additionalProperties": false
+}

package/schemas/patches/patch-status-change.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/patch-status-change",
+  "title": "PatchStatusChangeData",
+  "description": "A patch status change event with an optional reason.",
+  "type": "object",
+  "properties": {
+    "reason": {
+      "type": "string"
+    }
+  },
+  "required": [],
+  "additionalProperties": false
+}

package/schemas/patches/patch.json

@@ -0,0 +1,20 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/patch",
+  "title": "PatchData",
+  "description": "A forge patch proposal containing a title, body, and optional sequence number.",
+  "type": "object",
+  "properties": {
+    "title": {
+      "type": "string"
+    },
+    "body": {
+      "type": "string"
+    },
+    "number": {
+      "type": "number"
+    }
+  },
+  "required": ["title", "body"],
+  "additionalProperties": false
+}

package/schemas/patches/review-comment.json

@@ -0,0 +1,17 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/review-comment",
+  "title": "ReviewCommentData",
+  "description": "A comment on a patch review with a required body and optional diff hunk context.",
+  "type": "object",
+  "properties": {
+    "body": {
+      "type": "string"
+    },
+    "diffHunk": {
+      "type": "string"
+    }
+  },
+  "required": ["body"],
+  "additionalProperties": false
+}

package/schemas/patches/review.json

@@ -0,0 +1,14 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/review",
+  "title": "ReviewData",
+  "description": "A patch review with an optional body.",
+  "type": "object",
+  "properties": {
+    "body": {
+      "type": "string"
+    }
+  },
+  "required": [],
+  "additionalProperties": false
+}

package/schemas/patches/revision.json

@@ -0,0 +1,30 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/revision",
+  "title": "RevisionData",
+  "description": "A patch revision containing an optional description and diff statistics.",
+  "type": "object",
+  "properties": {
+    "description": {
+      "type": "string"
+    },
+    "diffStat": {
+      "type": "object",
+      "properties": {
+        "additions": {
+          "type": "number"
+        },
+        "deletions": {
+          "type": "number"
+        },
+        "filesChanged": {
+          "type": "number"
+        }
+      },
+      "required": ["additions", "deletions", "filesChanged"],
+      "additionalProperties": false
+    }
+  },
+  "required": ["diffStat"],
+  "additionalProperties": false
+}

package/schemas/refs/git-ref.json

@@ -0,0 +1,32 @@
+{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "$id": "https://enbox.org/schemas/forge/git-ref",
+  "title": "GitRefData",
+  "description": "A git ref pointer (branch or tag) mirrored as a DWN record for subscription-based notifications.",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Full ref name, e.g. refs/heads/main or refs/tags/v1.0.0"
+    },
+    "target": {
+      "type": "string",
+      "description": "The commit SHA this ref points to"
+    },
+    "type": {
+      "type": "string",
+      "enum": ["branch", "tag"],
+      "description": "Ref type discriminator"
+    },
+    "tagger": {
+      "type": "string",
+      "description": "For annotated tags, the tagger identity"
+    },
+    "message": {
+      "type": "string",
+      "description": "For annotated tags, the tag message"
+    }
+  },
+  "required": ["name", "target", "type"],
+  "additionalProperties": false
+}