@enbox/gitd 0.0.1

package/dist/types/refs.d.ts

@@ -0,0 +1,114 @@
+/**
+ * Forge Git Refs Protocol — mirrors git branch/tag refs as DWN records.
+ *
+ * This protocol provides a DWN-native view of git ref pointers (branches, tags)
+ * so that other DWN participants can subscribe to ref changes via
+ * `RecordsSubscribe`. The actual git object data stays in git — these records
+ * only track the ref name → commit SHA mapping.
+ *
+ * Uses `$ref` to compose with the Repo protocol for role-based authorization:
+ * only maintainers can update refs in the repo owner's DWN.
+ *
+ * @module
+ */
+/** Data shape for a git ref record (branch or tag pointer). */
+export type GitRefData = {
+    /** Full ref name, e.g. `refs/heads/main` or `refs/tags/v1.0.0`. */
+    name: string;
+    /** The commit SHA-1 (or SHA-256) this ref points to. */
+    target: string;
+    /** Ref type discriminator. */
+    type: 'branch' | 'tag';
+    /** For annotated tags, the tagger/committer info. */
+    tagger?: string;
+    /** For annotated tags, the tag message. */
+    message?: string;
+};
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ForgeRefsSchemaMap = {
+    ref: GitRefData;
+};
+export declare const ForgeRefsDefinition: {
+    readonly protocol: "https://enbox.org/protocols/forge/refs";
+    readonly published: true;
+    readonly uses: {
+        readonly repo: "https://enbox.org/protocols/forge/repo";
+    };
+    readonly types: {
+        readonly ref: {
+            readonly schema: "https://enbox.org/schemas/forge/git-ref";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly repo: {
+            readonly $ref: "repo:repo";
+            readonly ref: {
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "repo:repo/maintainer";
+                    readonly can: ["create", "update", "delete"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["name", "type"];
+                    readonly $allowUndefinedTags: false;
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: ["branch", "tag"];
+                    };
+                    readonly target: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+    };
+};
+/** Typed Forge Refs protocol for use with `web5.using()`. */
+export declare const ForgeRefsProtocol: import("@enbox/api").TypedProtocol<{
+    readonly protocol: "https://enbox.org/protocols/forge/refs";
+    readonly published: true;
+    readonly uses: {
+        readonly repo: "https://enbox.org/protocols/forge/repo";
+    };
+    readonly types: {
+        readonly ref: {
+            readonly schema: "https://enbox.org/schemas/forge/git-ref";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly repo: {
+            readonly $ref: "repo:repo";
+            readonly ref: {
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "repo:repo/maintainer";
+                    readonly can: ["create", "update", "delete"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["name", "type"];
+                    readonly $allowUndefinedTags: false;
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: ["branch", "tag"];
+                    };
+                    readonly target: {
+                        readonly type: "string";
+                    };
+                };
+            };
+        };
+    };
+}, ForgeRefsSchemaMap>;
+//# sourceMappingURL=refs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"refs.d.ts","sourceRoot":"","sources":["../../src/refs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAUH,+DAA+D;AAC/D,MAAM,MAAM,UAAU,GAAG;IACvB,mEAAmE;IACnE,IAAI,EAAE,MAAM,CAAC;IAEb,wDAAwD;IACxD,MAAM,EAAE,MAAM,CAAC;IAEf,8BAA8B;IAC9B,IAAI,EAAE,QAAQ,GAAG,KAAK,CAAC;IAEvB,qDAAqD;IACrD,MAAM,CAAC,EAAE,MAAM,CAAC;IAEhB,2CAA2C;IAC3C,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,kBAAkB,GAAG;IAC/B,GAAG,EAAE,UAAU,CAAC;CACjB,CAAC;AAMF,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8BO,CAAC;AAMxC,6DAA6D;AAC7D,eAAO,MAAM,iBAAiB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;sBAG7B,CAAC"}

package/dist/types/registry.d.ts

@@ -0,0 +1,212 @@
+/**
+ * Forge Package Registry Protocol — DID-scoped package publishing.
+ *
+ * Packages are scoped to the publisher's DID (no global namespace squatting).
+ * Versions and tarballs are `$immutable` — once published, content cannot be
+ * silently replaced. Third-party attestations enable build reproducibility chains.
+ *
+ * @module
+ */
+/** Data shape for a package record. */
+export type PackageData = {
+    name: string;
+    description?: string;
+    keywords?: string[];
+    repository?: string;
+};
+/** Data shape for a package version record. */
+export type PackageVersionData = {
+    semver: string;
+    engines?: Record<string, string>;
+    dependencies?: Record<string, string>;
+};
+/** Data shape for a third-party attestation. */
+export type AttestationData = {
+    attestorDid: string;
+    claim: string;
+    sourceCommit?: string;
+    sourceRepo?: string;
+};
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ForgeRegistrySchemaMap = {
+    package: PackageData;
+    version: PackageVersionData;
+    tarball: Uint8Array;
+    attestation: AttestationData;
+};
+export declare const ForgeRegistryDefinition: {
+    readonly protocol: "https://enbox.org/protocols/forge/registry";
+    readonly published: true;
+    readonly types: {
+        readonly package: {
+            readonly schema: "https://enbox.org/schemas/forge/package";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly version: {
+            readonly schema: "https://enbox.org/schemas/forge/package-version";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly tarball: {
+            readonly dataFormats: ["application/gzip", "application/octet-stream"];
+        };
+        readonly attestation: {
+            readonly schema: "https://enbox.org/schemas/forge/attestation";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly package: {
+            readonly $actions: [{
+                readonly who: "anyone";
+                readonly can: ["read"];
+            }];
+            readonly $tags: {
+                readonly $requiredTags: ["name", "ecosystem"];
+                readonly $allowUndefinedTags: false;
+                readonly name: {
+                    readonly type: "string";
+                    readonly maxLength: 214;
+                };
+                readonly ecosystem: {
+                    readonly type: "string";
+                    readonly enum: ["npm", "cargo", "pip", "go", "oci"];
+                };
+                readonly description: {
+                    readonly type: "string";
+                };
+            };
+            readonly version: {
+                readonly $immutable: true;
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly who: "author";
+                    readonly of: "package";
+                    readonly can: ["create"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["semver"];
+                    readonly $allowUndefinedTags: false;
+                    readonly semver: {
+                        readonly type: "string";
+                    };
+                    readonly deprecated: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly tarball: {
+                    readonly $immutable: true;
+                    readonly $recordLimit: {
+                        readonly max: 1;
+                        readonly strategy: "reject";
+                    };
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly who: "author";
+                        readonly of: "package";
+                        readonly can: ["create"];
+                    }];
+                };
+                readonly attestation: {
+                    readonly $immutable: true;
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }];
+                };
+            };
+        };
+    };
+};
+/** Typed Forge Registry protocol for use with `dwn.using()`. */
+export declare const ForgeRegistryProtocol: import("@enbox/api").TypedProtocol<{
+    readonly protocol: "https://enbox.org/protocols/forge/registry";
+    readonly published: true;
+    readonly types: {
+        readonly package: {
+            readonly schema: "https://enbox.org/schemas/forge/package";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly version: {
+            readonly schema: "https://enbox.org/schemas/forge/package-version";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly tarball: {
+            readonly dataFormats: ["application/gzip", "application/octet-stream"];
+        };
+        readonly attestation: {
+            readonly schema: "https://enbox.org/schemas/forge/attestation";
+            readonly dataFormats: ["application/json"];
+        };
+    };
+    readonly structure: {
+        readonly package: {
+            readonly $actions: [{
+                readonly who: "anyone";
+                readonly can: ["read"];
+            }];
+            readonly $tags: {
+                readonly $requiredTags: ["name", "ecosystem"];
+                readonly $allowUndefinedTags: false;
+                readonly name: {
+                    readonly type: "string";
+                    readonly maxLength: 214;
+                };
+                readonly ecosystem: {
+                    readonly type: "string";
+                    readonly enum: ["npm", "cargo", "pip", "go", "oci"];
+                };
+                readonly description: {
+                    readonly type: "string";
+                };
+            };
+            readonly version: {
+                readonly $immutable: true;
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly who: "author";
+                    readonly of: "package";
+                    readonly can: ["create"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["semver"];
+                    readonly $allowUndefinedTags: false;
+                    readonly semver: {
+                        readonly type: "string";
+                    };
+                    readonly deprecated: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly tarball: {
+                    readonly $immutable: true;
+                    readonly $recordLimit: {
+                        readonly max: 1;
+                        readonly strategy: "reject";
+                    };
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly who: "author";
+                        readonly of: "package";
+                        readonly can: ["create"];
+                    }];
+                };
+                readonly attestation: {
+                    readonly $immutable: true;
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }];
+                };
+            };
+        };
+    };
+}, ForgeRegistrySchemaMap>;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAUH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAG,MAAM,CAAC;IACd,WAAW,CAAC,EAAG,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAG,MAAM,EAAE,CAAC;IACrB,UAAU,CAAC,EAAG,MAAM,CAAC;CACtB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,kBAAkB,GAAG;IAC/B,MAAM,EAAG,MAAM,CAAC;IAChB,OAAO,CAAC,EAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACvC,CAAC;AAEF,gDAAgD;AAChD,MAAM,MAAM,eAAe,GAAG;IAC5B,WAAW,EAAG,MAAM,CAAC;IACrB,KAAK,EAAG,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAG,MAAM,CAAC;CACtB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAG,WAAW,CAAC;IACtB,OAAO,EAAG,kBAAkB,CAAC;IAC7B,OAAO,EAAG,UAAU,CAAC;IACrB,WAAW,EAAG,eAAe,CAAC;CAC/B,CAAC;AAMF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgEG,CAAC;AAMxC,gEAAgE;AAChE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGjC,CAAC"}

package/dist/types/releases.d.ts

@@ -0,0 +1,204 @@
+/**
+ * Forge Releases Protocol — release management with immutable assets.
+ *
+ * Release assets use `$immutable` to guarantee supply chain integrity:
+ * once a binary is published, its data cannot be silently replaced.
+ *
+ * @module
+ */
+/** Data shape for a release record. */
+export type ReleaseData = {
+    name: string;
+    body?: string;
+};
+/** Data shape for a release asset metadata. */
+export type AssetData = {
+    filename: string;
+    contentType: string;
+    size: number;
+};
+/** Data shape for a release signature. */
+export type SignatureData = {
+    algorithm: string;
+    publicKey?: string;
+};
+/** Maps protocol type names to their TypeScript data shapes. */
+export type ForgeReleasesSchemaMap = {
+    release: ReleaseData;
+    asset: Uint8Array;
+    signature: SignatureData;
+};
+export declare const ForgeReleasesDefinition: {
+    readonly protocol: "https://enbox.org/protocols/forge/releases";
+    readonly published: true;
+    readonly uses: {
+        readonly repo: "https://enbox.org/protocols/forge/repo";
+    };
+    readonly types: {
+        readonly release: {
+            readonly schema: "https://enbox.org/schemas/forge/release";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly asset: {
+            readonly dataFormats: ["application/octet-stream", "application/gzip", "application/zip", "application/x-tar"];
+        };
+        readonly signature: {
+            readonly dataFormats: ["application/pgp-signature", "application/json"];
+        };
+    };
+    readonly structure: {
+        readonly repo: {
+            readonly $ref: "repo:repo";
+            readonly release: {
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "repo:repo/maintainer";
+                    readonly can: ["create", "update", "delete"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["tagName"];
+                    readonly $allowUndefinedTags: false;
+                    readonly tagName: {
+                        readonly type: "string";
+                    };
+                    readonly commitSha: {
+                        readonly type: "string";
+                    };
+                    readonly prerelease: {
+                        readonly type: "boolean";
+                    };
+                    readonly draft: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly asset: {
+                    readonly $immutable: true;
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly role: "repo:repo/maintainer";
+                        readonly can: ["create", "delete"];
+                    }];
+                    readonly $tags: {
+                        readonly $requiredTags: ["filename", "contentType"];
+                        readonly $allowUndefinedTags: false;
+                        readonly filename: {
+                            readonly type: "string";
+                        };
+                        readonly contentType: {
+                            readonly type: "string";
+                        };
+                        readonly size: {
+                            readonly type: "integer";
+                        };
+                    };
+                };
+                readonly signature: {
+                    readonly $immutable: true;
+                    readonly $recordLimit: {
+                        readonly max: 1;
+                        readonly strategy: "reject";
+                    };
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly role: "repo:repo/maintainer";
+                        readonly can: ["create"];
+                    }];
+                };
+            };
+        };
+    };
+};
+/** Typed Forge Releases protocol for use with `dwn.using()`. */
+export declare const ForgeReleasesProtocol: import("@enbox/api").TypedProtocol<{
+    readonly protocol: "https://enbox.org/protocols/forge/releases";
+    readonly published: true;
+    readonly uses: {
+        readonly repo: "https://enbox.org/protocols/forge/repo";
+    };
+    readonly types: {
+        readonly release: {
+            readonly schema: "https://enbox.org/schemas/forge/release";
+            readonly dataFormats: ["application/json"];
+        };
+        readonly asset: {
+            readonly dataFormats: ["application/octet-stream", "application/gzip", "application/zip", "application/x-tar"];
+        };
+        readonly signature: {
+            readonly dataFormats: ["application/pgp-signature", "application/json"];
+        };
+    };
+    readonly structure: {
+        readonly repo: {
+            readonly $ref: "repo:repo";
+            readonly release: {
+                readonly $actions: [{
+                    readonly who: "anyone";
+                    readonly can: ["read"];
+                }, {
+                    readonly role: "repo:repo/maintainer";
+                    readonly can: ["create", "update", "delete"];
+                }];
+                readonly $tags: {
+                    readonly $requiredTags: ["tagName"];
+                    readonly $allowUndefinedTags: false;
+                    readonly tagName: {
+                        readonly type: "string";
+                    };
+                    readonly commitSha: {
+                        readonly type: "string";
+                    };
+                    readonly prerelease: {
+                        readonly type: "boolean";
+                    };
+                    readonly draft: {
+                        readonly type: "boolean";
+                    };
+                };
+                readonly asset: {
+                    readonly $immutable: true;
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly role: "repo:repo/maintainer";
+                        readonly can: ["create", "delete"];
+                    }];
+                    readonly $tags: {
+                        readonly $requiredTags: ["filename", "contentType"];
+                        readonly $allowUndefinedTags: false;
+                        readonly filename: {
+                            readonly type: "string";
+                        };
+                        readonly contentType: {
+                            readonly type: "string";
+                        };
+                        readonly size: {
+                            readonly type: "integer";
+                        };
+                    };
+                };
+                readonly signature: {
+                    readonly $immutable: true;
+                    readonly $recordLimit: {
+                        readonly max: 1;
+                        readonly strategy: "reject";
+                    };
+                    readonly $actions: [{
+                        readonly who: "anyone";
+                        readonly can: ["read"];
+                    }, {
+                        readonly role: "repo:repo/maintainer";
+                        readonly can: ["create"];
+                    }];
+                };
+            };
+        };
+    };
+}, ForgeReleasesSchemaMap>;
+//# sourceMappingURL=releases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"releases.d.ts","sourceRoot":"","sources":["../../src/releases.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAUH,uCAAuC;AACvC,MAAM,MAAM,WAAW,GAAG;IACxB,IAAI,EAAG,MAAM,CAAC;IACd,IAAI,CAAC,EAAG,MAAM,CAAC;CAChB,CAAC;AAEF,+CAA+C;AAC/C,MAAM,MAAM,SAAS,GAAG;IACtB,QAAQ,EAAG,MAAM,CAAC;IAClB,WAAW,EAAG,MAAM,CAAC;IACrB,IAAI,EAAG,MAAM,CAAC;CACf,CAAC;AAEF,0CAA0C;AAC1C,MAAM,MAAM,aAAa,GAAG;IAC1B,SAAS,EAAG,MAAM,CAAC;IACnB,SAAS,CAAC,EAAG,MAAM,CAAC;CACrB,CAAC;AAMF,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG;IACnC,OAAO,EAAG,WAAW,CAAC;IACtB,KAAK,EAAG,UAAU,CAAC;IACnB,SAAS,EAAG,aAAa,CAAC;CAC3B,CAAC;AAMF,eAAO,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA8DG,CAAC;AAMxC,gEAAgE;AAChE,eAAO,MAAM,qBAAqB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;0BAGjC,CAAC"}