teamx-projects 1.0.0 → 1.1.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 TeamX
+
+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/index.js

@@ -1,197 +1,3 @@
+const { createProjectsClient } = require("./src/projectsClient");
 
-/**
- * TeamX Projects
- * Node 18+ (built-in fetch)
- *
- * Commands:
- *   list
- *   status <projectId>
- *   artifacts <projectId>
- *   deploy <projectId> --env production|staging|dev --by email
- *   create --name <projectName> --path <folderPath> --lang ts|js
- *
- * Optional env:
- *   BASE_URL=https://teamx-discord-services.fly.dev
- *   TEAMX_API_KEY=... (Bearer token, optional)
- */
-
-const fs = require("node:fs");
-const path = require("node:path");
-const yazl = require("yazl");
-
-const BASEFIX = "https://teamx-discord-services.fly.dev"
-const BASE_URL = BASEFIX.replace(/\/$/, "");
-const API_KEY = process.env.TEAMX_API_KEY || "";
-
-function usage(exitCode = 1) {
-  console.log(`
-TeamX Projects API Client (CJS)
-
-Commands:
-  list
-  status <projectId>
-  artifacts <projectId>
-  deploy <projectId> [--env production|staging|dev] [--by email]
-  create --name <projectName> --path <folderPath> [--lang ts|js]
-
-`);
-  process.exit(exitCode);
-}
-
-function argValue(flag, def = "") {
-  const i = process.argv.indexOf(flag);
-  if (i === -1) return def;
-  return process.argv[i + 1] ?? def;
-}
-
-async function fetchJson(p, opts = {}) {
-  const url = `${BASE_URL}${p}`;
-
-  const headers = { "content-type": "application/json", ...(opts.headers || {}) };
-  if (API_KEY) headers.Authorization = `Bearer ${API_KEY}`;
-
-  const res = await fetch(url, { ...opts, headers });
-
-  const text = await res.text();
-  let data;
-  try {
-    data = text ? JSON.parse(text) : null;
-  } catch {
-    data = { raw: text };
-  }
-
-  if (!res.ok) {
-    const msg = (data && data.error) || res.statusText || "Request failed";
-    const err = new Error(`${res.status} ${msg}`);
-    err.status = res.status;
-    err.data = data;
-    throw err;
-  }
-
-  return data;
-}
-
-function print(obj) {
-  console.log(JSON.stringify(obj, null, 2));
-}
-
-/**
- * Zip a directory into an in-memory Buffer (no temp files).
- */
-function zipDirToBuffer(dir) {
-  return new Promise((resolve, reject) => {
-    const zipfile = new yazl.ZipFile();
-    const chunks = [];
-    const out = zipfile.outputStream;
-
-    out.on("data", (c) => chunks.push(c));
-    out.on("error", reject);
-    out.on("end", () => resolve(Buffer.concat(chunks)));
-
-    function walk(folder, prefix = "") {
-      const entries = fs.readdirSync(folder, { withFileTypes: true });
-      for (const e of entries) {
-        const full = path.join(folder, e.name);
-        const rel = path.join(prefix, e.name);
-
-        // Skip common junk
-        if (e.name === "node_modules" || e.name === ".git") continue;
-
-        if (e.isDirectory()) walk(full, rel);
-        else zipfile.addFile(full, rel);
-      }
-    }
-
-    walk(dir);
-    zipfile.end();
-  });
-}
-
-async function main() {
-  const [, , cmd, ...rest] = process.argv;
-  if (!cmd) usage(1);
-
-  if (cmd === "list") {
-    const projects = await fetchJson("/api/projects");
-    print(projects);
-    return;
-  }
-
-  if (cmd === "status") {
-    const id = rest[0];
-    if (!id) usage(1);
-    const status = await fetchJson(`/api/projects/${encodeURIComponent(id)}/status`);
-    print(status);
-    return;
-  }
-
-  if (cmd === "artifacts") {
-    const id = rest[0];
-    if (!id) usage(1);
-    const artifacts = await fetchJson(`/api/projects/${encodeURIComponent(id)}/artifacts`);
-    print(artifacts);
-    return;
-  }
-
-  if (cmd === "deploy") {
-    const id = rest[0];
-    if (!id) usage(1);
-
-    const environment = argValue("--env", "production");
-    const initiated_by = argValue("--by", "");
-
-    const payload = { environment, initiated_by };
-    const deploy = await fetchJson(`/api/projects/${encodeURIComponent(id)}/deploy`, {
-      method: "POST",
-      body: JSON.stringify(payload),
-    });
-    print(deploy);
-    return;
-  }
-
-  if (cmd === "create") {
-    const name = argValue("--name");
-    const folderPath = argValue("--path");
-    const language = argValue("--lang", "ts");
-
-    if (!name || !folderPath) usage(1);
-
-    const abs = path.resolve(folderPath);
-    if (!fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) {
-      throw new Error(`Invalid --path folder: ${abs}`);
-    }
-
-    const zipBuf = await zipDirToBuffer(abs);
-    const source = zipBuf.toString("base64");
-
-    // If your backend expects different keys, change them here.
-    const payload = {
-      name,
-      template: "advanced-discord-bot",
-      language,
-      source, // base64 zip
-      meta: {
-        createdAt: new Date().toISOString(),
-      },
-    };
-
-    const created = await fetchJson("/api/projects", {
-      method: "POST",
-      body: JSON.stringify(payload),
-    });
-
-    print(created);
-    return;
-  }
-
-  usage(1);
-}
-
-main().catch((e) => {
-  console.error("Error:", e.message);
-  if (e.data) {
-    console.error("Details:");
-    console.error(JSON.stringify(e.data, null, 2));
-  }
-  process.exit(1);
-});
+module.exports = { createProjectsClient };

