@quatrain/code 1.1.1

package/dist/AbstractRepositoryAdapter.d.ts

@@ -0,0 +1,10 @@
+export interface CommitFile {
+    path: string;
+    content: string;
+}
+export declare abstract class AbstractRepositoryAdapter {
+    abstract pull(branch?: string): Promise<void>;
+    abstract push(files: CommitFile[], message: string, branch?: string): Promise<void>;
+    abstract createBranch(branchName: string, fromBranch?: string): Promise<void>;
+}
+//# sourceMappingURL=AbstractRepositoryAdapter.d.ts.map

package/dist/AbstractRepositoryAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractRepositoryAdapter.d.ts","sourceRoot":"","sources":["../src/AbstractRepositoryAdapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,UAAU;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;CACjB;AAED,8BAAsB,yBAAyB;IAK5C,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ7C,QAAQ,CAAC,IAAI,CAAC,KAAK,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOnF,QAAQ,CAAC,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAC/E"}

package/dist/AbstractRepositoryAdapter.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AbstractRepositoryAdapter = void 0;
+class AbstractRepositoryAdapter {
+}
+exports.AbstractRepositoryAdapter = AbstractRepositoryAdapter;
+//# sourceMappingURL=AbstractRepositoryAdapter.js.map

package/dist/AbstractRepositoryAdapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AbstractRepositoryAdapter.js","sourceRoot":"","sources":["../src/AbstractRepositoryAdapter.ts"],"names":[],"mappings":";;;AAKA,MAAsB,yBAAyB;CAqB9C;AArBD,8DAqBC"}

package/dist/CodeRepository.d.ts

@@ -0,0 +1,7 @@
+import { AbstractRepositoryAdapter } from './AbstractRepositoryAdapter';
+export declare class CodeRepository {
+    protected static _adapter: AbstractRepositoryAdapter | null;
+    static setAdapter(adapter: AbstractRepositoryAdapter): void;
+    static getAdapter(): AbstractRepositoryAdapter;
+}
+//# sourceMappingURL=CodeRepository.d.ts.map

package/dist/CodeRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeRepository.d.ts","sourceRoot":"","sources":["../src/CodeRepository.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAA;AAKvE,qBAAa,cAAc;IACxB,SAAS,CAAC,MAAM,CAAC,QAAQ,EAAE,yBAAyB,GAAG,IAAI,CAAO;WAMpD,UAAU,CAAC,OAAO,EAAE,yBAAyB;WAS7C,UAAU,IAAI,yBAAyB;CAMvD"}

package/dist/CodeRepository.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeRepository = void 0;
+class CodeRepository {
+    static _adapter = null;
+    static setAdapter(adapter) {
+        CodeRepository._adapter = adapter;
+    }
+    static getAdapter() {
+        if (!CodeRepository._adapter) {
+            throw new Error('No Repository adapter configured. Please call CodeRepository.setAdapter() first.');
+        }
+        return CodeRepository._adapter;
+    }
+}
+exports.CodeRepository = CodeRepository;
+//# sourceMappingURL=CodeRepository.js.map

package/dist/CodeRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CodeRepository.js","sourceRoot":"","sources":["../src/CodeRepository.ts"],"names":[],"mappings":";;;AAKA,MAAa,cAAc;IACd,MAAM,CAAC,QAAQ,GAAqC,IAAI,CAAA;IAM3D,MAAM,CAAC,UAAU,CAAC,OAAkC;QACxD,cAAc,CAAC,QAAQ,GAAG,OAAO,CAAA;IACpC,CAAC;IAOM,MAAM,CAAC,UAAU;QACrB,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE,CAAC;YAC5B,MAAM,IAAI,KAAK,CAAC,kFAAkF,CAAC,CAAA;QACtG,CAAC;QACD,OAAO,cAAc,CAAC,QAAQ,CAAA;IACjC,CAAC;;AArBJ,wCAsBC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+import { AbstractRepositoryAdapter, CommitFile } from './AbstractRepositoryAdapter';
+import { CodeRepository } from './CodeRepository';
+export { AbstractRepositoryAdapter, CodeRepository };
+export type { CommitFile };
+//# 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,yBAAyB,EAAE,UAAU,EAAE,MAAM,6BAA6B,CAAA;AACnF,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAEjD,OAAO,EAAE,yBAAyB,EAAE,cAAc,EAAE,CAAA;AACpD,YAAY,EAAE,UAAU,EAAE,CAAA"}

