@mexty/cli 1.3.0 → 1.4.1

package/BLOCKS_OVERVIEW.md

@@ -0,0 +1,491 @@
+# MEXTY Blocks: Interactive Reusable Components
+
+## What are Blocks?
+
+Blocks are **interactive, reusable, and customizable React components** that can be embedded anywhere. They are the core building blocks of the MEXTY platform, designed to create rich, engaging experiences that can be easily shared and integrated.
+
+## Key Characteristics
+
+### 1. **Interactive**
+
+- Blocks are fully functional React components with state management
+- Support user interactions like clicks, form inputs, animations, and real-time updates
+- Can include complex UI elements like charts, games, quizzes, media players, etc.
+
+### 2. **Reusable**
+
+- Once created, blocks can be used multiple times across different contexts
+- Published blocks can be discovered and used by other users
+- Blocks maintain their functionality regardless of where they're embedded
+
+### 3. **Customizable via Props**
+
+- Blocks accept **props** (properties) that allow customization without code changes
+- Props can be of various types: strings, numbers, booleans, colors, URLs, arrays, objects
+- Users can modify block behavior and appearance through a visual props editor
+
+## Props System
+
+The props system is the heart of block customization:
+
+### Supported Prop Types
+
+- **String**: Text content, labels, descriptions
+- **Number**: Quantities, dimensions, durations
+- **Boolean**: Toggle features on/off
+- **Color**: Theme colors, backgrounds, text colors
+- **Image URL**: Pictures, icons, backgrounds
+- **Video URL**: Video content, tutorials
+- **Audio URL**: Sound effects, music, narration
+- **3D Model URL**: GLB/GLTF files for 3D content
+- **Array**: Lists of items, datasets
+- **Object**: Complex nested configurations
+- **Enum**: Predefined choices (dropdown selections)
+
+### Props Editor Features
+
+- **Visual Interface**: No code required to customize blocks
+- **Real-time Preview**: See changes instantly as you edit props
+- **Media Integration**: Upload files, select from workspace, or use AI generation
+- **Nested Objects**: Support for complex data structures
+- **Array Management**: Add/remove items dynamically
+- **Type Validation**: Ensures props match expected types
+
+## Block Structure
+
+### Core Files
+
+```
+block-repository/
+├── src/
+│   ├── block.tsx          # Main component (receives props)
+│   ├── App.tsx            # Wrapper component
+│   └── index.tsx          # Entry point
+├── package.json           # Dependencies and metadata
+├── webpack.config.js      # Build configuration
+└── index.html            # Development preview
+```
+
+### Example Block Component
+
+```tsx
+interface BlockProps {
+  title: string;
+  color: string;
+  items: Array<{
+    name: string;
+    value: number;
+  }>;
+  showAnimation: boolean;
+}
+
+export default function MyBlock(props: BlockProps) {
+  const { title, color, items, showAnimation } = props;
+
+  return (
+    <div style={{ backgroundColor: color }}>
+      <h1>{title}</h1>
+      {items.map((item, index) => (
+        <div key={index} className={showAnimation ? "animate" : ""}>
+          {item.name}: {item.value}
+        </div>
+      ))}
+    </div>
+  );
+}
+```
+
+## Block Lifecycle
+
+### 1. **Creation**
+
+- Use `mexty create block --name "Block Name" --description "Description" --category "category"`
+- Automatically creates GitHub repository with template
+- Sets up development environment
+
+### 2. **Development**
+
+- Edit `src/block.tsx` to implement functionality
+- Define TypeScript interfaces for props
+- Test locally with `npm start`
+
+### 3. **Publishing**
+
+- Use `mexty save` to commit changes and trigger build
+- System automatically parses props schema from TypeScript interfaces
+- Generates federation bundle for embedding
+
+### 4. **Distribution**
+
+- Blocks can be shared privately or published to marketplace
+- Published blocks become available as named components
+- Can be made insertable by AI agents for automated content creation
+
+## Props Schema Auto-Detection
+
+The system automatically analyzes your block's TypeScript interface to generate a props schema:
+
+```tsx
+interface BlockProps {
+  title: string; // → String input
+  count: number; // → Number input
+  enabled: boolean; // → Toggle switch
+  color: string; // → Color picker (if name contains 'color')
+  imageUrl: string; // → Image selector (if name contains 'image')
+  options: string[]; // → Array of strings
+  config: {
+    // → Nested object
+    theme: "light" | "dark"; // → Enum dropdown
+    size: number;
+  };
+}
+```
+
+## Use Cases
+
+### Educational Content
+
+- Interactive quizzes and assessments
+- Data visualizations and charts
+- Simulations and experiments
+- Progress trackers
+
+### Business Applications
+
+- Product showcases
+- Pricing calculators
+- Contact forms
+- Dashboard widgets
+
+### Entertainment
+
+- Mini-games
+- Interactive stories
+- Media players
+- Social widgets
+
+### Marketing
+
+- Call-to-action buttons
+- Lead generation forms
+- Product demos
+- Testimonial carousels
+
+## Integration Methods
+
+### 1. **Direct Embedding**
+
+```html
+<iframe src="https://mexty.ai/preview.html?blockId=BLOCK_ID"></iframe>
+```
+
+### 2. **React Integration**
+
+```tsx
+import { WeatherWidget } from "@mexty/block";
+
+<WeatherWidget location="Paris" showForecast={true} theme="dark" />;
+```
+
+### 3. **Federation Module**
+
+```javascript
+const RemoteComponent = React.lazy(() => import("FEDERATION_URL"));
+```
+
+## AI Agent Integration
+
+Blocks can be marked as "insertable by agent" which allows AI systems to:
+
+- Automatically select appropriate blocks for content
+- Generate suitable props based on context
+- Insert blocks into courses and pages
+- Customize block behavior for specific use cases
+
+## Best Practices
+
+### Props Design
+
+- Use descriptive prop names that indicate their purpose
+- Provide sensible default values
+- Group related props into objects
+- Use enums for predefined choices
+
+### Component Structure
+
+- Keep components focused and single-purpose
+- Handle loading and error states gracefully
+- Make components responsive and accessible
+- Optimize for performance
+
+### Development Workflow
+
+1. Define props interface first
+2. Implement component logic
+3. Test with various prop combinations
+4. Commit and publish with `mexty save`
+5. Share or publish to marketplace
+
+## CLI Commands
+
+The MEXTY CLI provides a complete toolkit for block development and publishing:
+
+### Installation
+
+```bash
+npm install -g @mexty/cli
+```
+
+### Authentication
+
+```bash
+mexty login
+```
+
+Authenticate with your MEXTY account to access all CLI features.
+
+### Block Creation
+
+```bash
+mexty create block --name "Block Name" --description "Description" --category "category"
+```
+
+- Creates a new block via the API
+- Automatically generates a GitHub repository
+- Clones the repository locally
+- Changes to the block directory
+- Sets up the development environment
+
+**Example:**
+
+```bash
+mexty create block --name "Weather Widget" --description "A beautiful weather display component" --category "widget"
+```
+
+### Development & Saving
+
+```bash
+mexty save
+```
+
+- Stages all changes (`git add .`)
+- Prompts for commit message
+- Commits changes to git
+- Pushes to GitHub
+- Triggers the save-and-bundle process to build the block
+
+### Publishing to Marketplace
+
+```bash
+mexty publish [--agent]
+```
+
+- Builds and bundles the block
+- Publishes to the marketplace (free only via CLI)
+- Makes block discoverable by all users
+- Optional `--agent` flag makes block insertable by AI agents (requires Mext staff permissions)
+
+**Example:**
+
+```bash
+mexty publish --agent
+```
+
+### Block Management
+
+```bash
+mexty delete <blockId>
+```
+
+Deletes a block (requires ownership).
+
+### Command Workflow
+
+1. **Create a new block:**
+
+   ```bash
+   mexty create block --name "My Widget" --description "An awesome widget" --category "utility"
+   ```
+
+2. **Develop your block:**
+
+   - Edit `src/block.tsx` to implement your component
+   - Define TypeScript interfaces for props
+   - Test locally with `npm start`
+
+3. **Save your progress:**
+
+   ```bash
+   mexty save
+   ```
+
+4. **Publish to marketplace:**
+   ```bash
+   mexty publish --agent
+   ```
+
+### CLI Features
+
+- **Automatic GitHub Integration**: Creates and manages repositories
+- **TypeScript Support**: Full TypeScript development environment
+- **Props Schema Detection**: Automatically generates props schema from TypeScript interfaces
+- **Federation Bundling**: Creates optimized bundles for embedding
+- **Marketplace Publishing**: One-command publishing to the marketplace
+- **AI Agent Integration**: Optional agent insertability for automated content creation
+
+This system enables rapid creation of interactive content while maintaining consistency, reusability, and ease of customization for end users.
+
+# @mexty/realtime
+
+React hooks for real-time collaborative features using Yjs and Hocuspocus.
+
+## Installation
+
+```bash
+npm install @mexty/realtime
+```
+
+## Usage
+
+```tsx
+import { useCollabSpace } from "@mexty/realtime";
+
+// 🧠 Example 1: Collaborative JSON document editor
+export function DocumentEditor({ blockId }: { blockId: string }) {
+  const { state, update } = useCollabSpace(`block:${blockId}`, {
+    document: {
+      title: "Untitled",
+      content: "Write something...",
+    },
+    game: { weights: [] },
+  });
+
+  // ✅ Partial update usage
+  const handleTitleChange = (e: React.ChangeEvent<HTMLInputElement>) => {
+    update({ document: { ...state.document, title: e.target.value } });
+  };
+
+  // ✅ Functional update usage
+  const resetContent = () => {
+    update((prev) => ({
+      ...prev,
+      document: { ...prev.document, content: "" },
+    }));
+  };
+
+  return (
+    <div className="p-4 border rounded space-y-3">
+      <h2 className="text-lg font-bold">Collaborative Document</h2>
+      <input
+        type="text"
+        className="border p-2 w-full"
+        value={state.document.title}
+        onChange={handleTitleChange}
+      />
+      <textarea
+        className="border p-2 w-full h-32"
+        value={state.document.content}
+        onChange={(e) =>
+          update({ document: { ...state.document, content: e.target.value } })
+        }
+      />
+      <button
+        onClick={resetContent}
+        className="bg-blue-500 text-white px-3 py-1 rounded"
+      >
+        Reset Content
+      </button>
+    </div>
+  );
+}
+
+// 🧩 Example 2: Multiplayer tower game state
+export function TowerGame({ blockId }: { blockId: string }) {
+  const { state, update } = useCollabSpace(`block:${blockId}`, {
+    document: {},
+    game: { weights: [] as { team: string; pos: number }[] },
+  });
+
+  // ✅ Append new weight (functional update)
+  const addWeight = (team: string) => {
+    update((prev) => ({
+      ...prev,
+      game: {
+        ...prev.game,
+        weights: [...prev.game.weights, { team, pos: Math.random() * 100 }],
+      },
+    }));
+  };
+
+  // ✅ Clear game state (partial update)
+  const resetGame = () => {
+    update({ game: { weights: [] } });
+  };
+
+  return (
+    <div className="p-4 border rounded space-y-3">
+      <h2 className="text-lg font-bold">Tower Game</h2>
+      <button
+        onClick={() => addWeight("blue")}
+        className="bg-blue-600 text-white px-3 py-1 rounded"
+      >
+        Add Blue Weight
+      </button>
+      <button
+        onClick={() => addWeight("red")}
+        className="bg-red-600 text-white px-3 py-1 rounded"
+      >
+        Add Red Weight
+      </button>
+      <button
+        onClick={resetGame}
+        className="bg-gray-600 text-white px-3 py-1 rounded"
+      >
+        Reset Game
+      </button>
+
+      <pre className="bg-gray-100 p-2 text-sm rounded overflow-auto">
+        {JSON.stringify(state.game, null, 2)}
+      </pre>
+    </div>
+  );
+}
+```
+
+## API
+
+### `useCollabSpace(documentName, initialState, options?)`
+
+#### Parameters
+
+- `documentName: string` - Unique identifier for the collaborative document
+- `initialState: T` - Initial state object for the collaborative space
+- `options?: CollabSpaceOptions` - Optional configuration
+
+#### Returns
+
+- `state: T` - Current collaborative state
+- `update: (updateFn: UpdateFunction<T>) => void` - Function to update state
+- `isConnected: boolean` - WebSocket connection status
+- `connectionStatus: 'connecting' | 'connected' | 'disconnected' | 'error'` - Detailed connection status
+- `userId: string` - Anonymous user ID (persisted in localStorage)
+
+#### Options
+
+```tsx
+interface CollabSpaceOptions {
+  websocketUrl?: string;
+  onConnect?: () => void;
+  onDisconnect?: () => void;
+  onError?: (error: Error) => void;
+}
+```
+
+## Features
+
+- 🔄 Real-time collaborative state synchronization
+- 🆔 Anonymous user authentication with persistent IDs
+- 🔗 Automatic WebSocket connection management
+- 📱 React hooks for easy integration
+- 🎯 TypeScript support with full type safety
+- 🏗️ Built on Yjs and Hocuspocus for reliability

