@quatrain/code-github 1.1.1

package/dist/GithubAdapter.d.ts

@@ -0,0 +1,12 @@
+import { AbstractRepositoryAdapter, CommitFile } from '@quatrain/code';
+import { Octokit } from '@octokit/rest';
+export declare class GithubAdapter extends AbstractRepositoryAdapter {
+    protected _octokit: Octokit;
+    protected _owner: string;
+    protected _repo: string;
+    constructor(auth: string, owner: string, repo: string);
+    pull(branch?: string): Promise<void>;
+    push(files: CommitFile[], message: string, branch?: string): Promise<void>;
+    createBranch(branchName: string, fromBranch?: string): Promise<void>;
+}
+//# sourceMappingURL=GithubAdapter.d.ts.map

package/dist/GithubAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GithubAdapter.d.ts","sourceRoot":"","sources":["../src/GithubAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAA;AACtE,OAAO,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAEvC,qBAAa,aAAc,SAAQ,yBAAyB;IACzD,SAAS,CAAC,QAAQ,EAAE,OAAO,CAAA;IAC3B,SAAS,CAAC,MAAM,EAAE,MAAM,CAAA;IACxB,SAAS,CAAC,KAAK,EAAE,MAAM,CAAA;gBAEX,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM;IAO/C,IAAI,CAAC,MAAM,GAAE,MAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IAS5C,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAE,MAAe,GAAG,OAAO,CAAC,IAAI,CAAC;IA8DlF,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,GAAE,MAAe,GAAG,OAAO,CAAC,IAAI,CAAC;CAcpF"}

package/dist/GithubAdapter.js

@@ -0,0 +1,84 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubAdapter = void 0;
+const code_1 = require("@quatrain/code");
+const rest_1 = require("@octokit/rest");
+class GithubAdapter extends code_1.AbstractRepositoryAdapter {
+    _octokit;
+    _owner;
+    _repo;
+    constructor(auth, owner, repo) {
+        super();
+        this._octokit = new rest_1.Octokit({ auth });
+        this._owner = owner;
+        this._repo = repo;
+    }
+    async pull(branch = 'main') {
+        await this._octokit.repos.get({
+            owner: this._owner,
+            repo: this._repo,
+        });
+    }
+    async push(files, message, branch = 'main') {
+        const { data: refData } = await this._octokit.git.getRef({
+            owner: this._owner,
+            repo: this._repo,
+            ref: `heads/${branch}`,
+        });
+        const commitSha = refData.object.sha;
+        const { data: commitData } = await this._octokit.git.getCommit({
+            owner: this._owner,
+            repo: this._repo,
+            commit_sha: commitSha,
+        });
+        const baseTreeSha = commitData.tree.sha;
+        const tree = await Promise.all(files.map(async (file) => {
+            const { data: blobData } = await this._octokit.git.createBlob({
+                owner: this._owner,
+                repo: this._repo,
+                content: file.content,
+                encoding: 'utf-8',
+            });
+            return {
+                path: file.path,
+                mode: '100644',
+                type: 'blob',
+                sha: blobData.sha,
+            };
+        }));
+        const { data: treeData } = await this._octokit.git.createTree({
+            owner: this._owner,
+            repo: this._repo,
+            tree,
+            base_tree: baseTreeSha,
+        });
+        const { data: newCommitData } = await this._octokit.git.createCommit({
+            owner: this._owner,
+            repo: this._repo,
+            message,
+            tree: treeData.sha,
+            parents: [commitSha],
+        });
+        await this._octokit.git.updateRef({
+            owner: this._owner,
+            repo: this._repo,
+            ref: `heads/${branch}`,
+            sha: newCommitData.sha,
+        });
+    }
+    async createBranch(branchName, fromBranch = 'main') {
+        const { data: refData } = await this._octokit.git.getRef({
+            owner: this._owner,
+            repo: this._repo,
+            ref: `heads/${fromBranch}`,
+        });
+        await this._octokit.git.createRef({
+            owner: this._owner,
+            repo: this._repo,
+            ref: `refs/heads/${branchName}`,
+            sha: refData.object.sha,
+        });
+    }
+}
+exports.GithubAdapter = GithubAdapter;
+//# sourceMappingURL=GithubAdapter.js.map

