@nextsparkjs/theme-crm 0.1.0-beta.44 → 0.1.0-beta.46

package/entities/pipelines/api/presets.ts

@@ -0,0 +1,118 @@
+/**
+ * API Presets for Pipelines Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage sales pipelines with customizable stages',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Pipelines',
+      description: 'Get all pipelines',
+      method: 'GET',
+      params: {
+        limit: 20
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-active',
+      title: 'List Active Pipelines',
+      description: 'Get all active pipelines',
+      method: 'GET',
+      params: {
+        isActive: 'true'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-type',
+      title: 'List by Type',
+      description: 'Get pipelines of a specific type',
+      method: 'GET',
+      params: {
+        type: '{{type}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'get-default',
+      title: 'Get Default Pipeline',
+      description: 'Get the default pipeline',
+      method: 'GET',
+      params: {
+        isDefault: 'true'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'create-sales-pipeline',
+      title: 'Create Sales Pipeline',
+      description: 'Create a new sales pipeline with default stages',
+      method: 'POST',
+      payload: {
+        name: 'Sales Pipeline',
+        type: 'sales',
+        isActive: true,
+        stages: [
+          { id: 'discovery', name: 'Discovery', probability: 10, order: 1 },
+          { id: 'proposal', name: 'Proposal', probability: 30, order: 2 },
+          { id: 'negotiation', name: 'Negotiation', probability: 60, order: 3 },
+          { id: 'won', name: 'Won', probability: 100, order: 4 }
+        ]
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-stages',
+      title: 'Update Stages',
+      description: 'Update the stages of a pipeline',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        stages: '{{stages}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'set-default',
+      title: 'Set as Default',
+      description: 'Set a pipeline as the default',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        isDefault: true
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'deactivate',
+      title: 'Deactivate Pipeline',
+      description: 'Deactivate a pipeline',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        isActive: false
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-pipeline',
+      title: 'Delete Pipeline',
+      description: 'Delete a pipeline',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

package/entities/products/api/docs.md

@@ -0,0 +1,137 @@
+# Products API
+
+Manage products and services catalog. Products can be referenced in opportunities and quotes with pricing, commission rates, and categorization.
+
+## Overview
+
+The Products API allows you to create, read, update, and delete product records. Products represent the items and services your team sells and can be linked to opportunities.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Products
+`GET /api/v1/products`
+
+Returns a paginated list of products.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `type` (string, optional): Filter by type (product, service, subscription, bundle, addon)
+- `isActive` (boolean, optional): Filter by active status
+- `search` (string, optional): Search by code, name, category
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "product_abc123",
+      "code": "PRD-001",
+      "name": "Enterprise License",
+      "category": "Software",
+      "type": "subscription",
+      "description": "Annual enterprise software license",
+      "price": 5000,
+      "cost": 1000,
+      "currency": "USD",
+      "unit": "year",
+      "isActive": true,
+      "commissionRate": 10,
+      "createdAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 45,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Product
+`GET /api/v1/products/[id]`
+
+Returns a single product by ID.
+
+### Create Product
+`POST /api/v1/products`
+
+Create a new product record.
+
+**Request Body:**
+```json
+{
+  "code": "SVC-002",
+  "name": "Consulting Services",
+  "category": "Services",
+  "type": "service",
+  "description": "Professional consulting services",
+  "price": 150,
+  "currency": "USD",
+  "unit": "hour",
+  "isActive": true
+}
+```
+
+### Update Product
+`PATCH /api/v1/products/[id]`
+
+Update an existing product. Supports partial updates.
+
+### Delete Product
+`DELETE /api/v1/products/[id]`
+
+Delete a product record.
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| code | text | Yes | Product code or SKU |
+| name | text | Yes | Product name |
+| category | text | No | Product category |
+| type | select | No | Type: product, service, subscription, bundle, addon |
+| description | textarea | No | Product description |
+| price | number | Yes | Standard selling price |
+| cost | number | No | Product cost |
+| currency | select | No | Currency: USD, EUR, GBP, MXN, etc. |
+| unit | select | No | Unit: piece, hour, day, week, month, year, kg, lb, meter, foot, license, user |
+| isActive | boolean | No | Is product currently active |
+| minimumQuantity | number | No | Minimum order quantity |
+| image | url | No | Product image URL |
+| brochureUrl | url | No | Product brochure URL |
+| commissionRate | number | No | Sales commission percentage |
+| createdAt | datetime | Auto | Creation timestamp |
+| updatedAt | datetime | Auto | Last update timestamp |
+
+## Features
+
+- **Searchable**: code, name, category, description
+- **Sortable**: Most fields
+- **Metadata**: Supported
+
+## Permissions
+
+- **Create/Update/Delete**: Owner only
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions (owner only) |
+| 404 | Not Found - Product doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Opportunities](/api/v1/opportunities)** - Link products to deals

package/entities/products/api/presets.ts

@@ -0,0 +1,132 @@
+/**
+ * API Presets for Products Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage products and services catalog',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Products',
+      description: 'Get all products with pagination',
+      method: 'GET',
+      params: {
+        limit: 20
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-active',
+      title: 'List Active Products',
+      description: 'Get all active products',
+      method: 'GET',
+      params: {
+        isActive: 'true'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-type',
+      title: 'List by Type',
+      description: 'Get products of a specific type',
+      method: 'GET',
+      params: {
+        type: '{{type}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-subscriptions',
+      title: 'List Subscriptions',
+      description: 'Get all subscription products',
+      method: 'GET',
+      params: {
+        type: 'subscription'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-services',
+      title: 'List Services',
+      description: 'Get all service products',
+      method: 'GET',
+      params: {
+        type: 'service'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'search-by-name',
+      title: 'Search by Name',
+      description: 'Search products by name',
+      method: 'GET',
+      params: {
+        search: '{{name}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'search-by-code',
+      title: 'Search by Code',
+      description: 'Search products by code/SKU',
+      method: 'GET',
+      params: {
+        search: '{{code}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-product',
+      title: 'Create Product',
+      description: 'Create a new product',
+      method: 'POST',
+      payload: {
+        code: 'PRD-NEW',
+        name: 'New Product',
+        type: 'product',
+        price: 100,
+        currency: 'USD',
+        isActive: true
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-price',
+      title: 'Update Price',
+      description: 'Update product pricing',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        price: '{{newPrice}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'deactivate',
+      title: 'Deactivate Product',
+      description: 'Deactivate a product',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        isActive: false
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-product',
+      title: 'Delete Product',
+      description: 'Delete a product record',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

package/lib/selectors.ts

@@ -9,7 +9,7 @@
  * - Cypress tests (via tests/cypress/src/selectors.ts)
  */
 
