decoupled-cli 2.1.7 → 2.1.9

package/README.md

@@ -61,9 +61,10 @@ When this environment variable is set, the CLI will automatically use it for aut
 
 **Priority order for authentication:**
 1. `DECOUPLED_CLI_TOKEN` environment variable (highest priority)
-2. OAuth credentials from `.env.local` (for Drupal content operations)
-3. Stored token in system keychain
-4. Stored token in config file
+2. Stored token in system keychain
+3. Stored token in config file
+
+**Note:** Content import operations use the same PAT token - no separate OAuth configuration needed!
 
 #### Proxy Support
 

package/examples/CLAUDE.md

@@ -40,6 +40,65 @@ npx decoupled-cli spaces use <space_id>
 npx decoupled-cli spaces current
 ```
 
+## Space Management
+
+**Creating a new space:**
+```bash
+# Create a space with default type (starter)
+npx decoupled-cli spaces create "My New Space"
+
+# Create a space with specific type
+npx decoupled-cli spaces create "Production Site" --type pro
+npx decoupled-cli spaces create "Enterprise App" --type premium
+
+# Available types: starter, pro, premium
+
+# Create with description
+npx decoupled-cli spaces create "E-commerce Platform" \
+  --type premium \
+  --description "Main production e-commerce site"
+```
+
+**Listing and managing spaces:**
+```bash
+# List all spaces
+npx decoupled-cli spaces list
+
+# List with detailed information
+npx decoupled-cli spaces list --detailed
+
+# Get space details by ID or name
+npx decoupled-cli spaces get 123
+npx decoupled-cli spaces get my-space-name
+
+# Check space status
+npx decoupled-cli spaces status 123
+
+# Set default space for operations
+npx decoupled-cli spaces use 123
+npx decoupled-cli spaces current
+```
+
+**Other space operations:**
+```bash
+# Clone an existing space
+npx decoupled-cli spaces clone 123 --name "Development Copy"
+
+# Update space name or type
+npx decoupled-cli spaces update 123 --name "Updated Name"
+npx decoupled-cli spaces update 123 --type premium
+
+# Get Drupal admin login link
+npx decoupled-cli spaces login 123
+
+# Archive/unarchive spaces
+npx decoupled-cli spaces archive 123
+npx decoupled-cli spaces unarchive 123
+
+# Delete space (with confirmation)
+npx decoupled-cli spaces delete 123
+```
+
 **OAuth Prerequisites (for `decoupled-cli auth oauth`):**
 Your `.env.local` must contain:
 - `NEXT_PUBLIC_DRUPAL_BASE_URL=https://your-space.decoupled.io`
@@ -47,8 +106,8 @@ Your `.env.local` must contain:
 - `DRUPAL_CLIENT_SECRET=your_oauth_client_secret`
 
 **Authentication Method Differences:**
-- **OAuth** → Works with your Drupal site API (content import, Drupal operations)
-- **Personal Access Token** → Works with Decoupled Drupal platform API (spaces, users, organizations)
+- **Personal Access Token (PAT)** → Works with Decoupled Drupal platform API (spaces, users, organizations, **content import via platform proxy**)
+- **OAuth** → Direct Drupal site API access (alternative method for content import, local development)
 
 **If CLI is not available locally:**
 - For projects with decoupled-cli in package.json: Run `npm install` then use `npx decoupled-cli`
@@ -59,8 +118,8 @@ Your `.env.local` must contain:
 
 When asked to create a new content type (e.g., "create a product page"), follow these steps:
 
-**Recommended Workflow (OAuth + Drupal API):**
-Use OAuth authentication for direct Drupal content import, then frontend development.
+**Recommended Workflow (PAT + Platform Proxy - Contentful-like simplicity):**
+Use a single PAT token for all operations including content import via the platform proxy.
 
 ### 1. Content Analysis & Planning
 
@@ -75,7 +134,7 @@ Use OAuth authentication for direct Drupal content import, then frontend develop
 ```markdown
 1. Verify DC CLI authentication (npx decoupled-cli auth status)
 2. Create DC Import JSON for [content_type]
-3. Import content type and sample content to Drupal (npx decoupled-cli content import)
+3. Import content type and sample content via platform (npx decoupled-cli spaces content-import <space_id> --file import.json)
 4. **CRITICAL**: Run schema generation (`npm run generate-schema`) to update GraphQL schema
 5. Create TypeScript types and GraphQL queries
 6. Build frontend components ([ContentCard], [ContentRenderer])
@@ -84,18 +143,17 @@ Use OAuth authentication for direct Drupal content import, then frontend develop
 9. Validate end-to-end functionality
 ```
 
