thinkncollab-cli 0.0.1-0.1

package/.ignoretnc

@@ -0,0 +1,2 @@
+/node_modules
+

package/.vscode/geekload-types.d.ts

@@ -0,0 +1,455 @@
+declare class GroupClass {
+  /**
+   * Execute test group
+   *
+   * @param scenario Name or identifier of scenario function
+   * @param users Amount of virtual users
+   * @param profile Duration string ('5s', '1m 30s' etc) or Profile object
+   */
+  run(scenario: any, users: number, profile: any): void;
+}
+
+declare class ConfigClass {
+
+}
+
+/**
+* Configuration of project
+*/
+declare const config: ConfigClass;
+
+declare class StageClass {
+  /**
+   * Execute test stage
+   *
+   * @param title Title of stage 
+   * @param users Amount of virtual users
+   * @param groups Array of groups 
+   */  
+  run(title: string, users: number, groups: GroupClass[]): void;
+}
+
+/**
+* Stage of test with set of Groups
+*/
+declare const Stage: StageClass;
+
+/**
+* Group of test with set of Scenarios
+*/
+declare const Group: GroupClass;
+
+/**
+* Class representing BaseHttpRequest.
+*/
+declare class BaseHttpRequest {
+  /**
+   * Create a http GET request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  get(path: string): HttpRequest;
+
+  /**
+   * Create a http PUT request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  put(path: string): HttpRequest;
+
+  /**
+   * Create a http POST request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  post(path: string): HttpRequest;
+
+  /**
+   * Create a http PATH request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  patch(path: string): HttpRequest;
+
+  /**
+   * Create a http DELETE request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  delete(path: string): HttpRequest;
+
+  /**
+   * Create a http OPTIONS request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  options(path: string): HttpRequest;
+
+  /**
+   * Create a http HEAD request.
+   *
+   * @param {string} path - Relative path to target point.
+   * @returns {HttpRequest} - The created HttpRequest.
+   */
+  head(path: string): HttpRequest;
+}
+
+/**
+ * Body of Request's response.
+ */
+declare class BodyClass {
+  asText: string;
+  asObject: object;
+  asBytes: number[]
+}
+
+/**
+ * Result of HttpRequest's execution.
+ */
+declare class HttpResult {
+  statusCode: number
+  body: BodyClass
+}
+
+/**
+ * Class representing HttpRequest.
+ */
+declare class HttpRequest extends BaseHttpRequest {
+  /**
+   * Add header to request.
+   *
+   * @param {string} name - Name of the header.
+   * @param {string} value - Value of the header.
+   * @returns {HttpRequest} - The modified HttpRequest.
+   */
+  header(name: string, value: string): HttpRequest;
+
+  /**
+   * Add cookie to request.
+   *
+   * @param {string} name - Name of the cookie.
+   * @param {string} value - Value of the cookie.
+   * @returns {HttpRequest} - The modified HttpRequest.
+   */
+  cookie(name: string, value: string): HttpRequest;
+
+  /**
+   * Add query parameter to request url.
+   *
+   * @param {string} name - Name of the query parameter.
+   * @param {string} value - Value of the query parameter.
+   * @returns {HttpRequest} - The modified HttpRequest.
+   */
+  query(name: string, value: string): HttpRequest;
+
+  /**
+   * Set body value.
+   *
+   * @param {any} object - Body value.
+   * @returns {HttpRequest} - The modified HttpRequest.
+   */
+  body(object: any): HttpRequest;
+
+  /**
+   * Execute request.
+   *
+   * @returns {HttpResult} - The HttpResult.
+   */
+  sync(): HttpResult;
+
+  /**
+   * Execute request checks.
+   *
+   * @param {CheckExpression} check - Check object.
+   * @returns {HttpRequest} - The modified HttpRequest.
+   */
+  then(check: CheckExpression): HttpRequest;
+
+  /**
+   * Execute request checks.
+   *
+   * @param {() => any} check - Check function.
+   * @returns {HttpRequest} - The modified HttpRequest.
+   */
+  then(check: () => any): HttpRequest;
+}
+
+/**
+ * Class representing HttpConnection.
+ */
+declare class HttpConnection extends BaseHttpRequest {
+  /**
+   * Open connection to server.
+   *
+   * @returns {HttpConnection} - The HttpConnection.
+   */
+  connect(): HttpConnection;
+}
+
+/**
+ * Create a HTTP connection.
+ *
+ * @param {string} url - Url of server.
+ * @param {Options} options - Optional options object.
+ * @returns {HttpConnection} - The HttpConnection.
+ */
+declare function http(url: string, options?: Options): HttpConnection;
+
+/**
+ * Class representing Http2Connection.
+ */
+declare class Http2Connection extends HttpConnection {
+}
+
+/**
+ * Create a HTTP2 connection.
+ *
+ * @param {string} url - Url of server.
+ * @param {Options} options - Optional options object.
+ * @returns {Http2Connection} - The Http2Connection.
+ */
+declare function http2(url: string, options?: Options): Http2Connection;
+
+/**
+ * Class representing WebSocketConnection.
+ */
+declare class WebSocketConnection {
+  /**
+   * Send text message.
+   *
+   * @param {string} value - Text message.
+   */
+  sendText(value: string): void;
+
+  /**
+   * Send array message.
+   *
+   * @param {byte[]} value - Byte array.
+   */
+  sendArray(value: number[]): void;
+
+  /**
+   * Receive a text message.
+   *
+   * @returns {string} - The received text message.
+   */
+  receiveText(): string;
+
+  /**
+   * Receive a byte array.
+   *
+   * @returns {byte[]} - The received byte array.
+   */
+  receiveArray(): number[];
+}
+
+/**
+ * Create a WebSocket connection.
+ *
+ * @param {string} url - Url of server.
+ * @param {Options} options - Optional options object.
+ * @returns {WebSocketConnection} - The WebSocketConnection.
+ */
+declare function websocket(url: string, options?: Options): WebSocketConnection;
+
+/**
+ * Create a Swagger connection.
+ *
+ * @param {string} url - Url to Swagger definition.
+ * @param {Options} options - Optional options object.
+ * @returns {SwaggerConnection} - The SwaggerConnection.
+ */
+declare function swagger(url: string, options?: Options): SwaggerConnection;
+
+/**
+ * Class representing SwaggerConnection.
+ */
+declare class SwaggerConnection {
+  /**
+   * Print loaded definition to console.
+   */
+  show(): void;
+}
+
+/**
+ * Class representing Options.
+ */
+declare class Options {
+  cacheConnections: true;
+  connectionTimeout: '1m';
+}
+
+/**
+ * Change global options.
+ *
+ * @param {Options} value - Options object.
+ */
+declare function setOptions(value: Options): void;
+
+/**
+ * Pause scenario execution.
+ *
+ * @param {string} minDuration - Minimum duration of pause ('5ms', '1s 150ms', etc).
+ * @param {string} maxDuration - Maximum duration of pause ('5ms', '1s 150ms', etc).
+ */
+declare function pause(minDuration: string, maxDuration: string): void;
+
+/**
+ * Test log.
+ */
+declare const Log: LogClass;
+
+/**
+ * Class representing LogClass.
+ */
+declare class LogClass {
+  /**
+   * Post message to test log.
+   *
+   * @param {string} text - Text of the message.
+   */
+  message(text: string): void;
+
+  /**
+   * Post warning message to test log.
+   *
+   * @param {string} text - Text of the message.
+   */
+  warning(text: string): void;
+
+  /**
+   * Post error message to test log.
+   *
+   * @param {string} text - Text of the message.
+   */
+  error(text: string): void;
+}
+
+/**
+ * Class representing CheckExpression.
+ */
+declare class CheckExpression {
+  /**
+   * Checking for equality of the current and reference values.
+   *
+   * @param {any} value - Reference value.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  equal(value: any): CheckExpression;
+
+  /**
+   * Checking that the current value is greater than the reference value.
+   *
+   * @param {any} value - Reference value.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  great(value: any): CheckExpression;
+
+  /**
+   * Checking that the current value is less than the reference value.
+   *
+   * @param {any} value - Reference value.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  less(value: any): CheckExpression;
+
+  /**
+   * Checking that the current value contains the reference value.
+   *
+   * @param {any} value - Reference value.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  contains(value: any): CheckExpression;
+
+  /**
+   * Checking that the reference value contains the current value.
+   *
+   * @param {any} value - Reference value.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  isContained(value: any): CheckExpression;
+
+  /**
+   * Checking that the reference value exists.
+   *
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  exists(): CheckExpression;
+
+  /**
+   * Inverts the result of the check.
+   *
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  not(): CheckExpression;
+
+  /**
+   * Setting a custom message to display a checking error.
+   *
+   * @param {string} text - Custom message text.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  message(text: string): CheckExpression;
+
+  /**
+   * Saves the received value in the "Session" object with the specified name.
+   *
+   * @param {string} name - Value name.
+   * @returns {CheckExpression} - The CheckExpression.
+   */
+  store(name: string): CheckExpression;
+}
+
+/**
+ * The source of the value of the response status code for its verification.
+ *
+ * @returns {CheckExpression} - The CheckExpression.
+ */
+declare function statusCode(): CheckExpression;
+
+/**
+ * Selector for checking values obtained by Regular expression from body.
+ *
+ * @param {string | RegExp} expression - Regular expression.
+ * @param {number} group - Index of RegExp group. 0 by default.
+ * @param {number} index - Index of occurrence of expression. 0 by default.
+ * @returns {CheckExpression} - The CheckExpression.
+ */
+declare function regexp(expression: any, group: number, index: number): CheckExpression;
+
+/**
+ * Selector for checking values obtained by xPath expression from body.
+ *
+ * @param {string} expression - xPath expression.
+ * @returns {CheckExpression} - The CheckExpression.
+ */
+declare function xPath(expression: string): CheckExpression;
+
+/**
+ * Source of text for checking it.
+ *
+ * @returns {CheckExpression} - The CheckExpression.
+ */
+declare function text(): CheckExpression;
+
+/**
+ * Selector for checking cookies value obtained by name.
+ *
+ * @param {string} name - Name of cookie.
+ * @returns {CheckExpression} - The CheckExpression.
+ */
+declare function cookie(name: string): CheckExpression;
+
+/**
+ * Selector for checking headers value obtained by name.
+ *
+ * @param {string} name - Name of header.
+ * @returns {CheckExpression} - The CheckExpression.
+ */
+declare function header(name: string): CheckExpression;

