@oh-my-ghaad/gitlab 0.0.1

package/LICENSE

@@ -0,0 +1,7 @@
+Copyright 2025 Chris Griffing
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -0,0 +1,105 @@
+# @oh-my-ghaad/adapter-github
+
+GitHub adapter for Oh My GHAAD, providing GitHub-specific implementation for using GitHub repositories as JSON databases.
+
+## Overview
+
+The GitHub adapter implements the core adapter interface to provide:
+- GitHub repository access
+- File operations (create, read, update, delete)
+- OAuth integration
+- Repository installation handling
+
+## Installation
+
+```bash
+npm install @oh-my-ghaad/adapter-github @oh-my-ghaad/core
+# or
+yarn add @oh-my-ghaad/adapter-github @oh-my-ghaad/core
+# or
+pnpm add @oh-my-ghaad/adapter-github @oh-my-ghaad/core
+```
+
+## Basic Usage
+
+```typescript
+import { Engine } from '@oh-my-ghaad/core';
+import { GithubAdapter } from '@oh-my-ghaad/adapter-github';
+
+// Create the engine instance with the GitHub adapter
+const engine = new Engine({
+  adapters: [
+    new GithubAdapter({
+      clientId: "YOUR_GITHUB_CLIENT_ID",
+      redirectUri: process.env.YOUR_GITHUB_REDIRECT_URI!,
+      accessManagementUrl:
+        "https://github.com/apps/[YOUR_GITHUB_APP_NAME]/installations/new",
+    }),
+  ],
+  collections: [/* your collections */],
+  appConfig: {
+    persisted: true
+  }
+});
+```
+
+## Configuration
+
+The GitHub adapter requires the following configuration:
+
+- `clientId`: The client ID of your GitHub app
+- `redirectUri`: The redirect URI of your GitHub app
+- `accessManagementUrl`: The URL to the access management page of your GitHub app
+
+## OAUTH
+
+You will need to set up an OAuth app on GitHub. You will also need to set up a backend server to handle the OAuth flow since GitHub does not allow the implicit flow for OAuth apps.
+
+See GitHub's [OAuth App documentation](https://docs.github.com/en/apps/oauth-apps/building-oauth-apps/creating-an-oauth-app) for more details.
+
+### Example Server Setup
+
+```typescript
+export async function POST(request: Request) {
+  const { code } = await request.json();
+
+  if (!code) {
+    return new Response("Missing code", { status: 400 });
+  }
+
+  const response = await fetch("https://github.com/login/oauth/access_token", {
+    method: "POST",
+    headers: {
+      Accept: "application/json",
+      "Content-Type": "application/json",
+    },
+    body: JSON.stringify({
+      client_id: process.env.NEXT_PUBLIC_GITHUB_CLIENT_ID!,
+      client_secret: process.env.GITHUB_CLIENT_SECRET!,
+      code: code,
+      redirect_uri: process.env.NEXT_PUBLIC_GITHUB_REDIRECT_URI!,
+    }),
+  });
+
+  if (!response.ok) {
+    return new Response("Failed to fetch token", { status: 500 });
+  }
+
+  const responseJson = await response.json();
+
+  if (!responseJson.access_token) {
+    return new Response("Failed to fetch token", { status: 500 });
+  }
+
+  return new Response(JSON.stringify(responseJson));
+}
+
+```
+
+
+## Related Packages
+
+- [@oh-my-ghaad/core](../core/README.md) - Core functionality
+- [@oh-my-ghaad/react](../react/README.md) - React integration
+
+For more examples and detailed usage, see the [main README](../../README.md) and the [demo app](../../apps/demo-app/README.md).

package/dist/index.cjs

