It's possible to create spaces

Author: pawelniewie

README.md

@@ -112,6 +112,40 @@ funcli spaces get z2zK66AaEF
 funcli spaces get z2zK66AaEF --json
 ```
 
+#### Create a new space
+
+```bash
+funcli spaces create <name>
+```
+
+Creates a new space. **Note:** Requires manager permissions in your organization.
+
+**Arguments:**
+- `<name>` - Space name (must be unique within your organization)
+
+**Options:**
+- `-a, --access-mode <mode>` - Access mode: `public`, `restricted`, or `private` (default: `public`)
+
+**Access Modes:**
+- **public**: Visible to all organization members
+- **restricted**: Visible to organization members but with limited access
+- **private**: Only visible to space members and teams
+
+**Examples:**
+
+```bash
+# Create a public space (default)
+funcli spaces create "My New Space"
+
+# Create a private space
+funcli spaces create "Private Team Space" --access-mode private
+
+# Create a restricted space
+funcli spaces create "Restricted Space" -a restricted
+```
+
+**Note:** When a space is created, a home document is automatically created for it.
+
 ### Documents
 
 #### List documents in a space

src/cli.js

@@ -81,6 +81,37 @@ spacesCommand
     }
   });
 
+spacesCommand
+  .command("create <name>")
+  .description("Create a new space")
+  .option("-a, --access-mode <mode>", "Access mode: public, restricted, or private (default: public)", "public")
+  .action(async (name, options) => {
+    try {
+      const config = new Config({
+        apiKey: program.opts().token,
+        baseUrl: program.opts().baseUrl
+      });
+      const client = new FundamentoClient(config);
+
+      // Validate access mode
+      const validModes = ["public", "restricted", "private"];
+      const accessMode = options.accessMode.toLowerCase();
+      if (!validModes.includes(accessMode)) {
+        console.error(chalk.red("Error:"), `Invalid access mode. Must be one of: ${validModes.join(", ")}`);
+        process.exit(1);
+      }
+
+      const space = await client.createSpace({ name, accessMode });
+
+      console.log(chalk.green("✓") + " Space created successfully!");
+      console.log(chalk.bold(space.name) + chalk.gray(` (${space.npi})`));
+      console.log(chalk.gray(`Access mode: ${space.access_mode}`));
+    } catch (error) {
+      console.error(chalk.red("Error:"), error.message);
+      process.exit(1);
+    }
+  });
+
 const documentsCommand = program
   .command("documents")
   .description("Manage documents");

src/client.js

@@ -33,6 +33,16 @@ export class FundamentoClient {
     return response.data;
   }
 
+  async createSpace({ name, accessMode }) {
+    const response = await this.axios.post("/api/v1/spaces", {
+      space: {
+        name,
+        access_mode: accessMode
+      }
+    });
+    return response.data;
+  }
+
   async listDocuments(spaceNpi) {
     const response = await this.axios.get(`/api/v1/spaces/${spaceNpi}/documents`);
     return response.data;

test/client.test.js

@@ -65,3 +65,36 @@ test("FundamentoClient createDocument should format request correctly", () => {
   // Restore original post
   client.axios.post = originalPost;
 });
+
+test("FundamentoClient createSpace should format request correctly", () => {
+  const config = new Config({ apiKey: "test-key" });
+  const client = new FundamentoClient(config);
+
+  // Mock axios post
+  const originalPost = client.axios.post;
+  let capturedUrl, capturedData;
+
+  client.axios.post = async (url, data) => {
+    capturedUrl = url;
+    capturedData = data;
+    return { data: { npi: "space123", name: "Test Space", access_mode: "public" } };
+  };
+
+  // Call createSpace
+  client.createSpace({
+    name: "Test Space",
+    accessMode: "public"
+  });
+
+  // Verify the request format
+  assert.strictEqual(capturedUrl, "/api/v1/spaces");
+  assert.deepStrictEqual(capturedData, {
+    space: {
+      name: "Test Space",
+      access_mode: "public"
+    }
+  });
+
+  // Restore original post
+  client.axios.post = originalPost;
+});