package/dist/commands/create.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAOA,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwBD,wBAAsB,aAAa,CACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CA6Hf"}
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAOA,UAAU,aAAa;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwBD,wBAAsB,aAAa,CACjC,UAAU,CAAC,EAAE,MAAM,EACnB,OAAO,GAAE,aAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAiIf"}

package/dist/commands/create.js

@@ -74,17 +74,19 @@ async function createCommand(subcommand, options = {}) {
         // Create the block
         const block = await api_1.apiClient.createBlock(blockData);
         console.log(chalk_1.default.green(`✅ Block created successfully!`));
-        console.log(chalk_1.default.gray(`   Block ID: ${block._id}`));
-        console.log(chalk_1.default.gray(`   Block Type: ${block.blockType}`));
-        if (block.gitUrl) {
-            console.log(chalk_1.default.gray(`   GitHub URL: ${block.gitUrl}`));
+        console.log(chalk_1.default.gray(`   Block ID: ${block.id || block._id}`));
+        console.log(chalk_1.default.gray(`   Block Type: ${block.blockType || block._doc?.blockType}`));
+        // Handle both plain objects and Mongoose documents
+        const gitUrl = block.gitUrl || block._doc?.gitUrl;
+        if (gitUrl) {
+            console.log(chalk_1.default.gray(`   GitHub URL: ${gitUrl}`));
             // Clone the repository
-            const repoName = git_1.GitManager.extractRepoName(block.gitUrl);
+            const repoName = git_1.GitManager.extractRepoName(gitUrl);
             const targetDir = path_1.default.join(process.cwd(), repoName);
             console.log(chalk_1.default.yellow(`📦 Cloning repository to ./${repoName}...`));
             try {
                 const gitManager = new git_1.GitManager();
-                await gitManager.cloneRepository(block.gitUrl, targetDir);
+                await gitManager.cloneRepository(gitUrl, targetDir);
                 console.log(chalk_1.default.green(`🎉 Block created and repository cloned successfully!`));
                 console.log(chalk_1.default.blue(`\nNext steps:`));
                 console.log(chalk_1.default.gray(`  1. cd ${repoName}`));
@@ -103,7 +105,7 @@ async function createCommand(subcommand, options = {}) {
             catch (cloneError) {
                 console.error(chalk_1.default.red(`❌ Failed to clone repository: ${cloneError.message}`));
                 console.log(chalk_1.default.yellow(`You can manually clone it later:`));
-                console.log(chalk_1.default.gray(`  git clone ${block.gitUrl}`));
+                console.log(chalk_1.default.gray(`  git clone ${gitUrl}`));
             }
         }
         else {

package/dist/commands/create.js.map

@@ -1 +1 @@
-{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":";;;;;AAoCA,sCAgIC;AApKD,kDAA0B;AAC1B,gDAAwB;AACxB,sCAA6D;AAC7D,sCAA0C;AAC1C,uCAA2C;AAC3C,wCAA4E;AAS5E,6CAA6C;AAC7C,KAAK,UAAU,MAAM,CACnB,QAAgB,EAChB,YAAqB;IAErB,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;QAC7B,MAAM,EAAE,GAAG,IAAA,0BAAe,EAAC;YACzB,KAAK,EAAE,OAAO,CAAC,KAAK;YACpB,MAAM,EAAE,OAAO,CAAC,MAAM;SACvB,CAAC,CAAC;QAEH,MAAM,UAAU,GAAG,YAAY;YAC7B,CAAC,CAAC,GAAG,QAAQ,KAAK,YAAY,KAAK;YACnC,CAAC,CAAC,GAAG,QAAQ,IAAI,CAAC;QAEpB,EAAE,CAAC,QAAQ,CAAC,UAAU,EAAE,CAAC,MAAM,EAAE,EAAE;YACjC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,YAAY,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;AACL,CAAC;AAEM,KAAK,UAAU,aAAa,CACjC,UAAmB,EACnB,UAAyB,EAAE;IAE3B,IAAI,CAAC;QACH,6BAA6B;QAC7B,IAAA,4BAAqB,GAAE,CAAC;QAExB,MAAM,IAAI,GAAG,IAAA,2BAAoB,GAAE,CAAC;QAEpC,iCAAiC;QACjC,IAAI,SAAiB,CAAC;QACtB,IAAI,gBAAwB,CAAC;QAC7B,IAAI,SAAiB,CAAC;QAEtB,IAAI,UAAU,KAAK,OAAO,EAAE,CAAC;YAC3B,mFAAmF;YACnF,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC;gBAClB,OAAO,CAAC,KAAK,CACX,eAAK,CAAC,GAAG,CAAC,sDAAsD,CAAC,CAClE,CAAC;gBACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CACV,oGAAoG,CACrG,CACF,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;YACzB,gBAAgB,GAAG,OAAO,CAAC,WAAW,IAAI,iBAAiB,SAAS,EAAE,CAAC;YACvE,SAAS,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;QAC3D,CAAC;aAAM,CAAC;YACN,yEAAyE;YACzE,IAAI,CAAC,UAAU,EAAE,CAAC;gBAChB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,0BAA0B,CAAC,CAAC,CAAC;gBACrD,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CAAC,+CAA+C,CAAC,CAC9D,CAAC;gBACF,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CACV,yDAAyD,CAC1D,CACF,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YAED,SAAS,GAAG,UAAU,CAAC;YACvB,gBAAgB,GAAG,OAAO,CAAC,WAAW,IAAI,iBAAiB,SAAS,EAAE,CAAC;YACvE,SAAS,GAAG,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;QACvC,CAAC;QAED,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,0BAA0B,SAAS,EAAE,CAAC,CAAC,CAAC;QAC/D,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,QAAQ,IAAI,IAAI,EAAE,KAAK,IAAI,SAAS,EAAE,CAAC,CACrE,CAAC;QACF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,gBAAgB,SAAS,EAAE,CAAC,CAAC,CAAC;QAErD,qBAAqB;QACrB,MAAM,SAAS,GAAuB;YACpC,SAAS,EAAE,SAAS;YACpB,KAAK,EAAE,SAAS;YAChB,WAAW,EAAE,gBAAgB;YAC7B,iBAAiB,EAAE,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,wBAAwB;YACvF,KAAK,EAAE,CAAC,YAAY,CAAC,EAAE,uCAAuC;YAC9D,OAAO,EAAE,EAAE;SACZ,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,gCAAgC,CAAC,CAAC,CAAC;QAE5D,mBAAmB;QACnB,MAAM,KAAK,GAAG,MAAM,eAAS,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC;QAErD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,+BAA+B,CAAC,CAAC,CAAC;QAC1D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,gBAAgB,KAAK,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC;QACrD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAE7D,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,kBAAkB,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YAE1D,uBAAuB;YACvB,MAAM,QAAQ,GAAG,gBAAU,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;YAC1D,MAAM,SAAS,GAAG,cAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,QAAQ,CAAC,CAAC;YAErD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,8BAA8B,QAAQ,KAAK,CAAC,CAAC,CAAC;YAEvE,IAAI,CAAC;gBACH,MAAM,UAAU,GAAG,IAAI,gBAAU,EAAE,CAAC;gBACpC,MAAM,UAAU,CAAC,eAAe,CAAC,KAAK,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;gBAE1D,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,KAAK,CAAC,sDAAsD,CAAC,CACpE,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC;gBACzC,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,WAAW,QAAQ,EAAE,CAAC,CAAC,CAAC;gBAC/C,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,wBAAwB,CAAC,CAAC,CAAC;gBAClD,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;gBAE3C,iCAAiC;gBACjC,IAAI,CAAC;oBACH,OAAO,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;oBACzB,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,KAAK,CAAC,4BAA4B,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACnE,CAAC;gBAAC,OAAO,UAAe,EAAE,CAAC;oBACzB,OAAO,CAAC,IAAI,CACV,eAAK,CAAC,MAAM,CACV,sCAAsC,UAAU,CAAC,OAAO,EAAE,CAC3D,CACF,CAAC;oBACF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,8BAA8B,QAAQ,EAAE,CAAC,CAAC,CAAC;gBACpE,CAAC;YACH,CAAC;YAAC,OAAO,UAAe,EAAE,CAAC;gBACzB,OAAO,CAAC,KAAK,CACX,eAAK,CAAC,GAAG,CAAC,iCAAiC,UAAU,CAAC,OAAO,EAAE,CAAC,CACjE,CAAC;gBACF,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,MAAM,CAAC,kCAAkC,CAAC,CAAC,CAAC;gBAC9D,OAAO,CAAC,GAAG,CAAC,eAAK,CAAC,IAAI,CAAC,eAAe,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;YACzD,CAAC;QACH,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,GAAG,CACT,eAAK,CAAC,MAAM,CACV,8DAA8D,CAC/D,CACF,CAAC;QACJ,CAAC;IACH,CAAC;IAAC,OAAO,KAAU,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CAAC,eAAK,CAAC,GAAG,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;QACvE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC"}
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"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"}

package/dist/commands/publish.d.ts

@@ -1,2 +1,6 @@
-export declare function publishCommand(): Promise<void>;
+interface PublishOptions {
+    agent?: boolean;
+}
+export declare function publishCommand(options?: PublishOptions): Promise<void>;
+export {};
 //# sourceMappingURL=publish.d.ts.map

package/dist/commands/publish.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAmEA,wBAAsB,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CA2FpD"}
+{"version":3,"file":"publish.d.ts","sourceRoot":"","sources":["../../src/commands/publish.ts"],"names":[],"mappings":"AAmEA,UAAU,cAAc;IACtB,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,wBAAsB,cAAc,CAAC,OAAO,GAAE,cAAmB,GAAG,OAAO,CAAC,IAAI,CAAC,CA6HhF"}

package/dist/commands/publish.js

@@ -10,7 +10,7 @@ const path_1 = __importDefault(require("path"));
 const api_1 = require("../utils/api");
 const git_1 = require("../utils/git");
 const readline_1 = require("readline");
-const sync_1 = require("./sync");
+// Removed sync command import as it's been deleted
 const auth_1 = require("../utils/auth");
 // Simple confirmation function
 async function confirm(question) {
@@ -63,13 +63,14 @@ async function findBlockId() {
     }
     return null;
 }
-async function publishCommand() {
+async function publishCommand(options = {}) {
     try {
         // Check authentication first
         (0, auth_1.requireAuthentication)();
         const user = (0, auth_1.getAuthenticatedUser)();
-        console.log(chalk_1.default.blue('🚀 Publishing block...'));
+        console.log(chalk_1.default.blue('🚀 Publishing block to marketplace...'));
         console.log(chalk_1.default.gray(`   User: ${user?.fullName || user?.email || 'Unknown'}`));
+        console.log(chalk_1.default.gray(`   Agent insertable: ${options.agent ? 'Yes' : 'No'}`));
         // Check if we're in a git repository
         const gitManager = new git_1.GitManager();
         const isGitRepo = await gitManager.isGitRepository();
@@ -112,23 +113,51 @@ async function publishCommand() {
         console.log(chalk_1.default.yellow('📡 Triggering build and bundle process...'));
         try {
             const result = await api_1.apiClient.saveAndBundle({ blockId });
-            console.log(chalk_1.default.green('✅ Block published successfully!'));
+            console.log(chalk_1.default.green('✅ Block bundled successfully!'));
             console.log(chalk_1.default.gray(`   Bundle Path: ${result.bundlePath}`));
             console.log(chalk_1.default.gray(`   Federation URL: ${result.federationUrl}`));
             if (result.message) {
                 console.log(chalk_1.default.blue(`   ${result.message}`));
             }
-            // Automatically sync registry after successful publish
-            console.log(chalk_1.default.blue('\n🔄 Auto-syncing registry...'));
+            // Update sharing scope to publish to marketplace (free only)
+            console.log(chalk_1.default.blue('\n🌐 Publishing to marketplace...'));
             try {
-                await (0, sync_1.syncCommand)();
-                console.log(chalk_1.default.green('✅ Registry synced! Your block is now available as a named component.'));
+                // Get current block to check existing scope
+                const block = await api_1.apiClient.getBlock(blockId);
+                const currentScope = block?.scope || ['user-store'];
+                // Add published-store to scope if not already present
+                const newScope = [...new Set([...currentScope, 'user-store', 'published-store'])];
+                await api_1.apiClient.updateBlockSharing(blockId, newScope);
+                console.log(chalk_1.default.green('✅ Block published to marketplace (free)'));
+                // Update agent insertability if requested
+                if (options.agent) {
+                    console.log(chalk_1.default.blue('🤖 Making block insertable by AI agents...'));
+                    try {
+                        await api_1.apiClient.updateBlockAgentInsertable(blockId, true);
+                        console.log(chalk_1.default.green('✅ Block is now insertable by AI agents'));
+                    }
+                    catch (agentError) {
+                        // This might fail if user is not Mext staff, but that's okay
+                        console.log(chalk_1.default.yellow('⚠️  Could not set agent insertability (requires Mext staff permissions)'));
+                        console.log(chalk_1.default.gray(`   Error: ${agentError.message || 'Permission denied'}`));
+                    }
+                }
+            }
+            catch (sharingError) {
+                console.error(chalk_1.default.red('❌ Failed to publish to marketplace:'), sharingError.message);
+                console.log(chalk_1.default.yellow('   Block was built successfully but not published to marketplace.'));
+                console.log(chalk_1.default.gray('   You can try publishing again or contact support.'));
+                return;
             }
-            catch (syncError) {
-                console.warn(chalk_1.default.yellow(`⚠️ Registry sync failed: ${syncError.message}`));
-                console.log(chalk_1.default.gray('   You can manually sync later with: mexty sync'));
-                // Don't fail the publish if sync fails - it's not critical
+            // Success message
+            console.log(chalk_1.default.green('\n🎉 Block published to marketplace successfully!'));
+            console.log(chalk_1.default.blue('Your block is now:'));
+            console.log(chalk_1.default.gray('  ✓ Available for free download by anyone'));
+            console.log(chalk_1.default.gray('  ✓ Discoverable in the marketplace'));
+            if (options.agent) {
+                console.log(chalk_1.default.gray('  ✓ Insertable by AI agents (if you have permissions)'));
             }
+            console.log(chalk_1.default.gray(`  ✓ Viewable at: https://mexty.ai/preview.html?blockId=${blockId}`));
         }
         catch (buildError) {
             console.error(chalk_1.default.red(`❌ Build failed: ${buildError.message}`));