-**Legacy Platform Workflow (PAT + Decoupled Drupal Platform):**
+**Alternative Workflow (OAuth + Direct Drupal API):**
 ```markdown
-1. Verify DC CLI authentication (npx decoupled-cli auth status)
-2. Set default space if needed (npx decoupled-cli spaces use <id>)
-3. Create DC Import JSON for [content_type]
-4. Import content type and sample content via platform (npx decoupled-cli spaces content-import)
-5. **CRITICAL**: Run schema generation (`npm run generate-schema`) to update GraphQL schema
-6. Create TypeScript types and GraphQL queries
-7. Build frontend components ([ContentCard], [ContentRenderer])
-8. Create listing and detail pages
-9. Test build process and fix errors
-10. Validate end-to-end functionality
+1. Set up OAuth authentication (npx decoupled-cli auth oauth)
+2. Create DC Import JSON for [content_type]
+3. Import content type and sample content to Drupal directly (npx decoupled-cli content import --file import.json)
+4. **CRITICAL**: Run schema generation (`npm run generate-schema`) to update GraphQL schema
+5. Create TypeScript types and GraphQL queries
+6. Build frontend components ([ContentCard], [ContentRenderer])
+7. Create listing and detail pages
+8. Test build process and fix errors
+9. Validate end-to-end functionality
 ```
 
 ### 0. CLI Authentication Check
@@ -195,17 +253,23 @@ npx decoupled-cli spaces content-import --example > my-content-type.json
 
 ### 3. Import via DC CLI
 
-**Import Content Type:**
+**Import Content Type (Recommended - PAT Only):**
+```bash
+# Import via platform proxy using PAT token (Contentful-like simplicity)
+# No OAuth credentials needed - just your PAT token!
+npx decoupled-cli spaces content-import <space_id> --file content-type-import.json
+
+# Or let the CLI use your default space
+npx decoupled-cli spaces content-import --file content-type-import.json
+```
+
+**Alternative: Direct Drupal Import (OAuth Required):**
 ```bash
-# NEW: Import content directly to your Drupal site (OAuth authentication)
+# Import directly to your Drupal site (requires OAuth authentication)
 npx decoupled-cli content import --file content-type-import.json
 
 # Or preview first to see what will be imported
 npx decoupled-cli content import --file content-type-import.json --preview
-
-# LEGACY: Import via Decoupled Drupal platform (requires PAT authentication and space setup)
-npx decoupled-cli spaces content-import --file content-type-import.json
-npx decoupled-cli spaces content-import <space_id> --file content-type-import.json
 ```
 
 **Generate example import file:**
@@ -759,9 +823,9 @@ npx decoupled-cli content status
 npx decoupled-cli content import --file your-content.json
 ```
 
-**When to use OAuth vs PAT:**
-- **OAuth**: Local development, direct Drupal operations, content import
-- **PAT**: Production deployments, platform management, space operations
+**When to use PAT vs OAuth:**
+- **PAT (Recommended)**: All operations including content import, space management, production deployments - **just like Contentful's CMA token**
+- **OAuth**: Alternative method for direct Drupal API access, local development with existing Drupal credentials
 
 ## Best Practices
 

package/examples/GEMINI.md

@@ -40,6 +40,65 @@ npx decoupled-cli spaces use <space_id>
 npx decoupled-cli spaces current
 ```
 
+## Space Management
+
+**Creating a new space:**
+```bash
+# Create a space with default type (starter)
+npx decoupled-cli spaces create "My New Space"
+
+# Create a space with specific type
+npx decoupled-cli spaces create "Production Site" --type pro
+npx decoupled-cli spaces create "Enterprise App" --type premium
+
+# Available types: starter, pro, premium
+
+# Create with description
+npx decoupled-cli spaces create "E-commerce Platform" \
+  --type premium \
+  --description "Main production e-commerce site"
+```
+
+**Listing and managing spaces:**
+```bash
+# List all spaces
+npx decoupled-cli spaces list
+
+# List with detailed information
+npx decoupled-cli spaces list --detailed
+
+# Get space details by ID or name
+npx decoupled-cli spaces get 123
+npx decoupled-cli spaces get my-space-name
+
+# Check space status
+npx decoupled-cli spaces status 123
+
+# Set default space for operations
+npx decoupled-cli spaces use 123
+npx decoupled-cli spaces current
+```
+
+**Other space operations:**
+```bash
+# Clone an existing space
+npx decoupled-cli spaces clone 123 --name "Development Copy"
+
+# Update space name or type
+npx decoupled-cli spaces update 123 --name "Updated Name"
+npx decoupled-cli spaces update 123 --type premium
+
+# Get Drupal admin login link
+npx decoupled-cli spaces login 123
+
+# Archive/unarchive spaces
+npx decoupled-cli spaces archive 123
+npx decoupled-cli spaces unarchive 123
+
+# Delete space (with confirmation)
+npx decoupled-cli spaces delete 123
+```
+
 **OAuth Prerequisites (for `decoupled-cli auth oauth`):**
 Your `.env.local` must contain:
 - `NEXT_PUBLIC_DRUPAL_BASE_URL=https://your-space.decoupled.io`