package/dist/GithubAdapter.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+export { GithubAdapter } from './GithubAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GithubAdapter = void 0;
+var GithubAdapter_1 = require("./GithubAdapter");
+Object.defineProperty(exports, "GithubAdapter", { enumerable: true, get: function () { return GithubAdapter_1.GithubAdapter; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,iDAA+C;AAAtC,8GAAA,aAAa,OAAA"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@quatrain/code-github",
+  "version": "1.1.1",
+  "license": "AGPL-3.0-only",
+  "description": "GitHub repository adapter",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bun": "src/index.ts",
+  "files": [
+    "LICENSE.md",
+    "src/",
+    "dist/",
+    "README.md",
+    "NOTICE.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Quatrain/Core.git",
+    "directory": "packages/code-github"
+  },
+  "author": "Quatrain Développement SAS <developers@quatrain.com>",
+  "dependencies": {
+    "@octokit/rest": "^20.0.2",
+    "@quatrain/code": "^1.1.1",
+    "@quatrain/core": "^1.1.52"
+  },
+  "devDependencies": {
+    "@tsconfig/recommended": "^1.0.1",
+    "@types/jest": "^29.5.12",
+    "@types/node": "^22.10.1",
+    "jest": "^29.7.0",
+    "jest-node-exports-resolver": "^1.1.6",
+    "jest-serial-runner": "^1.2.1",
+    "trace-unhandled": "^2.0.1",
+    "ts-jest": "^29.4.6",
+    "ts-node": "^10.9.1",
+    "typescript": "^5.1.5"
+  },
+  "scripts": {
+    "test-ci": "jest --runInBand",
+    "build": "tsc",
+    "wbuild": "tsc --watch",
+    "bump-to": "yarn version"
+  },
+  "typedoc": {
+    "entryPoint": "src/index.ts"
+  }
+}

package/src/GithubAdapter.ts

@@ -0,0 +1,101 @@
+import { AbstractRepositoryAdapter, CommitFile } from '@quatrain/code'
+import { Octokit } from '@octokit/rest'
+
+export class GithubAdapter extends AbstractRepositoryAdapter {
+   protected _octokit: Octokit
+   protected _owner: string
+   protected _repo: string
+
+   constructor(auth: string, owner: string, repo: string) {
+      super()
+      this._octokit = new Octokit({ auth })
+      this._owner = owner
+      this._repo = repo
+   }
+
+   async pull(branch: string = 'main'): Promise<void> {
+      // In a real implementation, this would fetch latest refs
+      // Since this adapter is primarily to push changes from Studio, pull might be a no-op or fetch ref.
+      await this._octokit.repos.get({
+         owner: this._owner,
+         repo: this._repo,
+      })
+   }
+
+   async push(files: CommitFile[], message: string, branch: string = 'main'): Promise<void> {
+      // 1. Get latest commit SHA for branch
+      const { data: refData } = await this._octokit.git.getRef({
+         owner: this._owner,
+         repo: this._repo,
+         ref: `heads/${branch}`,
+      })
+      const commitSha = refData.object.sha
+
+      // 2. Get commit tree
+      const { data: commitData } = await this._octokit.git.getCommit({
+         owner: this._owner,
+         repo: this._repo,
+         commit_sha: commitSha,
+      })
+      const baseTreeSha = commitData.tree.sha
+
+      // 3. Create blobs and tree array
+      const tree = await Promise.all(
+         files.map(async (file) => {
+            const { data: blobData } = await this._octokit.git.createBlob({
+               owner: this._owner,
+               repo: this._repo,
+               content: file.content,
+               encoding: 'utf-8',
+            })
+
+            return {
+               path: file.path,
+               mode: '100644' as const,
+               type: 'blob' as const,
+               sha: blobData.sha,
+            }
+         })
+      )
+
+      // 4. Create new tree
+      const { data: treeData } = await this._octokit.git.createTree({
+         owner: this._owner,
+         repo: this._repo,
+         tree,
+         base_tree: baseTreeSha,
+      })
+
+      // 5. Create new commit
+      const { data: newCommitData } = await this._octokit.git.createCommit({
+         owner: this._owner,
+         repo: this._repo,
+         message,
+         tree: treeData.sha,
+         parents: [commitSha],
+      })
+
+      // 6. Update ref
+      await this._octokit.git.updateRef({
+         owner: this._owner,
+         repo: this._repo,
+         ref: `heads/${branch}`,
+         sha: newCommitData.sha,
+      })
+   }
+
+   async createBranch(branchName: string, fromBranch: string = 'main'): Promise<void> {
+      const { data: refData } = await this._octokit.git.getRef({
+         owner: this._owner,
+         repo: this._repo,
+         ref: `heads/${fromBranch}`,
+      })
+
+      await this._octokit.git.createRef({
+         owner: this._owner,
+         repo: this._repo,
+         ref: `refs/heads/${branchName}`,
+         sha: refData.object.sha,
+      })
+   }
+}

package/src/__test__/GithubAdapter.test.ts

@@ -0,0 +1,38 @@
+import { GithubAdapter } from '../GithubAdapter'
+
+jest.mock('@octokit/rest', () => ({
+   Octokit: jest.fn().mockImplementation(() => ({
+      repos: {
+         get: jest.fn().mockResolvedValue({ data: {} })
+      },
+      git: {
+         getRef: jest.fn().mockResolvedValue({ data: { object: { sha: 'base-sha' } } }),
+         getCommit: jest.fn().mockResolvedValue({ data: { tree: { sha: 'tree-sha' } } }),
+         createBlob: jest.fn().mockResolvedValue({ data: { sha: 'blob-sha' } }),
+         createTree: jest.fn().mockResolvedValue({ data: { sha: 'new-tree-sha' } }),
+         createCommit: jest.fn().mockResolvedValue({ data: { sha: 'new-commit-sha' } }),
+         updateRef: jest.fn().mockResolvedValue({ data: {} }),
+         createRef: jest.fn().mockResolvedValue({ data: {} })
+      }
+   }))
+}))
+
+describe('GithubAdapter', () => {
+   let adapter: GithubAdapter
+
+   beforeEach(() => {
+      adapter = new GithubAdapter('fake-token', 'owner', 'repo')
+   })
+
+   it('should fetch repo on pull', async () => {
+      await expect(adapter.pull('main')).resolves.not.toThrow()
+   })
+
+   it('should push files', async () => {
+      await expect(adapter.push([{ path: 'test.txt', content: 'hello' }], 'commit msg')).resolves.not.toThrow()
+   })
+
+   it('should create branch', async () => {
+      await expect(adapter.createBranch('new-feature')).resolves.not.toThrow()
+   })
+})

package/src/index.ts

@@ -0,0 +1 @@
+export { GithubAdapter } from './GithubAdapter'