-import { createSelectorHelpers, CORE_SELECTORS } from '@nextsparkjs/testing/selectors'
+import { createSelectorHelpers, CORE_SELECTORS } from '@nextsparkjs/core/selectors'
 
 // =============================================================================
 // BLOCK SELECTORS
@@ -328,5 +328,5 @@ export type ThemeSelectorsType = typeof THEME_SELECTORS
 export type BlockSelectorsType = typeof BLOCK_SELECTORS
 export type EntitySelectorsType = typeof ENTITY_SELECTORS
 export type CRMSelectorsType = typeof CRM_SELECTORS
-export type { Replacements } from '@nextsparkjs/testing/selectors'
+export type { Replacements } from '@nextsparkjs/core/selectors'
 export { CORE_SELECTORS }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nextsparkjs/theme-crm",
-  "version": "0.1.0-beta.44",
+  "version": "0.1.0-beta.46",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
@@ -13,8 +13,8 @@
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zod": "^4.0.0",
-    "@nextsparkjs/core": "0.1.0-beta.44",
-    "@nextsparkjs/testing": "0.1.0-beta.44"
+    "@nextsparkjs/core": "0.1.0-beta.46",
+    "@nextsparkjs/testing": "0.1.0-beta.46"
   },
   "nextspark": {
     "type": "theme",

package/styles/globals.css

@@ -5,10 +5,22 @@
  * Clean interface with emphasis on data visualization.
  *
  * Design System: Purple/Violet primary, Plus Jakarta Sans typography
+ *
+ * ÚNICA FUENTE DE VERDAD para estilos del theme.
+ * Editar este archivo para customizar el design system.
  */
 
+/* =============================================
+   IMPORTS
+   ============================================= */
+@import "tailwindcss";
+@import "@nextsparkjs/core/styles/ui.css";
+@import "@nextsparkjs/core/styles/utilities.css";
+@import "@nextsparkjs/core/styles/docs.css";
+@source "../../../**/*.{js,ts,jsx,tsx}";
+
 /* ============================================================================
-   Base Design System Variables (Custom Theme Override)
+   CRM THEME - LIGHT MODE
    ============================================================================ */
 
 :root {
@@ -216,7 +228,13 @@
    Base Styles
    ============================================================================ */
 
+* {
+  border-color: var(--border);
+}
+
 body {
+  background-color: var(--background);
+  color: var(--foreground);
   font-feature-settings: "cv02", "cv03", "cv04", "cv11";
 }