decoupled-cli 2.0.0

package/dist/lib/config.js

@@ -0,0 +1,317 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.configManager = exports.ConfigManager = void 0;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const chalk_1 = __importDefault(require("chalk"));
+const dotenv_1 = require("dotenv");
+const node_fetch_1 = __importDefault(require("node-fetch"));
+// Conditionally import keytar to avoid native module errors in Docker environments.
+let keytar = null;
+let keytarAvailable = false;
+try {
+    keytar = require('keytar');
+    keytarAvailable = true;
+}
+catch (error) {
+    console.warn(chalk_1.default.yellow('Warning: Secure credential storage not available (keytar). Falling back to environment variables.'));
+    keytarAvailable = false;
+}
+const CONFIG_DIR = path.join(os.homedir(), '.decoupled-cli');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+const SERVICE_NAME = 'decoupled-cli';
+const DEFAULT_CONFIG = {
+    currentProfile: 'default',
+    profiles: {},
+    settings: {
+        output: 'table',
+        timeout: 30,
+        color: true
+    }
+};
+class ConfigManager {
+    constructor() {
+        this.config = this.loadConfig();
+        this.loadEnvFile();
+    }
+    loadConfig() {
+        try {
+            if (!fs.existsSync(CONFIG_FILE)) {
+                this.ensureConfigDir();
+                this.saveConfig(DEFAULT_CONFIG);
+                return DEFAULT_CONFIG;
+            }
+            const configData = fs.readFileSync(CONFIG_FILE, 'utf-8');
+            return { ...DEFAULT_CONFIG, ...JSON.parse(configData) };
+        }
+        catch (error) {
+            console.warn(chalk_1.default.yellow('Warning: Could not load config, using defaults'));
+            return DEFAULT_CONFIG;
+        }
+    }
+    ensureConfigDir() {
+        if (!fs.existsSync(CONFIG_DIR)) {
+            fs.mkdirSync(CONFIG_DIR, { recursive: true });
+        }
+    }
+    saveConfig(config) {
+        this.ensureConfigDir();
+        fs.writeFileSync(CONFIG_FILE, JSON.stringify(config, null, 2));
+    }
+    getConfig() {
+        return this.config;
+    }
+    getCurrentProfile() {
+        return this.config.profiles[this.config.currentProfile] || null;
+    }
+    setProfile(name, profile) {
+        this.config.profiles[name] = profile;
+        this.saveConfig(this.config);
+    }
+    setCurrentProfile(name) {
+        if (!this.config.profiles[name]) {
+            throw new Error(`Profile '${name}' does not exist`);
+        }
+        this.config.currentProfile = name;
+        this.saveConfig(this.config);
+    }
+    deleteProfile(name) {
+        if (name === this.config.currentProfile) {
+            throw new Error('Cannot delete the current profile');
+        }
+        delete this.config.profiles[name];
+        this.saveConfig(this.config);
+    }
+    setSetting(key, value) {
+        this.config.settings[key] = value;
+        this.saveConfig(this.config);
+    }
+    async storeToken(profileName, token) {
+        if (keytarAvailable) {
+            try {
+                await keytar.setPassword(SERVICE_NAME, profileName, token);
+                return;
+            }
+            catch (error) {
+                console.warn(chalk_1.default.yellow(`Warning: Failed to store token in keychain: ${error}`));
+            }
+        }
+        // Fallback: Store token hash in config file (less secure but works in Docker).
+        const tokenHash = Buffer.from(token).toString('base64');
+        this.config.profiles[profileName] = {
+            ...this.config.profiles[profileName],
+            tokenHash
+        };
+        this.saveConfig(this.config);
+        console.warn(chalk_1.default.yellow('Token stored in config file (less secure). Consider using environment variables in production.'));
+    }
+    async getToken(profileName) {
+        const profile = profileName || this.config.currentProfile;
+        const profileConfig = this.config.profiles[profile];
+        // Check if profile is configured for OAuth
+        if (profileConfig?.useOAuth) {
+            // For .ddev.site domains, skip OAuth token generation to avoid OAuth module conflicts
+            if (profileConfig.baseUrl && profileConfig.baseUrl.includes('.ddev.site')) {
+                console.log(chalk_1.default.yellow('Skipping OAuth token for DDEV site - using development bypass'));
+                return 'dev-bypass-token'; // Return a dummy token
+            }
+            const oauthToken = await this.getOAuthTokenFromEnv();
+            if (oauthToken) {
+                return oauthToken;
+            }
+        }
+        // Try keytar first if available
+        if (keytarAvailable) {
+            try {
+                const token = await keytar.getPassword(SERVICE_NAME, profile);
+                if (token) {
+                    return token;
+                }
+            }
+            catch (error) {
+                console.warn(chalk_1.default.yellow(`Warning: Failed to retrieve token from keychain: ${error}`));
+            }
+        }
+        // Fallback to config file stored token hash
+        if (profileConfig?.tokenHash) {
+            try {
+                return Buffer.from(profileConfig.tokenHash, 'base64').toString();
+            }
+            catch (error) {
+                console.warn(chalk_1.default.yellow(`Warning: Failed to decode token from config: ${error}`));
+            }
+        }
+        return null;
+    }
+    async deleteToken(profileName) {
+        // Delete from keytar if available
+        if (keytarAvailable) {
+            try {
+                await keytar.deletePassword(SERVICE_NAME, profileName);
+            }
+            catch (error) {
+                // Ignore if token doesn't exist
+            }
+        }
+        // Also remove token hash from config file
+        if (this.config.profiles[profileName]?.tokenHash) {
+            delete this.config.profiles[profileName].tokenHash;
+            this.saveConfig(this.config);
+        }
+    }
+    listProfiles() {
+        return Object.keys(this.config.profiles);
+    }
+    getConfigPath() {
+        return CONFIG_FILE;
+    }
+    setDefaultSpace(spaceId) {
+        this.config.defaultSpace = spaceId;
+        this.saveConfig(this.config);
+    }
+    getDefaultSpace() {
+        return this.config.defaultSpace;
+    }
+    clearDefaultSpace() {
+        delete this.config.defaultSpace;
+        this.saveConfig(this.config);
+    }
+    async resetConfig() {
+        try {
+            // Get list of all profiles to clear their tokens
+            const profiles = Object.keys(this.config.profiles);
+            // Clear all stored tokens
+            for (const profile of profiles) {
+                await this.deleteToken(profile);
+            }
+            // Reset configuration to defaults
+            this.config = { ...DEFAULT_CONFIG };
+            // Remove config file and recreate with defaults
+            if (fs.existsSync(CONFIG_FILE)) {
+                fs.unlinkSync(CONFIG_FILE);
+            }
+            // Save default configuration
+            this.saveConfig(this.config);
+        }
+        catch (error) {
+            throw new Error(`Failed to reset configuration: ${error}`);
+        }
+    }
+    /**
+     * Load .env.local file if it exists.
+     */
+    loadEnvFile() {
+        const envPath = path.join(process.cwd(), '.env.local');
+        if (fs.existsSync(envPath)) {
+            (0, dotenv_1.config)({ path: envPath });
+        }
+    }
+    /**
+     * Get OAuth token by performing client credentials flow.
+     */
+    async getOAuthTokenFromEnv() {
+        const clientId = process.env.DRUPAL_CLIENT_ID;
+        const clientSecret = process.env.DRUPAL_CLIENT_SECRET;
+        const drupalBaseUrl = process.env.NEXT_PUBLIC_DRUPAL_BASE_URL;
+        if (!clientId || !clientSecret || !drupalBaseUrl) {
+            return null;
+        }
+        try {
+            // Perform OAuth2 client credentials flow
+            const tokenUrl = `${drupalBaseUrl}/oauth/token`;
+            const response = await (0, node_fetch_1.default)(tokenUrl, {
+                method: 'POST',
+                headers: {
+                    'Content-Type': 'application/x-www-form-urlencoded',
+                    'Accept': 'application/json',
+                },
+                body: new URLSearchParams({
+                    grant_type: 'client_credentials',
+                    client_id: clientId,
+                    client_secret: clientSecret,
+                }),
+            });
+            if (!response.ok) {
+                console.warn(chalk_1.default.yellow(`OAuth token request failed: ${response.status} ${response.statusText}`));
+                return null;
+            }
+            const tokenData = await response.json();
+            return tokenData.access_token || null;
+        }
+        catch (error) {
+            console.warn(chalk_1.default.yellow(`OAuth token request error: ${error instanceof Error ? error.message : String(error)}`));
+            return null;
+        }
+    }
+    /**
+     * Check if OAuth credentials are available in environment.
+     */
+    hasOAuthCredentials() {
+        return !!(process.env.DRUPAL_CLIENT_ID &&
+            process.env.DRUPAL_CLIENT_SECRET &&
+            process.env.NEXT_PUBLIC_DRUPAL_BASE_URL);
+    }
+    /**
+     * Get Drupal base URL from environment.
+     */
+    getDrupalBaseUrl() {
+        return process.env.NEXT_PUBLIC_DRUPAL_BASE_URL || null;
+    }
+    /**
+     * Set profile to use OAuth authentication.
+     */
+    setProfileOAuth(profileName, useOAuth) {
+        if (!this.config.profiles[profileName]) {
+            throw new Error(`Profile '${profileName}' does not exist`);
+        }
+        this.config.profiles[profileName].useOAuth = useOAuth;
+        this.saveConfig(this.config);
+    }
+    /**
+     * Check if current profile uses OAuth authentication.
+     */
+    isCurrentProfileOAuth() {
+        const currentProfile = this.getCurrentProfile();
+        return currentProfile?.useOAuth || false;
+    }
+}
+exports.ConfigManager = ConfigManager;
+exports.configManager = new ConfigManager();
+//# sourceMappingURL=config.js.map