@@ -47,8 +106,8 @@ Your `.env.local` must contain:
 - `DRUPAL_CLIENT_SECRET=your_oauth_client_secret`
 
 **Authentication Method Differences:**
-- **OAuth** → Works with your Drupal site API (content import, Drupal operations)
-- **Personal Access Token** → Works with Decoupled Drupal platform API (spaces, users, organizations)
+- **Personal Access Token (PAT)** → Works with Decoupled Drupal platform API (spaces, users, organizations, **content import via platform proxy**)
+- **OAuth** → Direct Drupal site API access (alternative method for content import, local development)
 
 **If CLI is not available locally:**
 - For projects with decoupled-cli in package.json: Run `npm install` then use `npx decoupled-cli`
@@ -59,8 +118,8 @@ Your `.env.local` must contain:
 
 When asked to create a new content type (e.g., "create a product page"), follow these steps:
 
-**Recommended Workflow (OAuth + Drupal API):**
-Use OAuth authentication for direct Drupal content import, then frontend development.
+**Recommended Workflow (PAT + Platform Proxy - Contentful-like simplicity):**
+Use a single PAT token for all operations including content import via the platform proxy.
 
 ### 1. Content Analysis & Planning
 
@@ -75,7 +134,7 @@ Use OAuth authentication for direct Drupal content import, then frontend develop
 ```markdown
 1. Verify DC CLI authentication (npx decoupled-cli auth status)
 2. Create DC Import JSON for [content_type]
-3. Import content type and sample content to Drupal (npx decoupled-cli content import)
+3. Import content type and sample content via platform (npx decoupled-cli spaces content-import <space_id> --file import.json)
 4. **CRITICAL**: Run schema generation (`npm run generate-schema`) to update GraphQL schema
 5. Create TypeScript types and GraphQL queries
 6. Build frontend components ([ContentCard], [ContentRenderer])
@@ -84,18 +143,17 @@ Use OAuth authentication for direct Drupal content import, then frontend develop
 9. Validate end-to-end functionality
 ```
 
-**Legacy Platform Workflow (PAT + Decoupled Drupal Platform):**
+**Alternative Workflow (OAuth + Direct Drupal API):**
 ```markdown
-1. Verify DC CLI authentication (npx decoupled-cli auth status)
-2. Set default space if needed (npx decoupled-cli spaces use <id>)
-3. Create DC Import JSON for [content_type]
-4. Import content type and sample content via platform (npx decoupled-cli spaces content-import)
-5. **CRITICAL**: Run schema generation (`npm run generate-schema`) to update GraphQL schema
-6. Create TypeScript types and GraphQL queries
-7. Build frontend components ([ContentCard], [ContentRenderer])
-8. Create listing and detail pages
-9. Test build process and fix errors
-10. Validate end-to-end functionality
+1. Set up OAuth authentication (npx decoupled-cli auth oauth)
+2. Create DC Import JSON for [content_type]
+3. Import content type and sample content to Drupal directly (npx decoupled-cli content import --file import.json)
+4. **CRITICAL**: Run schema generation (`npm run generate-schema`) to update GraphQL schema
+5. Create TypeScript types and GraphQL queries
+6. Build frontend components ([ContentCard], [ContentRenderer])
+7. Create listing and detail pages
+8. Test build process and fix errors
+9. Validate end-to-end functionality
 ```
 
 ### 0. CLI Authentication Check
@@ -195,17 +253,23 @@ npx decoupled-cli spaces content-import --example > my-content-type.json
 
 ### 3. Import via DC CLI
 
-**Import Content Type:**
+**Import Content Type (Recommended - PAT Only):**
+```bash
+# Import via platform proxy using PAT token (Contentful-like simplicity)
+# No OAuth credentials needed - just your PAT token!
+npx decoupled-cli spaces content-import <space_id> --file content-type-import.json
+
+# Or let the CLI use your default space
+npx decoupled-cli spaces content-import --file content-type-import.json
+```
+
+**Alternative: Direct Drupal Import (OAuth Required):**
 ```bash
-# NEW: Import content directly to your Drupal site (OAuth authentication)
+# Import directly to your Drupal site (requires OAuth authentication)
 npx decoupled-cli content import --file content-type-import.json
 
 # Or preview first to see what will be imported
 npx decoupled-cli content import --file content-type-import.json --preview
-
-# LEGACY: Import via Decoupled Drupal platform (requires PAT authentication and space setup)
-npx decoupled-cli spaces content-import --file content-type-import.json
-npx decoupled-cli spaces content-import <space_id> --file content-type-import.json
 ```
 
 **Generate example import file:**