@@ -0,0 +1,320 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/index.ts
+var index_exports = {};
+__export(index_exports, {
+  GitlabAdapter: () => GitlabAdapter
+});
+module.exports = __toCommonJS(index_exports);
+
+// src/adapter.ts
+var import_core = require("@oh-my-ghaad/core");
+var import_rest = require("@gitbeaker/rest");
+
+// src/utils.ts
+function base64ToUtf8(base64String) {
+  try {
+    const byteCharacters = atob(base64String);
+    const byteNumbers = new Array(byteCharacters.length);
+    for (let i = 0; i < byteCharacters.length; i++) {
+      byteNumbers[i] = byteCharacters.charCodeAt(i);
+    }
+    const byteArray = new Uint8Array(byteNumbers);
+    const decoder = new TextDecoder("utf-8");
+    return decoder.decode(byteArray);
+  } catch (e) {
+    console.error("Error decoding base64 with TextDecoder:", e);
+    return null;
+  }
+}
+function utf8ToBase64(utf8String) {
+  try {
+    const encoder = new TextEncoder();
+    const byteArray = encoder.encode(utf8String);
+    return btoa(String.fromCharCode(...byteArray));
+  } catch (e) {
+    console.error("Error encoding string as base64:", e);
+    return null;
+  }
+}
+
+// src/adapter.ts
+var GitlabAdapter = class extends import_core.Adapter {
+  name = "GitLab";
+  icon = "https://about.gitlab.com/images/ico/favicon-192x192.png";
+  primaryColor = "#FC6D26";
+  secondaryColor = "#000000";
+  oauthUrl = "https://gitlab.com/oauth/authorize";
+  baseUrl = "https://gitlab.com";
+  api;
+  constructor(props) {
+    super(props);
+    this.api = new import_rest.Gitlab({
+      host: this.baseUrl,
+      oauthToken: this.token
+    });
+  }
+  setToken(token) {
+    super.setToken(token);
+    this.api = new import_rest.Gitlab({
+      host: this.baseUrl,
+      oauthToken: this.token
+    });
+  }
+  async fetchRepositories() {
+    const repositoriesOrError = await this.api.Projects.all({
+      membership: true,
+      perPage: 100
+    }).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (repositoriesOrError instanceof Error) {
+      if (repositoriesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch projects");
+    }
+    const repositories = repositoriesOrError.map((repository) => ({
+      id: repository.id,
+      org: repository.namespace.path,
+      name: repository.path,
+      url: repository.web_url
+    }));
+    return repositories.flat();
+  }
+  async fetchFile(path) {
+    const fileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      "HEAD"
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (fileOrError instanceof Error) {
+      if (fileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch file");
+    }
+    if (!fileOrError.content) {
+      throw new Error("Failed to fetch file");
+    }
+    const content = base64ToUtf8(fileOrError.content);
+    if (!content) {
+      console.error("Failed to decode file");
+    }
+    return content || "";
+  }
+  async fetchDirectory(directoryPath) {
+    const filesOrError = await this.api.Repositories.allRepositoryTrees(
+      this.repo,
+      {
+        path: directoryPath
+      }
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (filesOrError instanceof Error) {
+      if (filesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch directory");
+    }
+    if (!Array.isArray(filesOrError)) {
+      throw new Error("Path is not a directory");
+    }
+    return Promise.all(
+      filesOrError.filter((file) => file.path.endsWith(".json")).map((file) => {
+        return this.fetchFile(file.path);
+      })
+    );
+  }
+  async createFile(path, content, message) {
+    const branchesOrError = await this.api.Branches.all(this.repo).catch(
+      (error) => {
+        console.error(error);
+        return error;
+      }
+    );
+    if (branchesOrError instanceof Error) {
+      if (branchesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch default branch");
+    }
+    const branch = branchesOrError.find((branch2) => branch2.default);
+    if (!branch) {
+      throw new Error("Failed to find default branch");
+    }
+    const existingFileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      branch.name
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (existingFileOrError instanceof Error) {
+      if (existingFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch existing file");
+    }
+    if (existingFileOrError) {
+      throw new Error("File already exists");
+    }
+    const createdFileOrError = await this.api.Commits.create(
+      this.repo,
+      branch.name,
+      message || `Create file: ${path}`,
+      [
+        {
+          action: "create",
+          filePath: path,
+          content: utf8ToBase64(content),
+          encoding: "base64"
+        }
+      ]
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (createdFileOrError instanceof Error) {
+      if (createdFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to create file");
+    }
+    return;
+  }
+  async updateFile(path, content, message) {
+    const branchesOrError = await this.api.Branches.all(this.repo).catch(
+      (error) => {
+        console.error(error);
+        return error;
+      }
+    );
+    if (branchesOrError instanceof Error) {
+      if (branchesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch default branch");
+    }
+    const branch = branchesOrError.find((branch2) => branch2.default);
+    if (!branch) {
+      throw new Error("Failed to find default branch");
+    }
+    const existingFileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      branch.name
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (existingFileOrError instanceof Error) {
+      if (existingFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch existing file");
+    }
+    if (!existingFileOrError) {
+      throw new Error("File does not exist");
+    }
+    const createdFileOrError = await this.api.Commits.create(
+      this.repo,
+      branch.name,
+      message || `Create file: ${path}`,
+      [
+        {
+          action: "update",
+          filePath: path,
+          content: utf8ToBase64(content),
+          encoding: "base64"
+        }
+      ]
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (createdFileOrError instanceof Error) {
+      if (createdFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to create file");
+    }
+    return;
+  }
+  async deleteFile(path, message) {
+    const responseOrError = await this.api.RepositoryFiles.remove(
+      this.repo,
+      path,
+      "HEAD",
+      message || `Delete file: ${path}`
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (responseOrError instanceof Error) {
+      if (responseOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to delete file");
+    }
+    return;
+  }
+  // TODO: Why did I add this method?
+  async createCommit({}) {
+    return;
+  }
+  // -----------------------------------------------------------------------------
+  // TODO: Pull Requests and File History are not yet implemented or used in the demo app yet
+  // -----------------------------------------------------------------------------
+  async fetchFileHistory(path) {
+    return [];
+  }
+  async fetchPullRequests() {
+    return [];
+  }
+  async createPullRequest() {
+    return;
+  }
+  async fetchPullRequest() {
+    return {
+      id: "",
+      title: "",
+      description: "",
+      commitSha: "",
+      createdAt: ""
+    };
+  }
+  async updatePullRequest() {
+    return;
+  }
+  async deletePullRequest() {
+    return;
+  }
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  GitlabAdapter
+});

package/dist/index.d.cts

@@ -0,0 +1,39 @@
+import { Adapter, IAdapter, CommitRequest } from '@oh-my-ghaad/core';
+
+declare class GitlabAdapter extends Adapter implements IAdapter {
+    readonly name = "GitLab";
+    readonly icon = "https://about.gitlab.com/images/ico/favicon-192x192.png";
+    readonly primaryColor = "#FC6D26";
+    readonly secondaryColor = "#000000";
+    readonly oauthUrl = "https://gitlab.com/oauth/authorize";
+    readonly baseUrl = "https://gitlab.com";
+    private api;
+    constructor(props: any);
+    setToken(token: string | null): void;
+    fetchRepositories(): Promise<{
+        id: number;
+        org: string;
+        name: string;
+        url: string;
+    }[]>;
+    fetchFile(path: string): Promise<string>;
+    fetchDirectory(directoryPath: string): Promise<string[]>;
+    createFile(path: string, content: string, message?: string): Promise<void>;
+    updateFile(path: string, content: string, message?: string): Promise<void>;
+    deleteFile(path: string, message?: string): Promise<void>;
+    createCommit({}: CommitRequest): Promise<void>;
+    fetchFileHistory(path: string): Promise<any[]>;
+    fetchPullRequests(): Promise<any[]>;
+    createPullRequest(): Promise<void>;
+    fetchPullRequest(): Promise<{
+        id: string;
+        title: string;
+        description: string;
+        commitSha: string;
+        createdAt: string;
+    }>;
+    updatePullRequest(): Promise<void>;
+    deletePullRequest(): Promise<void>;
+}
+
+export { GitlabAdapter };

package/dist/index.d.ts

@@ -0,0 +1,39 @@
+import { Adapter, IAdapter, CommitRequest } from '@oh-my-ghaad/core';
+
+declare class GitlabAdapter extends Adapter implements IAdapter {
+    readonly name = "GitLab";
+    readonly icon = "https://about.gitlab.com/images/ico/favicon-192x192.png";
+    readonly primaryColor = "#FC6D26";
+    readonly secondaryColor = "#000000";
+    readonly oauthUrl = "https://gitlab.com/oauth/authorize";
+    readonly baseUrl = "https://gitlab.com";
+    private api;
+    constructor(props: any);
+    setToken(token: string | null): void;
+    fetchRepositories(): Promise<{
+        id: number;
+        org: string;
+        name: string;
+        url: string;
+    }[]>;
+    fetchFile(path: string): Promise<string>;
+    fetchDirectory(directoryPath: string): Promise<string[]>;
+    createFile(path: string, content: string, message?: string): Promise<void>;
+    updateFile(path: string, content: string, message?: string): Promise<void>;
+    deleteFile(path: string, message?: string): Promise<void>;
+    createCommit({}: CommitRequest): Promise<void>;
+    fetchFileHistory(path: string): Promise<any[]>;
+    fetchPullRequests(): Promise<any[]>;
+    createPullRequest(): Promise<void>;
+    fetchPullRequest(): Promise<{
+        id: string;
+        title: string;
+        description: string;
+        commitSha: string;
+        createdAt: string;
+    }>;
+    updatePullRequest(): Promise<void>;
+    deletePullRequest(): Promise<void>;
+}
+
+export { GitlabAdapter };

package/dist/index.js

@@ -0,0 +1,294 @@
+// src/adapter.ts
+import { Adapter } from "@oh-my-ghaad/core";
+import { Gitlab } from "@gitbeaker/rest";
+
+// src/utils.ts
+function base64ToUtf8(base64String) {
+  try {
+    const byteCharacters = atob(base64String);
+    const byteNumbers = new Array(byteCharacters.length);
+    for (let i = 0; i < byteCharacters.length; i++) {
+      byteNumbers[i] = byteCharacters.charCodeAt(i);
+    }
+    const byteArray = new Uint8Array(byteNumbers);
+    const decoder = new TextDecoder("utf-8");
+    return decoder.decode(byteArray);
+  } catch (e) {
+    console.error("Error decoding base64 with TextDecoder:", e);
+    return null;
+  }
+}
+function utf8ToBase64(utf8String) {
+  try {
+    const encoder = new TextEncoder();
+    const byteArray = encoder.encode(utf8String);
+    return btoa(String.fromCharCode(...byteArray));
+  } catch (e) {
+    console.error("Error encoding string as base64:", e);
+    return null;
+  }
+}
+
+// src/adapter.ts
+var GitlabAdapter = class extends Adapter {
+  name = "GitLab";
+  icon = "https://about.gitlab.com/images/ico/favicon-192x192.png";
+  primaryColor = "#FC6D26";
+  secondaryColor = "#000000";
+  oauthUrl = "https://gitlab.com/oauth/authorize";
+  baseUrl = "https://gitlab.com";
+  api;
+  constructor(props) {
+    super(props);
+    this.api = new Gitlab({
+      host: this.baseUrl,
+      oauthToken: this.token
+    });
+  }
+  setToken(token) {
+    super.setToken(token);
+    this.api = new Gitlab({
+      host: this.baseUrl,
+      oauthToken: this.token
+    });
+  }
+  async fetchRepositories() {
+    const repositoriesOrError = await this.api.Projects.all({
+      membership: true,
+      perPage: 100
+    }).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (repositoriesOrError instanceof Error) {
+      if (repositoriesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch projects");
+    }
+    const repositories = repositoriesOrError.map((repository) => ({
+      id: repository.id,
+      org: repository.namespace.path,
+      name: repository.path,
+      url: repository.web_url
+    }));
+    return repositories.flat();
+  }
+  async fetchFile(path) {
+    const fileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      "HEAD"
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (fileOrError instanceof Error) {
+      if (fileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch file");
+    }
+    if (!fileOrError.content) {
+      throw new Error("Failed to fetch file");
+    }
+    const content = base64ToUtf8(fileOrError.content);
+    if (!content) {
+      console.error("Failed to decode file");
+    }
+    return content || "";
+  }
+  async fetchDirectory(directoryPath) {
+    const filesOrError = await this.api.Repositories.allRepositoryTrees(
+      this.repo,
+      {
+        path: directoryPath
+      }
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (filesOrError instanceof Error) {
+      if (filesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch directory");
+    }
+    if (!Array.isArray(filesOrError)) {
+      throw new Error("Path is not a directory");
+    }
+    return Promise.all(
+      filesOrError.filter((file) => file.path.endsWith(".json")).map((file) => {
+        return this.fetchFile(file.path);
+      })
+    );
+  }
+  async createFile(path, content, message) {
+    const branchesOrError = await this.api.Branches.all(this.repo).catch(
+      (error) => {
+        console.error(error);
+        return error;
+      }
+    );
+    if (branchesOrError instanceof Error) {
+      if (branchesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch default branch");
+    }
+    const branch = branchesOrError.find((branch2) => branch2.default);
+    if (!branch) {
+      throw new Error("Failed to find default branch");
+    }
+    const existingFileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      branch.name
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (existingFileOrError instanceof Error) {
+      if (existingFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch existing file");
+    }
+    if (existingFileOrError) {
+      throw new Error("File already exists");
+    }
+    const createdFileOrError = await this.api.Commits.create(
+      this.repo,
+      branch.name,
+      message || `Create file: ${path}`,
+      [
+        {
+          action: "create",
+          filePath: path,
+          content: utf8ToBase64(content),
+          encoding: "base64"
+        }
+      ]
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (createdFileOrError instanceof Error) {
+      if (createdFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to create file");
+    }
+    return;
+  }
+  async updateFile(path, content, message) {
+    const branchesOrError = await this.api.Branches.all(this.repo).catch(
+      (error) => {
+        console.error(error);
+        return error;
+      }
+    );
+    if (branchesOrError instanceof Error) {
+      if (branchesOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch default branch");
+    }
+    const branch = branchesOrError.find((branch2) => branch2.default);
+    if (!branch) {
+      throw new Error("Failed to find default branch");
+    }
+    const existingFileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      branch.name
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (existingFileOrError instanceof Error) {
+      if (existingFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch existing file");
+    }
+    if (!existingFileOrError) {
+      throw new Error("File does not exist");
+    }
+    const createdFileOrError = await this.api.Commits.create(
+      this.repo,
+      branch.name,
+      message || `Create file: ${path}`,
+      [
+        {
+          action: "update",
+          filePath: path,
+          content: utf8ToBase64(content),
+          encoding: "base64"
+        }
+      ]
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (createdFileOrError instanceof Error) {
+      if (createdFileOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to create file");
+    }
+    return;
+  }
+  async deleteFile(path, message) {
+    const responseOrError = await this.api.RepositoryFiles.remove(
+      this.repo,
+      path,
+      "HEAD",
+      message || `Delete file: ${path}`
+    ).catch((error) => {
+      console.error(error);
+      return error;
+    });
+    if (responseOrError instanceof Error) {
+      if (responseOrError.cause.response.status === 401 && this.unauthorizedHandler) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to delete file");
+    }
+    return;
+  }
+  // TODO: Why did I add this method?
+  async createCommit({}) {
+    return;
+  }
+  // -----------------------------------------------------------------------------
+  // TODO: Pull Requests and File History are not yet implemented or used in the demo app yet
+  // -----------------------------------------------------------------------------
+  async fetchFileHistory(path) {
+    return [];
+  }
+  async fetchPullRequests() {
+    return [];
+  }
+  async createPullRequest() {
+    return;
+  }
+  async fetchPullRequest() {
+    return {
+      id: "",
+      title: "",
+      description: "",
+      commitSha: "",
+      createdAt: ""
+    };
+  }
+  async updatePullRequest() {
+    return;
+  }
+  async deletePullRequest() {
+    return;
+  }
+};
+export {
+  GitlabAdapter
+};

package/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "@oh-my-ghaad/gitlab",
+  "version": "0.0.1",
+  "description": "",
+  "main": "dist/index.js",
+  "type": "module",
+  "types": "dist/index.d.ts",
+  "keywords": [],
+  "author": "",
+  "license": "MIT",
+  "dependencies": {
+    "@gitbeaker/rest": "^43.5.0",
+    "@oh-my-ghaad/core": "0.0.1"
+  },
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.8.3"
+  },
+  "scripts": {
+    "dev": "tsup src/index.ts --watch --dts --dts-resolve --format esm,cjs",
+    "build": "tsup src/index.ts --dts --dts-resolve --format esm,cjs",
+    "prepublish": "pnpm run build",
+    "test": "echo \"Error: no test specified\" && exit 1"
+  }
+}

package/src/adapter.ts

@@ -0,0 +1,346 @@
+import { Adapter } from "@oh-my-ghaad/core";
+import type { CommitRequest, IAdapter } from "@oh-my-ghaad/core";
+import { GitbeakerRequestError, Gitlab } from "@gitbeaker/rest";
+import { base64ToUtf8, utf8ToBase64 } from "./utils";
+// import { base64ToUtf8, utf8ToBase64 } from "./utils";
+
+// type EndpointPath = keyof Endpoints;
+
+export class GitlabAdapter extends Adapter implements IAdapter {
+  readonly name = "GitLab";
+  readonly icon = "https://about.gitlab.com/images/ico/favicon-192x192.png";
+  readonly primaryColor = "#FC6D26";
+  readonly secondaryColor = "#000000";
+  readonly oauthUrl = "https://gitlab.com/oauth/authorize";
+  readonly baseUrl = "https://gitlab.com";
+
+  private api: InstanceType<typeof Gitlab>;
+
+  constructor(props) {
+    super(props);
+
+    this.api = new Gitlab({
+      host: this.baseUrl,
+      oauthToken: this.token,
+    });
+  }
+
+  setToken(token: string | null) {
+    super.setToken(token);
+
+    this.api = new Gitlab({
+      host: this.baseUrl,
+      oauthToken: this.token,
+    });
+  }
+
+  async fetchRepositories() {
+    const repositoriesOrError = await this.api.Projects.all({
+      membership: true,
+      perPage: 100,
+    }).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (repositoriesOrError instanceof Error) {
+      if (
+        repositoriesOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch projects");
+    }
+
+    const repositories = repositoriesOrError.map((repository) => ({
+      id: repository.id,
+      org: repository.namespace.path,
+      name: repository.path,
+      url: repository.web_url as string,
+    }));
+
+    return repositories.flat();
+  }
+
+  async fetchFile(path: string) {
+    const fileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      "HEAD"
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (fileOrError instanceof Error) {
+      if (
+        fileOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch file");
+    }
+
+    if (!fileOrError.content) {
+      throw new Error("Failed to fetch file");
+    }
+    const content = base64ToUtf8(fileOrError.content);
+    if (!content) {
+      console.error("Failed to decode file");
+    }
+
+    return content || "";
+  }
+
+  async fetchDirectory(directoryPath: string) {
+    const filesOrError = await this.api.Repositories.allRepositoryTrees(
+      this.repo,
+      {
+        path: directoryPath,
+      }
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (filesOrError instanceof Error) {
+      if (
+        filesOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch directory");
+    }
+
+    if (!Array.isArray(filesOrError)) {
+      throw new Error("Path is not a directory");
+    }
+
+    return Promise.all(
+      filesOrError
+        .filter((file) => file.path.endsWith(".json"))
+        .map((file) => {
+          return this.fetchFile(file.path);
+        })
+    );
+  }
+
+  async createFile(path: string, content: string, message?: string) {
+    const branchesOrError = await this.api.Branches.all(this.repo).catch(
+      (error: GitbeakerRequestError) => {
+        console.error(error);
+        return error;
+      }
+    );
+
+    if (branchesOrError instanceof Error) {
+      if (
+        branchesOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch default branch");
+    }
+
+    const branch = branchesOrError.find((branch) => branch.default);
+
+    if (!branch) {
+      throw new Error("Failed to find default branch");
+    }
+
+    const existingFileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      branch.name
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (existingFileOrError instanceof Error) {
+      if (
+        existingFileOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch existing file");
+    }
+
+    if (existingFileOrError) {
+      throw new Error("File already exists");
+    }
+
+    const createdFileOrError = await this.api.Commits.create(
+      this.repo,
+      branch.name,
+      message || `Create file: ${path}`,
+      [
+        {
+          action: "create",
+          filePath: path,
+          content: utf8ToBase64(content),
+          encoding: "base64",
+        },
+      ]
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (createdFileOrError instanceof Error) {
+      if (
+        createdFileOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to create file");
+    }
+
+    return;
+  }
+
+  async updateFile(path: string, content: string, message?: string) {
+    const branchesOrError = await this.api.Branches.all(this.repo).catch(
+      (error: GitbeakerRequestError) => {
+        console.error(error);
+        return error;
+      }
+    );
+
+    if (branchesOrError instanceof Error) {
+      if (
+        branchesOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch default branch");
+    }
+
+    const branch = branchesOrError.find((branch) => branch.default);
+
+    if (!branch) {
+      throw new Error("Failed to find default branch");
+    }
+
+    const existingFileOrError = await this.api.RepositoryFiles.show(
+      this.repo,
+      path,
+      branch.name
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (existingFileOrError instanceof Error) {
+      if (
+        existingFileOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to fetch existing file");
+    }
+
+    if (!existingFileOrError) {
+      throw new Error("File does not exist");
+    }
+
+    const createdFileOrError = await this.api.Commits.create(
+      this.repo,
+      branch.name,
+      message || `Create file: ${path}`,
+      [
+        {
+          action: "update",
+          filePath: path,
+          content: utf8ToBase64(content),
+          encoding: "base64",
+        },
+      ]
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (createdFileOrError instanceof Error) {
+      if (
+        createdFileOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to create file");
+    }
+
+    return;
+  }
+
+  async deleteFile(path: string, message?: string) {
+    const responseOrError = await this.api.RepositoryFiles.remove(
+      this.repo,
+      path,
+      "HEAD",
+      message || `Delete file: ${path}`
+    ).catch((error: GitbeakerRequestError) => {
+      console.error(error);
+      return error;
+    });
+
+    if (responseOrError instanceof Error) {
+      if (
+        responseOrError.cause.response.status === 401 &&
+        this.unauthorizedHandler
+      ) {
+        this.unauthorizedHandler();
+      }
+      throw new Error("Failed to delete file");
+    }
+
+    return;
+  }
+
+  // TODO: Why did I add this method?
+  async createCommit({}: CommitRequest) {
+    return;
+  }
+
+  // -----------------------------------------------------------------------------
+  // TODO: Pull Requests and File History are not yet implemented or used in the demo app yet
+  // -----------------------------------------------------------------------------
+  async fetchFileHistory(path: string) {
+    return [];
+  }
+
+  async fetchPullRequests() {
+    return [];
+  }
+
+  async createPullRequest() {
+    return;
+  }
+
+  async fetchPullRequest() {
+    return {
+      id: "",
+      title: "",
+      description: "",
+      commitSha: "",
+      createdAt: "",
+    };
+  }
+
+  async updatePullRequest() {
+    return;
+  }
+
+  async deletePullRequest() {
+    return;
+  }
+}

package/src/index.ts

@@ -0,0 +1 @@
+export * from "./adapter";

package/src/utils.ts

@@ -0,0 +1,32 @@
+export function base64ToUtf8(base64String: string): string | null {
+  try {
+    // Decode base64 to a byte array (Uint8Array)
+    const byteCharacters = atob(base64String);
+    const byteNumbers = new Array(byteCharacters.length);
+    for (let i = 0; i < byteCharacters.length; i++) {
+      byteNumbers[i] = byteCharacters.charCodeAt(i);
+    }
+    const byteArray = new Uint8Array(byteNumbers);
+
+    // Decode the byte array as UTF-8
+    const decoder = new TextDecoder("utf-8");
+    return decoder.decode(byteArray);
+  } catch (e) {
+    console.error("Error decoding base64 with TextDecoder:", e);
+    return null;
+  }
+}
+
+export function utf8ToBase64(utf8String: string): string | null {
+  try {
+    // Encode the string as UTF-8
+    const encoder = new TextEncoder();
+    const byteArray = encoder.encode(utf8String);
+
+    // Convert the byte array to base64 and return it
+    return btoa(String.fromCharCode(...byteArray));
+  } catch (e) {
+    console.error("Error encoding string as base64:", e);
+    return null;
+  }
+}

package/tsconfig.json

@@ -0,0 +1,7 @@
+{
+  "compilerOptions": {
+    "target": "ESNext",
+    "module": "ESNext",
+    "moduleResolution": "node",
+  }
+}