package/Readme.md

@@ -0,0 +1,313 @@
+# 🧠 ThinkNCollab CLI
+
+A powerful command-line interface for seamless collaboration with **ThinkNCollab** — push files, manage rooms, and collaborate directly from your terminal.
+
+---
+
+## 🚀 Quick Start
+
+```bash
+# Install the CLI globally
+npm install -g @thinkncollab/tnc-cli
+
+# Login to your ThinkNCollab account
+tnc-cli login
+
+# Push files to a room
+tnc-cli push --room <roomId> <path>
+
+# Logout 
+tnc-cli logout
+```
+
+---
+
+## 🔐 Authentication
+
+### **Login Command**
+
+Authenticate with your ThinkNCollab account to enable CLI access:
+
+```bash
+tnc-cli login
+```
+
+### **What Happens During Login**
+
+- Opens a secure browser window to ThinkNCollab’s authentication page  
+- Completes OAuth2 authentication flow  
+- Creates an encrypted `.tncrc` configuration file in your home directory  
+- Stores secure tokens for future CLI sessions  
+
+### **Manual Authentication**
+
+```bash
+tnc-cli login --token YOUR_AUTH_TOKEN
+```
+
+### **Verify Authentication**
+
+```bash
+tnc-cli whoami
+```
+
+### **Logout**
+
+Clear stored credentials:
+
+```bash
+tnc-cli logout
+```
+
+---
+
+## 📦 File Operations
+
+### **Push Command**
+
+Push files or directories to ThinkNCollab rooms:
+
+```bash
+tnc-cli push --room <roomId> <path>
+```
+
+#### **Syntax**
+
+```bash
+tnc-cli push --room ROOM_ID PATH [ADDITIONAL_PATHS...]
+```
+
+#### **Examples**
+
+| Action | Command |
+|--------|----------|
+| Push a single file | `tnc-cli push --room 64a1b2c3d4e5f6a1b2c3d4e5 document.pdf` |
+| Push entire folder | `tnc-cli push --room 64a1b2c3d4e5f6a1b2c3d4e5 ./src/` |
+| Push multiple items | `tnc-cli push --room 64a1b2c3d4e5f6a1b2c3d4e5 file1.js assets/ components/` |
+| Push current directory | `tnc-cli push --room 64a1b2c3d4e5f6a1b2c3d4e5 .` |
+
+#### **Options**
+
+| Option | Short | Description |
+|---------|--------|-------------|
+| `--room` | `-r` | **Required:** Target room ID |
+| `--message` | `-m` | Commit message describing changes |
+| `--force` | `-f` | Force push (overwrite conflicts) |
+| `--dry-run` | — | Preview files before pushing |
+| `--exclude` | — | Additional patterns to exclude |
+
+---
+
+## 🧩 Room Management
+
+| Command | Description |
+|----------|--------------|
+| `tnc-cli rooms list` | List accessible rooms |
+| `tnc-cli rooms info <id>` | Show details for a specific room |
+
+---
+
+## 🚫 File Ignoring
+
+Use a `.ignoretnc` file in your project root to exclude files/folders during push.
+
+### **Example `.ignoretnc`**
+
+```text
+# Dependencies
+node_modules/
+vendor/
+bower_components/
+
+# Build outputs
+/dist
+/build
+/.next
+/out
+
+# Environment
+.env
+.env.local
+.env.production
+.env.development
+
+# Logs
+*.log
+npm-debug.log*
+yarn-debug.log*
+
+# Temporary / OS
+*.tmp
+.DS_Store
+Thumbs.db
+
+# IDE
+.vscode/
+.idea/
+
+# Test
+*.test.js
+*.spec.js
+/coverage/
+
+# Large assets
+*.psd
+*.ai
+*.sketch
+```
+
+### **Pattern Rules**
+
+| Type | Example | Description |
+|------|----------|-------------|
+| Directory | `dist/` | Ignore whole directory |
+| File Extension | `*.log` | Ignore all `.log` files |
+| Specific File | `secret.env` | Ignore single file |
+| Wildcard | `test-*.js` | Match name patterns |
+| Negation | `!keep.js` | Include despite other rules |
+| Comment | `# comment` | Ignored by parser |
+
+---
+
+## ⚙️ Configuration
+
+After login, an encrypted `.tncrc` file is created in your home directory.
+
+### **Example `.tncrc`**
+
+```json
+{
+  "user": {
+    "id": "encrypted_user_id",
+    "email": "encrypted_email",
+    "name": "encrypted_display_name"
+  },
+  "auth": {
+    "token": "encrypted_jwt_token",
+    "refreshToken": "encrypted_refresh_token",
+    "expires": "2025-12-31T23:59:59Z"
+  },
+  "workspace": {
+    "id": "encrypted_workspace_id",
+    "name": "encrypted_workspace_name"
+  },
+  "settings": {
+    "defaultRoom": "optional_default_room_id",
+    "autoSync": false
+  }
+}
+```
+
+### **Environment Variables**
+
+```bash
+export TNC_API_TOKEN="your_api_token"
+export TNC_API_URL="https://api.thinkncollab.com"
+export TNC_DEFAULT_ROOM="your_default_room_id"
+```
+
+---
+
+## ⚡ Advanced Usage
+
+### **Batch Push**
+
+```bash
+tnc-cli push --room room1,room2,room3 ./shared-assets/
+```
+
+### **CI/CD Integration**
+
+```bash
+tnc-cli login --token $TNC_DEPLOY_TOKEN
+tnc-cli push --room $PRODUCTION_ROOM ./dist/ --message "Build ${CI_COMMIT_SHA}"
+```
+
+### **Watch for Changes (Experimental)**
+
+```bash
+tnc-cli watch --room 64a1b2c3d4e5f6a1b2c3d4e5 ./src/
+```
+
+---
+
+## 🧰 Troubleshooting
+
+### **Authentication Issues**
+
+```bash
+tnc-cli logout
+tnc-cli login
+```
+
+- Ensure valid token and room access  
+- Token may need refresh or rotation  
+
+### **Permission Errors**
+
+- Confirm write access to target room  
+- Check if the room ID is active  
+
+### **File Size Limits**
+
+| Type | Limit |
+|------|--------|
+| Individual File | 100 MB |
+| Total Push | 1 GB |
+
+### **Debug Mode**
+
+Enable detailed logs:
+
+```bash
+tnc-cli --debug push --room 64a1b2c3d4e5f6a1b2c3d4e5 ./path/
+```
+
+---
+
+## 🔒 Security Guidelines
+
+- **Never share** your `.tncrc` file — it stores encrypted tokens  
+- **Never commit** `.tncrc` to Git or any version control  
+- Use `.ignoretnc` to exclude sensitive files  
+- Rotate API tokens regularly  
+- Validate room access before pushing confidential data  
+
+---
+
+## 💡 Best Practices
+
+- Use environment variables for automated environments  
+- Review `.ignoretnc` before each push  
+- Run `--dry-run` to preview changes  
+- Monitor push logs for unexpected files  
+
+---
+
+## 🧭 Command Reference
+
+| Command | Description |
+|----------|-------------|
+| `tnc-cli login` | Authenticate with ThinkNCollab |
+| `tnc-cli logout` | Clear credentials |
+| `tnc-cli whoami` | Show current user info |
+| `tnc-cli push --room <id> <path>` | Push files/folders to a room |
+| `tnc-cli rooms list` | List all accessible rooms |
+| `tnc-cli rooms info <id>` | Show room details |
+| `tnc-cli --version` | Show CLI version |
+| `tnc-cli --help` | Show help information |
+
+---
+
+## 🧩 Resources & Support
+
+- 📘 **Documentation:** [docs.thinkncollab.com/cli](https://docs.thinkncollab.com/cli)  
+- 🐙 **GitHub Issues:** [ThinkNCollab Repository](https://github.com/thinkncollab)  
+- ✉️ **Email:** support@thinkncollab.com  
+- 💬 **Community:** Join our [ThinkNCollab Discord](https://discord.gg/thinkncollab)
+
+---
+
+## 📄 License
+
+MIT License – see `LICENSE` file for details.

package/bin/index.js

@@ -0,0 +1,245 @@
+#!/usr/bin/env node
+import inquirer from "inquirer";
+import axios from "axios";
+import fs from "fs";
+import os from "os";
+import path from "path";
+import crypto from "crypto";
+import FormData from "form-data";
+
+const RC_FILE = path.join(os.homedir(), ".tncrc");
+const BASE_URL = "https://thinkncollab.com/rooms";
+
+// LOGOUT
+async function logout() {
+  try {
+    if (fs.existsSync(RC_FILE)) {
+      // Remove the .tncrc file safely
+      await fs.promises.rm(RC_FILE, { force: true });
+      console.log("✅ Logged out successfully. Local credentials removed.");
+    } else {
+      console.log("ℹ️ No active session found.");
+    }
+  } catch (err) {
+    console.error("❌ Error during logout:", err.message);
+  }
+}
+
+/** ========== LOGIN ========== **/
+async function login() {
+  const answers = await inquirer.prompt([
+    { type: "input", name: "email", message: "Email:" },
+    { type: "password", name: "password", message: "Password:" }
+  ]);
+
+  try {
+    console.log("🔐 Logging in...");
+    const res = await axios.post("https://thinkncollab.com/login", {
+      email: answers.email,
+      password: answers.password
+    });
+
+    const { token, email } = res.data;
+    fs.writeFileSync(RC_FILE, JSON.stringify({ token, email }, null, 2));
+    console.log(`✅ Login successful! Token saved to ${RC_FILE}`);
+  } catch (err) {
+    console.error("❌ Login failed:", err.response?.data?.message || err.message);
+  }
+}
+
+function readToken() {
+  if (!fs.existsSync(RC_FILE)) {
+    console.error("❌ Not logged in. Run 'tnc login' first.");
+    process.exit(1);
+  }
+  const data = JSON.parse(fs.readFileSync(RC_FILE));
+  return { token: data.token, email: data.email };
+}
+
+/** ========== IGNORE HANDLING ========== **/
+function loadIgnore(folderPath) {
+  const ignoreFile = path.join(folderPath, ".ignoretnc");
+  if (!fs.existsSync(ignoreFile)) return [];
+  return fs
+    .readFileSync(ignoreFile, "utf-8")
+    .split("\n")
+    .map(line => line.trim())
+    .filter(line => line && !line.startsWith("#"));
+}
+
+function shouldIgnore(relativePath, ignoreList) {
+  return ignoreList.some(pattern => {
+    if (pattern.endsWith("/**")) {
+      const folder = pattern.slice(0, -3);
+      return relativePath === folder || relativePath.startsWith(folder + path.sep);
+    }
+    if (pattern.startsWith("*.")) {
+      return relativePath.endsWith(pattern.slice(1));
+    }
+    return relativePath === pattern;
+  });
+}
+
+/** ========== SCAN FOLDER ========== **/
+function scanFolder(folderPath, ignoreList, rootPath = folderPath) {
+  const items = fs.readdirSync(folderPath, { withFileTypes: true });
+  const result = [];
+  for (const item of items) {
+    const fullPath = path.join(folderPath, item.name);
+    const relativePath = path.relative(rootPath, fullPath);
+
+    if (shouldIgnore(relativePath, ignoreList)) {
+      console.log("⚠️ Ignored:", relativePath);
+      continue;
+    }
+
+    if (item.isDirectory()) {
+      result.push({
+        name: item.name,
+        type: "folder",
+        children: scanFolder(fullPath, ignoreList, rootPath)
+      });
+    } else {
+      const stats = fs.statSync(fullPath);
+      result.push({
+        name: item.name,
+        type: "file",
+        path: fullPath,
+        size: stats.size
+      });
+    }
+  }
+  return result;
+}
+
+/** ========== CLOUDINARY UPLOAD (SIGNED) ========== **/
+async function uploadFileSigned(filePath, folder, roomId, token, email) {
+  const filename = path.basename(filePath);
+
+  const sigRes = await axios.post(
+    `${BASE_URL}/${roomId}/get-upload-signature`,
+    { filename, folder, roomId },
+    { headers: { authorization: `Bearer ${token}`, email } }
+  );
+
+  const { signature, timestamp, api_key, cloud_name } = sigRes.data;
+
+  const formData = new FormData();
+  formData.append("file", fs.createReadStream(filePath));
+  formData.append("folder", folder);
+  formData.append("public_id", filename);
+  formData.append("timestamp", timestamp);
+  formData.append("signature", signature);
+  formData.append("api_key", api_key);
+
+  const cloudRes = await axios.post(
+    `https://api.cloudinary.com/v1_1/${cloud_name}/auto/upload`,
+    formData,
+    { headers: formData.getHeaders() }
+  );
+
+  return cloudRes.data.secure_url;
+}
+
+async function uploadTree(fileTree, folderHex, roomId, token, email, parentPath = "") {
+  const uploaded = [];
+
+  for (const node of fileTree) {
+    const relativePath = path.join(parentPath, node.name).replace(/\\/g, "/");
+
+    if (node.type === "folder") {
+      const children = await uploadTree(node.children, folderHex, roomId, token, email, relativePath);
+      uploaded.push({
+        name: node.name,
+        type: "folder",
+        children
+      });
+    } else {
+      const url = await uploadFileSigned(node.path, `tnc_uploads/${folderHex}`, roomId, token, email);
+      console.log(`📦 Uploaded: ${relativePath} → ${url}`);
+
+      uploaded.push({
+        name: node.name,
+        type: "file",
+        path: relativePath,
+        size: node.size,
+        url // ✅ send top-level URL now
+      });
+    }
+  }
+
+  return uploaded;
+}
+
+/** ========== PUSH FUNCTION ========== **/
+async function push(roomId, targetPath) {
+  const { token, email } = readToken();
+  const stats = fs.statSync(targetPath);
+  const rootFolder = stats.isDirectory() ? targetPath : path.dirname(targetPath);
+  const ignoreList = loadIgnore(rootFolder);
+
+  let content;
+  if (stats.isDirectory()) {
+    content = scanFolder(targetPath, ignoreList);
+  } else {
+    const relativePath = path.basename(targetPath);
+    content = shouldIgnore(relativePath, ignoreList)
+      ? []
+      : [{ name: relativePath, type: "file", path: targetPath, size: stats.size }];
+  }
+
+  if (!content.length) {
+    console.log("⚠️ Nothing to upload (all ignored).");
+    return;
+  }
+
+  try {
+    const folderHex = crypto.createHash("md5").update(path.basename(targetPath) + Date.now()).digest("hex");
+
+    console.log("🚀 Uploading to Cloudinary...");
+    const uploadedTree = await uploadTree(content, folderHex, roomId, token, email);
+
+    console.log("🗂️ Sending metadata to backend...");
+    await axios.post(
+      `${BASE_URL}/${roomId}/upload`,
+      { folderId: folderHex, content: uploadedTree, uploadedBy: email },
+      { headers: { authorization: `Bearer ${token}`, email } }
+    );
+
+    console.log("✅ Upload complete! Metadata stored successfully.");
+  } catch (err) {
+    console.error("❌ Upload failed:", err.response?.data || err.message);
+  }
+}
+
+/** ========== CLI HANDLER ========== **/
+const args = process.argv.slice(2);
+
+switch (args[0]) {
+  case "login":
+    login();
+    break;
+
+  case "push": {
+    const roomIndex = args.indexOf("--room");
+    if (roomIndex === -1 || !args[roomIndex + 1] || !args[roomIndex + 2]) {
+      console.error("Usage: tnc push --room <roomId> <file-or-folder-path>");
+      process.exit(1);
+    }
+    const roomId = args[roomIndex + 1];
+    const targetPath = args[roomIndex + 2];
+    push(roomId, targetPath);
+    break;
+  }
+  case "logout": {
+    logout();
+    break;
+  }
+
+  default:
+    console.log("✅ TNC CLI ready!");
+    console.log("Commands:");
+    console.log("  tnc login");
+    console.log("  tnc push --room <roomId> <path>");
+    console.log("  tnc logout");
+}

package/bin/tnc.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+import { program } from "commander";
+import { pushToRoom } from "../lib/api.js";
+
+program
+  .name("tnc")
+  .description("ThinkNCollab CLI tool")
+  .version("0.1.0");
+
+program
+  .command("push")
+  .option("--room <roomId>", "Room ID to push files")
+  .action(async (opts) => {
+    if (!opts.room) {
+      console.error("❌ Please provide a room id using --room <id>");
+      process.exit(1);
+    }
+    await pushToRoom(opts.room);
+  });
+
+program.parse();

package/lib/api.js

@@ -0,0 +1,28 @@
+import { scanDirectory } from "./scanner.js";
+import { uploadFile } from "./uploader.js";
+import path from "path";
+import fs from "fs";
+
+export async function pushToRoom(roomId) {
+  const currentDir = process.cwd();
+  console.log(`📂 Scanning directory: ${currentDir}`);
+
+  const files = scanDirectory(currentDir);
+
+  const uploadedFiles = [];
+  for (let file of files) {
+    const url = await uploadFile(file);
+    uploadedFiles.push({
+      name: file.name,
+      path: file.path,
+      size: file.size,
+      url,
+    });
+  }
+
+  // Instead of real backend, save JSON locally for now
+  const outputPath = path.join(currentDir, `tnc_snapshot_${roomId}.json`);
+  fs.writeFileSync(outputPath, JSON.stringify(uploadedFiles, null, 2));
+
+  console.log(`✅ Snapshot saved at ${outputPath}`);
+}

package/lib/scanner.js

@@ -0,0 +1,27 @@
+import fs from "fs";
+import path from "path";
+
+export function scanDirectory(dirPath) {
+  const result = [];
+
+  function walk(dir) {
+    const files = fs.readdirSync(dir);
+    for (let file of files) {
+      const fullPath = path.join(dir, file);
+      const stat = fs.statSync(fullPath);
+
+      if (stat.isDirectory()) {
+        walk(fullPath);
+      } else {
+        result.push({
+          name: file,
+          path: fullPath,
+          size: stat.size,
+        });
+      }
+    }
+  }
+
+  walk(dirPath);
+  return result;
+}

package/lib/uploader.js

@@ -0,0 +1,5 @@
+export async function uploadFile(file) {
+  // Later: upload to S3/Cloudinary
+  // For now: just return a fake URL
+  return `https://fake-storage.com/${file.name}`;
+}

package/package.json

@@ -0,0 +1,18 @@
+{
+  "name": "thinkncollab-cli",
+  "author": "Raman Singh",
+  "version": "0.0.10.1",
+  "description": "CLI tool for ThinkNCollab",
+  "main": "index.js",
+  "bin": {
+    "tnc-cli": "./bin/index.js"
+  },
+  "scripts": {
+    "start": "node bin/index.js"
+  },
+  "type": "module",
+  "dependencies": {
+    "axios": "^1.12.2",
+    "inquirer": "^9.3.8"
+  }
+}