@nextsparkjs/theme-crm 0.1.0-beta.1 → 0.1.0-beta.100

package/entities/pipelines/api/docs.md

@@ -0,0 +1,145 @@
+# Pipelines API
+
+Manage sales pipelines with customizable stages. Pipelines define the workflow for tracking opportunities from initial contact to close.
+
+## Overview
+
+The Pipelines API allows you to create, read, update, and delete pipeline configurations. Pipelines contain stages that define the sales process and are used by opportunities to track progress.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Pipelines
+`GET /api/v1/pipelines`
+
+Returns a paginated list of pipelines.
+
+**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 (sales, support, project, custom)
+- `isActive` (boolean, optional): Filter by active status
+- `sortBy` (string, optional): Field to sort by
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "pipeline_abc123",
+      "name": "Sales Pipeline",
+      "description": "Main sales process",
+      "type": "sales",
+      "isDefault": true,
+      "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": "closed", "name": "Closed Won", "probability": 100, "order": 4}
+      ],
+      "dealRottenDays": 30,
+      "createdAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 3,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Pipeline
+`GET /api/v1/pipelines/[id]`
+
+Returns a single pipeline by ID.
+
+### Create Pipeline
+`POST /api/v1/pipelines`
+
+Create a new pipeline configuration.
+
+**Request Body:**
+```json
+{
+  "name": "New Sales Pipeline",
+  "description": "Custom sales process",
+  "type": "sales",
+  "isActive": true,
+  "stages": [
+    {"id": "lead", "name": "Lead", "probability": 5, "order": 1},
+    {"id": "qualified", "name": "Qualified", "probability": 25, "order": 2},
+    {"id": "demo", "name": "Demo", "probability": 50, "order": 3},
+    {"id": "proposal", "name": "Proposal", "probability": 75, "order": 4},
+    {"id": "won", "name": "Won", "probability": 100, "order": 5}
+  ],
+  "dealRottenDays": 14
+}
+```
+
+### Update Pipeline
+`PATCH /api/v1/pipelines/[id]`
+
+Update an existing pipeline. Supports partial updates.
+
+### Delete Pipeline
+`DELETE /api/v1/pipelines/[id]`
+
+Delete a pipeline configuration. Note: Cannot delete pipelines with active opportunities.
+
+## Fields
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| name | text | Yes | Pipeline name |
+| description | textarea | No | Pipeline description |
+| type | select | No | Type: sales, support, project, custom |
+| isDefault | boolean | No | Is this the default pipeline |
+| isActive | boolean | No | Is pipeline currently active |
+| stages | json | Yes | Array of stage objects |
+| dealRottenDays | number | No | Days until deal is considered stale |
+| createdAt | datetime | Auto | Creation timestamp |
+| updatedAt | datetime | Auto | Last update timestamp |
+
+## Stage Object Structure
+
+Each stage in the `stages` array should have:
+
+| Property | Type | Description |
+|----------|------|-------------|
+| id | string | Unique stage identifier |
+| name | string | Display name |
+| probability | number | Win probability percentage |
+| order | number | Sort order |
+| color | string | Optional hex color for UI |
+
+## Features
+
+- **Searchable**: name, description
+- **Sortable**: name, type, isDefault, isActive
+
+## 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 - Pipeline doesn't exist |
+| 409 | Conflict - Cannot delete pipeline with active opportunities |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Opportunities](/api/v1/opportunities)** - Deals using this pipeline

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,8 +9,7 @@
  * - Cypress tests (via tests/cypress/src/selectors.ts)
  */
 
-import { createSelectorHelpers } from '@nextsparkjs/core/lib/test/selector-factory'
-import { CORE_SELECTORS } from '@nextsparkjs/core/lib/test/core-selectors'
+import { createSelectorHelpers, CORE_SELECTORS } from '@nextsparkjs/core/selectors'
 
 // =============================================================================
 // BLOCK SELECTORS
@@ -329,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/core/lib/test/selector-factory'
+export type { Replacements } from '@nextsparkjs/core/selectors'
 export { CORE_SELECTORS }

package/package.json

@@ -1,18 +1,23 @@
 {
   "name": "@nextsparkjs/theme-crm",
-  "version": "0.1.0-beta.1",
+  "version": "0.1.0-beta.100",
   "private": false,
   "type": "module",
   "main": "./config/theme.config.ts",
   "requiredPlugins": [],
   "dependencies": {},
   "peerDependencies": {
-    "@nextsparkjs/core": "workspace:*",
+    "@nextsparkjs/core": "*",
+    "@nextsparkjs/testing": "*",
     "lucide-react": "^0.539.0",
     "next": "^15.0.0",
     "next-intl": "^4.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
     "zod": "^4.0.0"
+  },
+  "nextspark": {
+    "type": "theme",
+    "name": "crm"
   }
-}
+}

package/styles/globals.css

@@ -5,10 +5,40 @@
  * 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";
+
+/* =============================================
+   TAILWIND v4 DARK MODE CONFIGURATION
+
+   Por defecto Tailwind v4 usa @media (prefers-color-scheme: dark)
+   para las variantes dark:. Esto causa problemas porque:
+   - next-themes usa la clase .dark en el HTML
+   - El sistema operativo puede tener dark mode aunque la app use light
+
+   Esta configuración hace que Tailwind use el selector de clase .dark
+   en lugar de la media query, sincronizándose con next-themes.
+   ============================================= */
+@custom-variant dark (&:where(.dark, .dark *));
+
+@plugin "@tailwindcss/container-queries";
+@import "@nextsparkjs/core/styles/ui.css";
+@import "@nextsparkjs/core/styles/utilities.css";
+@import "@nextsparkjs/core/styles/docs.css";
+@source "../../../**/*.{js,ts,jsx,tsx}";
+/* Core package: monorepo (short path) + npm projects (long path) */
+@source "../node_modules/@nextsparkjs/core/dist/**/*.js";
+@source "../../../../node_modules/@nextsparkjs/core/dist/**/*.js";
+
 /* ============================================================================
-   Base Design System Variables (Custom Theme Override)
+   CRM THEME - LIGHT MODE
    ============================================================================ */
 
 :root {
@@ -216,7 +246,13 @@
    Base Styles
    ============================================================================ */
 
+* {
+  border-color: var(--border);
+}
+
 body {
+  background-color: var(--background);
+  color: var(--foreground);
   font-feature-settings: "cv02", "cv03", "cv04", "cv11";
 }