@@ -763,9 +827,9 @@ npx decoupled-cli content status
 npx decoupled-cli content import --file your-content.json
 ```
 
-**When to use OAuth vs PAT:**
-- **OAuth**: Local development, direct Drupal operations, content import
-- **PAT**: Production deployments, platform management, space operations
+**When to use PAT vs OAuth:**
+- **PAT (Recommended)**: All operations including content import, space management, production deployments - **just like Contentful's CMA token**
+- **OAuth**: Alternative method for direct Drupal API access, local development with existing Drupal credentials
 
 ## Best Practices
 

package/examples/content-import-sample.json

@@ -1,22 +1,22 @@
 {
   "model": [
     {
-      "bundle": "article",
+      "bundle": "news_article",
       "description": "Blog articles and news posts with rich media and categorization",
-      "label": "Article",
+      "label": "News Article",
       "body": true,
       "fields": [
         {
           "id": "summary",
           "label": "Summary",
           "type": "string",
-          "description": "Short text field (max 255 chars) for article preview"
+          "description": "Short text field (max 255 chars) for news_article preview"
         },
         {
           "id": "featured_image",
           "label": "Featured Image",
           "type": "image",
-          "description": "Single image upload for article hero"
+          "description": "Single image upload for news_article hero"
         },
         {
           "id": "published_date",
@@ -126,11 +126,6 @@
           "label": "Specifications",
           "type": "string[]",
           "description": "Technical specifications"
-        },
-        {
-          "id": "category",
-          "label": "Product Category",
-          "type": "term(product_category)[]"
         }
       ]
     }
@@ -141,17 +136,12 @@
       "type": "paragraph.content_block",
       "values": {
         "block_title": "Introduction",
-        "block_content": "<p>This is an <strong>example content block</strong> with formatted text.</p>",
-        "block_image": {
-          "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-          "alt": "Content block illustration",
-          "title": "Block Image"
-        }
+        "block_content": "<p>This is an <strong>example content block</strong> with formatted text.</p>"
       }
     },
     {
       "id": "article1",
-      "type": "node.article",
+      "type": "node.news_article",
       "path": "/articles/getting-started-with-drupal",
       "values": {
         "title": "Getting Started with Decoupled Drupal",
@@ -166,23 +156,6 @@
           "Connect via GraphQL or REST API",
           "Deploy frontend and backend independently"
         ],
-        "featured_image": {
-          "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-          "alt": "Decoupled Drupal architecture diagram",
-          "title": "Architecture Overview"
-        },
-        "gallery": [
-          {
-            "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-            "alt": "Screenshot of content management interface",
-            "title": "CMS Interface"
-          },
-          {
-            "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-            "alt": "Frontend application example",
-            "title": "Frontend App"
-          }
-        ],
         "tags": [
           "drupal",
           "headless-cms",
@@ -216,22 +189,6 @@
           "Size: 4 x 4 x 0.5 inches",
           "Weight: 3.2 oz",
           "Color: Matte Black"
-        ],
-        "product_images": [
-          {
-            "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-            "alt": "Wireless Charger Pro front view",
-            "title": "Product Front"
-          },
-          {
-            "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
-            "alt": "Wireless Charger Pro with phone charging",
-            "title": "In Use"
-          }
-        ],
-        "category": [
-          "electronics",
-          "accessories"
         ]
       }
     }
@@ -253,11 +210,11 @@
     "image_format": {
       "description": "Images require full URLs with Drupal domain, not relative paths",
       "example": {
-        "uri": "${DRUPAL_BASE_URL}/modules/custom/dc_import/resources/placeholder.png",
+        "uri": "https://example.com/path/to/image.png",
         "alt": "Descriptive alt text for accessibility",
         "title": "Image title"
       },
-      "note": "Replace ${DRUPAL_BASE_URL} with actual Drupal URL from .env.local"
+      "note": "Use full URLs to publicly accessible images"
     },
     "content_references": {
       "description": "Reference other content items using @id syntax",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "decoupled-cli",
-  "version": "2.1.7",
+  "version": "2.1.9",
   "description": "Command-line interface for Decoupled Drupal API management",
   "main": "dist/index.js",
   "bin": {