package/package.json

@@ -1,14 +1,26 @@
 {
   "name": "teamx-projects",
-  "version": "1.0.0",
+  "version": "1.1.2",
   "type": "commonjs",
-  "description": "Projects API Client for TeamX Discord Services",
+  "description": "Programmatic (non-CLI) client for TeamX Discord Services Projects API (CommonJS, Node 18+).",
+  "keywords": [
+    "teamx",
+    "projects",
+    "flyio",
+    "discord",
+    "api",
+    "client"
+  ],
+  "license": "MIT",
   "main": "index.js",
-  "bin": {
-    "teamx-projects": "index.js"
-  },
-  "scripts": {
-    "client": "node index.js"
+  "files": [
+    "index.js",
+    "src",
+    "README.md",
+    "LICENSE"
+  ],
+  "engines": {
+    "node": ">=18"
   },
   "dependencies": {
     "yazl": "^2.5.1"

package/src/http.js

@@ -0,0 +1,48 @@
+function normalizeBaseUrl(baseUrl) {
+  return String(baseUrl || "https://teamx-discord-services.fly.dev").replace(/\/$/, "");
+}
+
+/**
+ * @param {object} opts
+ * @param {string} opts.baseUrl
+ * @param {string=} opts.apiKey
+ */
+function createHttpClient({ baseUrl, apiKey }) {
+  const BASE_URL = normalizeBaseUrl(baseUrl);
+  const API_KEY = apiKey || "";
+
+  /**
+   * @param {string} p
+   * @param {RequestInit=} opts
+   */
+  async function fetchJson(p, opts = {}) {
+    const url = `${BASE_URL}${p}`;
+
+    const headers = { "content-type": "application/json", ...(opts.headers || {}) };
+    if (API_KEY) headers.Authorization = `Bearer ${API_KEY}`;
+
+    const res = await fetch(url, { ...opts, headers });
+
+    const text = await res.text();
+    let data;
+    try {
+      data = text ? JSON.parse(text) : null;
+    } catch {
+      data = { raw: text };
+    }
+
+    if (!res.ok) {
+      const msg = (data && data.error) || res.statusText || "Request failed";
+      const err = new Error(`${res.status} ${msg}`);
+      err.status = res.status;
+      err.data = data;
+      throw err;
+    }
+
+    return data;
+  }
+
+  return { fetchJson, BASE_URL };
+}
+
+module.exports = { createHttpClient };

package/src/projectsClient.js

@@ -0,0 +1,92 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const { createHttpClient } = require("./http");
+const { zipDirToBuffer } = require("./zip");
+
+/**
+ * @typedef {Object} CreateProjectsClientOptions
+ * @property {string=} baseUrl
+ * @property {string=} apiKey
+ */
+
+/**
+ * Create a programmatic client for TeamX Projects API.
+ * @param {CreateProjectsClientOptions=} opts
+ */
+function createProjectsClient(opts = {}) {
+  const http = createHttpClient({
+    baseUrl: opts.baseUrl || process.env.BASE_URL || "https://teamx-discord-services.fly.dev",
+    apiKey: opts.apiKey || process.env.TEAMX_API_KEY || "",
+  });
+
+  return {
+    baseUrl: http.BASE_URL,
+
+    /** GET /api/projects */
+    async listProjects() {
+      return http.fetchJson("/api/projects");
+    },
+
+    /** GET /api/projects/:id/status */
+    async getProjectStatus(projectId) {
+      if (!projectId) throw new Error("projectId is required");
+      return http.fetchJson(`/api/projects/${encodeURIComponent(projectId)}/status`);
+    },
+
+    /** GET /api/projects/:id/artifacts */
+    async getProjectArtifacts(projectId) {
+      if (!projectId) throw new Error("projectId is required");
+      return http.fetchJson(`/api/projects/${encodeURIComponent(projectId)}/artifacts`);
+    },
+
+    /** POST /api/projects/:id/deploy */
+    async deployProject(projectId, { environment = "production", initiated_by = "" } = {}) {
+      if (!projectId) throw new Error("projectId is required");
+      const payload = { environment, initiated_by };
+      return http.fetchJson(`/api/projects/${encodeURIComponent(projectId)}/deploy`, {
+        method: "POST",
+        body: JSON.stringify(payload),
+      });
+    },
+
+    /**
+     * POST /api/projects
+     * Zips a folder, base64 encodes it, and uploads as JSON payload.
+     *
+     * @param {Object} params
+     * @param {string} params.name
+     * @param {string} params.folderPath
+     * @param {"ts"|"js"=} params.language
+     * @param {string=} params.template
+     * @param {Object=} params.meta
+     */
+    async createProjectFromFolder({ name, folderPath, language = "ts", template = "advanced-discord-bot", meta = {} }) {
+      if (!name) throw new Error("name is required");
+      if (!folderPath) throw new Error("folderPath is required");
+
+      const abs = path.resolve(folderPath);
+      if (!fs.existsSync(abs) || !fs.statSync(abs).isDirectory()) {
+        throw new Error(`Invalid folderPath: ${abs}`);
+      }
+
+      const zipBuf = await zipDirToBuffer(abs);
+      const source = zipBuf.toString("base64");
+
+      // If your backend expects different keys, change them here.
+      const payload = {
+        name,
+        template,
+        language,
+        source, // base64 zip
+        meta: { createdAt: new Date().toISOString(), ...meta },
+      };
+
+      return http.fetchJson("/api/projects", {
+        method: "POST",
+        body: JSON.stringify(payload),
+      });
+    },
+  };
+}
+
+module.exports = { createProjectsClient };

package/src/zip.js

@@ -0,0 +1,40 @@
+const fs = require("node:fs");
+const path = require("node:path");
+const yazl = require("yazl");
+
+/**
+ * Zip a directory into an in-memory Buffer (no temp files).
+ * Skips node_modules and .git automatically.
+ * @param {string} dir
+ * @returns {Promise<Buffer>}
+ */
+function zipDirToBuffer(dir) {
+  return new Promise((resolve, reject) => {
+    const zipfile = new yazl.ZipFile();
+    const chunks = [];
+    const out = zipfile.outputStream;
+
+    out.on("data", (c) => chunks.push(c));
+    out.on("error", reject);
+    out.on("end", () => resolve(Buffer.concat(chunks)));
+
+    function walk(folder, prefix = "") {
+      const entries = fs.readdirSync(folder, { withFileTypes: true });
+      for (const e of entries) {
+        // Skip common junk folders early
+        if (e.name === "node_modules" || e.name === ".git") continue;
+
+        const full = path.join(folder, e.name);
+        const rel = path.join(prefix, e.name);
+
+        if (e.isDirectory()) walk(full, rel);
+        else zipfile.addFile(full, rel);
+      }
+    }
+
+    walk(dir);
+    zipfile.end();
+  });
+}
+
+module.exports = { zipDirToBuffer };

package/README.md

@@ -1,30 +0,0 @@
-# Projects API Client (CommonJS, .js)
-
-Node 18+ (uses built-in `fetch`).
-
-## Install
-
-```bash
-npm i
-```
-
-## Run
-
-```bash
-npx teamx-projects list
-```
-
-## Commands
-
-```bash
-list
-status <projectId>
-artifacts <projectId>
-deploy <projectId> --env production|staging|dev --by someone@teamx.com
-create --name <projectName> --path <folderPath> --lang ts|js
-```
-
-## Env
-
-- `BASE_URL` (optional) default: `https://teamx-discord-services.fly.dev`
-- `TEAMX_API_KEY` (optional) Bearer token header