package/dist/index.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CodeRepository = exports.AbstractRepositoryAdapter = void 0;
+const AbstractRepositoryAdapter_1 = require("./AbstractRepositoryAdapter");
+Object.defineProperty(exports, "AbstractRepositoryAdapter", { enumerable: true, get: function () { return AbstractRepositoryAdapter_1.AbstractRepositoryAdapter; } });
+const CodeRepository_1 = require("./CodeRepository");
+Object.defineProperty(exports, "CodeRepository", { enumerable: true, get: function () { return CodeRepository_1.CodeRepository; } });
+//# 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,2EAAmF;AAG1E,0GAHA,qDAAyB,OAGA;AAFlC,qDAAiD;AAEb,+FAF3B,+BAAc,OAE2B"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@quatrain/code",
+  "version": "1.1.1",
+  "license": "AGPL-3.0-only",
+  "description": "Remote code repository adapters commons",
+  "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"
+  },
+  "author": "Quatrain Développement SAS <developers@quatrain.com>",
+  "dependencies": {
+    "@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/AbstractRepositoryAdapter.ts

@@ -0,0 +1,27 @@
+export interface CommitFile {
+   path: string
+   content: string
+}
+
+export abstract class AbstractRepositoryAdapter {
+   /**
+    * Pull latest changes from remote repository
+    * @param branch 
+    */
+   abstract pull(branch?: string): Promise<void>
+
+   /**
+    * Commit and push files to remote repository
+    * @param files List of files to commit
+    * @param message Commit message
+    * @param branch Target branch
+    */
+   abstract push(files: CommitFile[], message: string, branch?: string): Promise<void>
+
+   /**
+    * Create a new branch
+    * @param branchName 
+    * @param fromBranch 
+    */
+   abstract createBranch(branchName: string, fromBranch?: string): Promise<void>
+}

package/src/CodeRepository.ts

@@ -0,0 +1,28 @@
+import { AbstractRepositoryAdapter } from './AbstractRepositoryAdapter'
+
+/**
+ * Singleton to access the configured Repository adapter
+ */
+export class CodeRepository {
+   protected static _adapter: AbstractRepositoryAdapter | null = null
+
+   /**
+    * Set the Repository adapter to be used globally
+    * @param adapter The configured adapter instance
+    */
+   public static setAdapter(adapter: AbstractRepositoryAdapter) {
+      CodeRepository._adapter = adapter
+   }
+
+   /**
+    * Get the current Repository adapter
+    * @returns The configured Repository adapter
+    * @throws Error if no adapter has been set
+    */
+   public static getAdapter(): AbstractRepositoryAdapter {
+      if (!CodeRepository._adapter) {
+         throw new Error('No Repository adapter configured. Please call CodeRepository.setAdapter() first.')
+      }
+      return CodeRepository._adapter
+   }
+}

package/src/__test__/CodeRepository.test.ts

@@ -0,0 +1,22 @@
+import { AbstractRepositoryAdapter, CommitFile } from '../AbstractRepositoryAdapter'
+import { CodeRepository } from '../CodeRepository'
+
+class MockRepoAdapter extends AbstractRepositoryAdapter {
+   async pull() {}
+   async push(files: CommitFile[], message: string) {}
+   async createBranch(branchName: string) {}
+}
+
+describe('CodeRepository Singleton', () => {
+   it('should throw an error if no adapter is set', () => {
+      // @ts-ignore : private property access for test reset
+      CodeRepository._adapter = null
+      expect(() => CodeRepository.getAdapter()).toThrow()
+   })
+
+   it('should set and get the adapter successfully', () => {
+      const adapter = new MockRepoAdapter()
+      CodeRepository.setAdapter(adapter)
+      expect(CodeRepository.getAdapter()).toBe(adapter)
+   })
+})

package/src/index.ts

@@ -0,0 +1,5 @@
+import { AbstractRepositoryAdapter, CommitFile } from './AbstractRepositoryAdapter'
+import { CodeRepository } from './CodeRepository'
+
+export { AbstractRepositoryAdapter, CodeRepository }
+export type { CommitFile }