package/dist/lib/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/lib/config.ts"],"names":[],"mappings":"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"}

package/examples/.cursorrules

@@ -0,0 +1,189 @@
+You are the Cursor AI working in a Next.js + Drupal monorepo. Follow these rules to deliver complete, working features end-to-end.
+
+# Project Overview
+- Architecture: Headless Drupal backend with Next.js frontend
+- Backend: Drupal 11 with GraphQL Compose and DCloud Import API
+- Frontend: Next.js 15 with TypeScript, Tailwind CSS, Apollo GraphQL
+- Environment: DDEV local development
+
+# Environment Configuration
+- Environment variables in `.env.local`:
+  - `NEXT_PUBLIC_DRUPAL_BASE_URL` – Drupal base URL
+  - `DRUPAL_CLIENT_ID` / `DRUPAL_CLIENT_SECRET` – OAuth credentials
+  - `DRUPAL_REVALIDATE_SECRET` – On-demand revalidation secret
+  - `NODE_TLS_REJECT_UNAUTHORIZED=0` – Allow self-signed certs (dev)
+
+# DCloud CLI Usage
+**CRITICAL**: Use DCloud CLI instead of direct API calls.
+
+First-time setup:
+```bash
+dcloud auth login         # Authenticate with platform
+dcloud spaces use <id>    # Set default space (optional)
+dcloud spaces current     # Verify setup
+```
+
+# End-to-End Workflow
+When asked to implement a new content type (e.g., “create a product page”), complete all steps:
+
+1) Verify CLI authentication
+```bash
+dcloud auth status        # Check if authenticated
+dcloud spaces list        # List available spaces
+dcloud spaces use <id>    # Set default space if needed
+```
+
+2) Plan content type
+- Define name + machine name
+- List fields and types
+- Determine components, routes, display needs
+
+3) Create DCloud Import JSON
+- Get example format: `dcloud spaces content-import --example`
+- Include model definition and sample content
+- Important: In `values`, use field ID directly, never with `field_` prefix
+- For image fields: Use full URLs with Drupal domain from `.env.local`, not relative paths
+
+Template:
+```json
+{
+  "model": [
+    {
+      "bundle": "content_type_name",
+      "description": "Description",
+      "label": "Content Type Label",
+      "body": true,
+      "fields": [
+        { "id": "field_name", "label": "Field Label", "type": "text|string|image|datetime|bool|text[]" }
+      ]
+    }
+  ],
+  "content": [
+    {
+      "id": "item1",
+      "type": "node.content_type_name",
+      "path": "/content-type/item-slug",
+      "values": {
+        "title": "Item Title",
+        "body": "<p>Body content</p>",
+        "field_name": "field_value",
+        "image_field": {
+          "uri": "${DRUPAL_BASE_URL}/modules/custom/dcloud_import/resources/placeholder.png",
+          "alt": "Image description",
+          "title": "Image title"
+        }
+      }
+    }
+  ]
+}
+```
+
+4) Import via DCloud CLI
+```bash
+# Import content type and sample content
+dcloud spaces content-import --file content-type-import.json --preview  # Preview first
+dcloud spaces content-import --file content-type-import.json              # Apply changes
+
+# Generate example if needed
+dcloud spaces content-import --example > content-type-import.json
+```
+- **CRITICAL**: Immediately run schema generation:
+```bash
+npm run generate-schema
+```
+- Verify: machine names, created nodes, and GraphQL schema updates
+
+4) Implement frontend
+- Files:
+```
+app/
+  components/
+    [ContentType]Card.tsx
+    [ContentType]Renderer.tsx
+    DynamicIcon.tsx (optional)
+  [content-type]/page.tsx
+  [...slug]/page.tsx (update)
+lib/
+  queries.ts (update)
+  types.ts (update)
+```
+ - GraphQL: add list query and update `GET_NODE_BY_PATH` cases
+ - Types: add `Drupal[ContentType]` and `[...]Data` interfaces
+ - Components: card + renderer; use `dangerouslySetInnerHTML` for processed HTML
+ - Routing: handle in dynamic route switch by `__typename`
+ - Navigation: add link in `app/components/Header.tsx`; update `navigationItems` and active detection with `pathname.startsWith('/route/')`
+ - DCloud GraphQL fields return simple types (`string`, `string[]`, `bool`, etc.), not `{ processed }` objects — probe schema with a quick query before typing components
+
+5) Build and test
+- `npm run build` → fix TypeScript/build errors
+- `npm run dev` → verify listing and detail views
+- Check URLs: `/[content-type]`, `/[content-type]/[slug]`
+
+Checklist:
+- [ ] DCloud import succeeds
+- [ ] **Schema generation runs (`npm run generate-schema`)**
+- [ ] GraphQL schema exposes fields
+- [ ] Types compile
+- [ ] Build passes
+- [ ] Listing and detail pages render
+- [ ] Navigation works, responsive design verified
+
+# Component Architecture
+- Per type, create `[ContentType]Card.tsx` (listing) and `[ContentType]Renderer.tsx` (detail)
+- Cards: preview data + CTA; Renderers: full display, responsive layout
+- Place components in `app/components/`; listing in `app/[content-type]/page.tsx`; update `app/[...slug]/page.tsx` to route by `__typename`
+
+# Field Types Reference
+- `text` – Rich HTML field
+- `string` – Short text (≤255 chars)
+- `image` – Single image upload
+- `image[]` – Multiple image uploads
+- `datetime` – Date/time
+- `bool` – Boolean
+- `text[]` – Rich HTML list
+- `string[]` – Plain text list (recommended for features/specs)
+
+# Common Patterns
+- Product: `price (string)`, `product_images (image[])`, `in_stock (bool)`, `features (string[])`
+  - Image URI: `{"uri": "${DRUPAL_BASE_URL}/modules/custom/dcloud_import/resources/placeholder.png", "alt": "Product image", "title": "Product"}`
+- Event: `event_date (datetime)`, `location (string)`, `speakers (string[])`
+- Team: `position (string)`, `profile_image (image)`, `bio (text)`
+  - Image URI: `{"uri": "${DRUPAL_BASE_URL}/modules/custom/dcloud_import/resources/placeholder.png", "alt": "Team member photo", "title": "Profile"}`
+- Case Study: `project_url (string)`, `technologies (string[])`, `project_images (image[])`
+  - Image URI: `{"uri": "${DRUPAL_BASE_URL}/modules/custom/dcloud_import/resources/placeholder.png", "alt": "Project screenshot", "title": "Interface"}`
+
+# Troubleshooting
+- DCloud import fails: check OAuth, JSON structure, no `field_` in values
+- **Schema not updated**: ALWAYS run `npm run generate-schema` after DCloud imports
+- GraphQL errors: confirm content type exists, clear GraphQL cache, regenerate schema
+- Build errors: verify types, imports, query syntax
+- Content not showing: confirm field names match GraphQL schema; for HTML use `dangerouslySetInnerHTML={{ __html: field.processed }}`
+- **Field name mismatches**: DCloud field IDs may transform (e.g., `in_stock` → `inStock` in GraphQL)
+
+Debug commands:
+```bash
+dcloud auth status                                          # Check authentication
+dcloud spaces list                                          # List available spaces
+dcloud spaces current                                       # Show default space
+dcloud health check                                         # Platform status
+dcloud spaces content-import --file test.json --preview    # Preview import
+# MOST IMPORTANT: Generate fresh schema after any import
+npm run generate-schema
+# Check schema includes your content type
+grep -i [content_type] schema/schema.graphql
+```
+```
+
+# Best Practices
+1. **ALWAYS run `npm run generate-schema` immediately after DCloud imports**
+2. Create sample content for immediate testing
+3. Prefer `string[]` for simple lists; use `text[]` only when necessary
+4. Verify GraphQL field names against the actual schema (may differ from DCloud field IDs)
+5. Handle empty/missing data gracefully
+6. Keep TypeScript types accurate and complete
+7. Use semantic HTML and ensure responsive design
+8. **Navigation integration**: Update `navigationItems` array and use `.startsWith()` for active detection
+9. **Component architecture**: Create Card + Renderer components per content type
+
+# Success Criteria
+- Builds without errors; routes render correctly; navigation works; responsive; proper fallbacks; follows design patterns; integrates with existing auth and routing.