@nextsparkjs/theme-productivity 0.1.0-beta.17 → 0.1.0-beta.171

package/config/app.config.ts

@@ -58,11 +58,10 @@ export const APP_CONFIG_OVERRIDES = {
   // =============================================================================
   api: {
     cors: {
-      allowedOrigins: {
-        development: [
-          'http://localhost:3000',
-          'http://localhost:5173',
-        ],
+      // Theme-specific CORS origins (extends core defaults, does not replace)
+      // No additional origins needed for productivity theme - uses core defaults
+      additionalOrigins: {
+        development: [],
         production: [],
       },
     },

package/config/billing.config.ts

@@ -103,8 +103,7 @@ export const billingConfig: BillingConfig = {
         api_calls: 1000,
         storage_gb: 2,
       },
-      stripePriceIdMonthly: null,
-      stripePriceIdYearly: null,
+      providerPriceIds: { monthly: null, yearly: null },
     },
     {
       slug: 'pro',
@@ -132,9 +131,8 @@ export const billingConfig: BillingConfig = {
         api_calls: 100000,
         storage_gb: 50,
       },
-      // Configure these in Stripe Dashboard
-      stripePriceIdMonthly: 'price_productivity_pro_monthly',
-      stripePriceIdYearly: 'price_productivity_pro_yearly',
+      // Configure price IDs in your payment provider dashboard
+      providerPriceIds: { monthly: 'price_productivity_pro_monthly', yearly: 'price_productivity_pro_yearly' },
     },
     {
       slug: 'enterprise',
@@ -152,8 +150,7 @@ export const billingConfig: BillingConfig = {
         api_calls: -1,
         storage_gb: -1,
       },
-      stripePriceIdMonthly: null,
-      stripePriceIdYearly: null,
+      providerPriceIds: { monthly: null, yearly: null },
     },
   ],
 

package/config/dashboard.config.ts

@@ -53,6 +53,19 @@ export const DASHBOARD_CONFIG = {
     devtoolsAccess: {
       enabled: true,
     },
+    /**
+     * Settings menu dropdown (gear icon)
+     */
+    settingsMenu: {
+      enabled: true,
+      links: [
+        {
+          label: 'navigation.patterns',
+          href: '/dashboard/patterns',
+          icon: 'layers',
+        },
+      ],
+    },
     userMenu: {
       enabled: true,
       showAvatar: true,

package/config/permissions.config.ts

@@ -82,6 +82,17 @@ export const PERMISSIONS_CONFIG_OVERRIDES: ThemePermissionsConfig = {
       { action: 'update', label: 'Edit cards', description: 'Can modify card information', roles: ['owner', 'admin', 'member'] },
       { action: 'delete', label: 'Delete cards', description: 'Can delete cards', roles: ['owner', 'admin'], dangerous: true },
     ],
+
+    // ------------------------------------------
+    // PATTERNS
+    // ------------------------------------------
+    patterns: [
+      { action: 'create', label: 'Create Patterns', description: 'Can create reusable patterns', roles: ['owner', 'admin'] },
+      { action: 'read', label: 'View Patterns', description: 'Can view pattern details', roles: ['owner', 'admin', 'member'] },
+      { action: 'list', label: 'List Patterns', description: 'Can see the patterns list', roles: ['owner', 'admin', 'member'] },
+      { action: 'update', label: 'Edit Patterns', description: 'Can modify patterns', roles: ['owner', 'admin'] },
+      { action: 'delete', label: 'Delete Patterns', description: 'Can delete patterns', roles: ['owner', 'admin'], dangerous: true },
+    ],
   },
 
   // ==========================================

package/entities/boards/api/docs.md

@@ -0,0 +1,131 @@
+# Boards API
+
+Manage Trello-style boards for organizing lists and cards.
+
+## Overview
+
+The Boards API allows you to create, read, update, and archive board records. Boards are the top-level containers for organizing lists and cards in a Kanban-style workflow.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Boards
+`GET /api/v1/boards`
+
+Returns a paginated list of boards.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `archived` (boolean, optional): Filter by archived status
+- `search` (string, optional): Search by name, description
+- `sortBy` (string, optional): Field to sort by. Default: position
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "board_abc123",
+      "name": "Product Development",
+      "description": "Main product roadmap and feature tracking",
+      "color": "blue",
+      "archived": false,
+      "position": 1,
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 5,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Board
+`GET /api/v1/boards/[id]`
+
+Returns a single board by ID.
+
+### Create Board
+`POST /api/v1/boards`
+
+Create a new board.
+
+**Request Body:**
+```json
+{
+  "name": "New Project",
+  "description": "Board for tracking new project tasks",
+  "color": "purple"
+}
+```
+
+### Update Board
+`PATCH /api/v1/boards/[id]`
+
+Update an existing board. Supports partial updates.
+
+### Archive Board
+`PATCH /api/v1/boards/[id]`
+
+Archive a board (soft delete).
+
+**Request Body:**
+```json
+{
+  "archived": true
+}
+```
+
+### Delete Board
+`DELETE /api/v1/boards/[id]`
+
+Permanently delete a board. This will also delete all associated lists and cards.
+
+## Fields
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| name | text | Yes | - | Board name |
+| description | textarea | No | - | Board description |
+| color | select | No | blue | Background color (blue, green, purple, orange, red, pink, gray) |
+| archived | boolean | No | false | Whether board is archived |
+| position | number | No | 0 | Display order |
+| createdAt | datetime | Auto | - | Creation timestamp |
+| updatedAt | datetime | Auto | - | Last update timestamp |
+
+## Features
+
+- **Searchable**: name, description
+- **Sortable**: name, position, createdAt
+- **Shared Access**: Boards are shared within the team
+- **Soft Delete**: Use archive instead of permanent delete
+
+## Permissions
+
+- **Create/Update**: Owner, Admin
+- **Delete**: Owner only
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Board doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Lists](/api/v1/lists)** - Lists within boards
+- **[Cards](/api/v1/cards)** - Cards within lists

package/entities/boards/api/presets.ts

@@ -0,0 +1,113 @@
+/**
+ * API Presets for Boards Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage kanban boards for task organization',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Boards',
+      description: 'Get all boards with pagination',
+      method: 'GET',
+      params: {
+        limit: 20
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-active',
+      title: 'List Active Boards',
+      description: 'Get all non-archived boards',
+      method: 'GET',
+      params: {
+        archived: 'false'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-archived',
+      title: 'List Archived Boards',
+      description: 'Get all archived boards',
+      method: 'GET',
+      params: {
+        archived: 'true'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'search-by-name',
+      title: 'Search by Name',
+      description: 'Search boards by name',
+      method: 'GET',
+      params: {
+        search: '{{name}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-board',
+      title: 'Create Board',
+      description: 'Create a new board',
+      method: 'POST',
+      payload: {
+        name: 'New Board',
+        description: 'Board description',
+        color: 'blue'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-board',
+      title: 'Update Board',
+      description: 'Update an existing board',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        name: '{{name}}',
+        description: '{{description}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'archive-board',
+      title: 'Archive Board',
+      description: 'Archive a board',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        archived: true
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'restore-board',
+      title: 'Restore Board',
+      description: 'Restore an archived board',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        archived: false
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-board',
+      title: 'Delete Board',
+      description: 'Permanently delete a board',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})

package/entities/cards/api/docs.md

@@ -0,0 +1,162 @@
+# Cards API
+
+Manage task cards within lists (the main work items).
+
+## Overview
+
+The Cards API allows you to create, read, update, and delete card records. Cards are the individual task items that can be dragged between lists within a board.
+
+## Authentication
+
+All endpoints require authentication via:
+- **Session cookie** (for browser-based requests)
+- **API Key** header (for server-to-server requests)
+
+## Endpoints
+
+### List Cards
+`GET /api/v1/cards`
+
+Returns a paginated list of cards.
+
+**Query Parameters:**
+- `limit` (number, optional): Maximum records to return. Default: 20
+- `offset` (number, optional): Number of records to skip. Default: 0
+- `listId` (string, optional): Filter by parent list
+- `boardId` (string, optional): Filter by parent board
+- `priority` (string, optional): Filter by priority (low, medium, high, urgent)
+- `assigneeId` (string, optional): Filter by assigned user
+- `search` (string, optional): Search by title, description
+- `sortBy` (string, optional): Field to sort by. Default: position
+- `sortOrder` (string, optional): Sort direction (asc, desc)
+
+**Example Response:**
+```json
+{
+  "data": [
+    {
+      "id": "card_abc123",
+      "title": "Implement user authentication",
+      "description": "Add login and registration functionality",
+      "position": 1,
+      "dueDate": "2024-02-01",
+      "priority": "high",
+      "labels": ["feature", "urgent"],
+      "assigneeId": "user_456",
+      "listId": "list_xyz",
+      "boardId": "board_abc",
+      "createdAt": "2024-01-15T10:30:00Z",
+      "updatedAt": "2024-01-15T10:30:00Z"
+    }
+  ],
+  "pagination": {
+    "total": 15,
+    "limit": 20,
+    "offset": 0
+  }
+}
+```
+
+### Get Single Card
+`GET /api/v1/cards/[id]`
+
+Returns a single card by ID.
+
+### Create Card
+`POST /api/v1/cards`
+
+Create a new card.
+
+**Request Body:**
+```json
+{
+  "title": "New Feature Request",
+  "description": "Detailed description of the feature",
+  "listId": "list_xyz789",
+  "boardId": "board_abc123",
+  "priority": "medium",
+  "dueDate": "2024-02-15",
+  "assigneeId": "user_456"
+}
+```
+
+### Update Card
+`PATCH /api/v1/cards/[id]`
+
+Update an existing card. Supports partial updates.
+
+### Move Card
+`PATCH /api/v1/cards/[id]`
+
+Move a card to a different list (drag & drop).
+
+**Request Body:**
+```json
+{
+  "listId": "list_newlist",
+  "position": 3
+}
+```
+
+### Delete Card
+`DELETE /api/v1/cards/[id]`
+
+Delete a card.
+
+## Fields
+
+| Field | Type | Required | Default | Description |
+|-------|------|----------|---------|-------------|
+| title | text | Yes | - | Card title |
+| description | textarea | No | - | Detailed description |
+| position | number | No | 0 | Display order within list |
+| dueDate | date | No | - | Due date |
+| priority | select | No | - | Priority: low, medium, high, urgent |
+| labels | multiselect | No | - | Labels: urgent, important, bug, feature, enhancement, documentation |
+| assigneeId | reference | No | - | Assigned user ID |
+| listId | reference | Yes | - | Parent list ID |
+| boardId | reference | Yes | - | Parent board ID |
+| createdAt | datetime | Auto | - | Creation timestamp |
+| updatedAt | datetime | Auto | - | Last update timestamp |
+
+## Labels
+
+Cards can have multiple labels for categorization:
+
+| Label | Description |
+|-------|-------------|
+| urgent | Needs immediate attention |
+| important | High importance |
+| bug | Bug fix needed |
+| feature | New feature |
+| enhancement | Improvement to existing feature |
+| documentation | Documentation work |
+
+## Features
+
+- **Searchable**: title, description
+- **Sortable**: title, position, dueDate, priority, createdAt
+- **Filterable**: priority, labels
+- **Drag & Drop**: Move between lists
+- **Bulk Operations**: Supported
+- **Shared Access**: Cards are shared within the team
+
+## Permissions
+
+- **Create/Update/Move**: Owner, Admin, Member
+- **Delete**: Owner, Admin
+
+## Error Responses
+
+| Status | Description |
+|--------|-------------|
+| 400 | Bad Request - Invalid parameters |
+| 401 | Unauthorized - Missing or invalid auth |
+| 403 | Forbidden - Insufficient permissions |
+| 404 | Not Found - Card, List, or Board doesn't exist |
+| 422 | Validation Error - Invalid data |
+
+## Related APIs
+
+- **[Boards](/api/v1/boards)** - Parent boards
+- **[Lists](/api/v1/lists)** - Parent lists

package/entities/cards/api/presets.ts

@@ -0,0 +1,172 @@
+/**
+ * API Presets for Cards Entity
+ */
+
+import { defineApiEndpoint } from '@nextsparkjs/core/types/api-presets'
+
+export default defineApiEndpoint({
+  summary: 'Manage kanban cards (tasks) with priorities and assignments',
+  presets: [
+    {
+      id: 'list-all',
+      title: 'List All Cards',
+      description: 'Get all cards with pagination',
+      method: 'GET',
+      params: {
+        limit: 50
+      },
+      tags: ['read', 'list']
+    },
+    {
+      id: 'list-by-list',
+      title: 'List by List',
+      description: 'Get all cards for a specific list',
+      method: 'GET',
+      params: {
+        listId: '{{listId}}',
+        sortBy: 'position',
+        sortOrder: 'asc'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-board',
+      title: 'List by Board',
+      description: 'Get all cards for a specific board',
+      method: 'GET',
+      params: {
+        boardId: '{{boardId}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-my-cards',
+      title: 'List My Cards',
+      description: 'Get cards assigned to current user',
+      method: 'GET',
+      params: {
+        assigneeId: '{{userId}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-urgent',
+      title: 'List Urgent Cards',
+      description: 'Get all urgent priority cards',
+      method: 'GET',
+      params: {
+        priority: 'urgent'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'list-by-priority',
+      title: 'List by Priority',
+      description: 'Get cards filtered by priority level',
+      method: 'GET',
+      params: {
+        priority: '{{priority}}'
+      },
+      tags: ['read', 'filter']
+    },
+    {
+      id: 'search-by-title',
+      title: 'Search by Title',
+      description: 'Search cards by title',
+      method: 'GET',
+      params: {
+        search: '{{title}}'
+      },
+      tags: ['read', 'search']
+    },
+    {
+      id: 'create-card',
+      title: 'Create Card',
+      description: 'Create a new card in a list',
+      method: 'POST',
+      payload: {
+        title: 'New Card',
+        listId: '{{listId}}',
+        boardId: '{{boardId}}'
+      },
+      tags: ['write', 'create']
+    },
+    {
+      id: 'update-card',
+      title: 'Update Card',
+      description: 'Update card title and description',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        title: '{{title}}',
+        description: '{{description}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'move-card',
+      title: 'Move Card',
+      description: 'Move card to a different list',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        listId: '{{newListId}}',
+        position: '{{position}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'set-priority',
+      title: 'Set Priority',
+      description: 'Update card priority level',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        priority: '{{priority}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'assign-card',
+      title: 'Assign Card',
+      description: 'Assign card to a team member',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        assigneeId: '{{userId}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'set-due-date',
+      title: 'Set Due Date',
+      description: 'Set or update card due date',
+      method: 'PATCH',
+      pathParams: {
+        id: '{{id}}'
+      },
+      payload: {
+        dueDate: '{{dueDate}}'
+      },
+      tags: ['write', 'update']
+    },
+    {
+      id: 'delete-card',
+      title: 'Delete Card',
+      description: 'Delete a card',
+      method: 'DELETE',
+      pathParams: {
+        id: '{{id}}'
+      },
+      tags: ['write', 'delete']
+    }
+  ]
+})