@breadstone-infrastructure/prisma-seeds 0.0.231

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+## 0.0.231 (2026-03-14)
+
+### 🚀 Features
+
+- **cli:** integrate CliParser for improved argument parsing and build scripts ([23b1773dce](https://github.com/RueDeRennes/mosaik/commit/23b1773dce))
+- **cli:** implement Prisma Seeds CLI with argument configuration and commands ([d7d3ab6ff9](https://github.com/RueDeRennes/mosaik/commit/d7d3ab6ff9))
+- **buttons): add ripple prop to button components and related updates feat(components): implement ripple behavior in various components fix(theme:** remove duplicate ripple property in theme JSON files ([d31f695f82](https://github.com/RueDeRennes/mosaik/commit/d31f695f82))
+- **McpToolRegistrar): add overview and framework guide tools with enhanced descriptions feat(package:** update dependencies across multiple packages to latest versions ([45bc8fb4f6](https://github.com/RueDeRennes/mosaik/commit/45bc8fb4f6))
+- **Button, Banner:** add shadow properties and update related styles and tokens ([5d69398b19](https://github.com/RueDeRennes/mosaik/commit/5d69398b19))

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Breadstone
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,284 @@
+# @strivio/prisma-seeds
+
+Database seeding framework for Prisma with JSON-based data loading.
+
+## Quick Start
+
+```bash
+# Populate database
+yarn nx run api:db:seed
+
+# Reset and re-populate
+yarn nx run api:db:reset
+```
+
+## Documentation
+
+📖 **Full documentation:** [`docs/infrastructure/prisma-seeds.md`](../../docs/infrastructure/prisma-seeds.md)
+
+Topics covered:
+- JSON-based seeding architecture
+- Validation and schema definitions
+- Multi-language support
+- Asset management
+- Relationship handling
+
+## Development
+
+```bash
+# Build
+yarn nx build prisma-seeds
+
+# Test
+yarn nx test prisma-seeds
+
+# Lint
+yarn nx lint prisma-seeds
+```
+
+## Project Structure
+
+```
+libs/backend/features/[feature]/
+├── seed.config.mjs         # Configuration
+└── .seed/
+    ├── data/               # JSON content files
+    │   └── items.json
+    ├── schemas/            # Validation rules (optional)
+    │   └── item.schema.json
+    └── assets/             # Images and media
+        └── images/
+```
+
+## Example: Products
+
+**Data File** (`.seed/data/products.json`):
+```json
+{
+  "products": [
+    {
+      "id": "prod-001",
+      "name": {
+        "en": "Protein Powder",
+        "de": "Protein Pulver"
+      },
+      "price": 49.99,
+      "category": "supplements",
+      "image": "@asset:protein-powder"
+    }
+  ]
+}
+```
+
+**Result:**
+- Product created in database
+- Name available in English and German
+- Image uploaded to cloud storage
+- Linked to supplements category
+
+## Documentation
+
+Complete guides available in `/docs/seeding/`:
+
+### Getting Started
+- **[Getting Started](../../docs/seeding/getting-started.md)** - Create your first seed configuration
+- **[JSON Seeding](../../docs/seeding/json-seeding.md)** - Structure your JSON data files
+
+### Features
+- **[Asset Management](../../docs/seeding/asset-management.md)** - Handle images and media
+- **[Localization](../../docs/seeding/localization.md)** - Multi-language content
+
+### Best Practices
+- **[Best Practices](../../docs/seeding/best-practices.md)** - Patterns and conventions
+- **[Examples](../../docs/seeding/examples/)** - Real-world implementations
+
+## Common Use Cases
+
+### Initial Setup
+Populate database with essential data:
+- User authentication
+- Categories and tags
+- Reference data
+
+### Content Updates
+Deploy new or updated content:
+- New exercises
+- Updated recipes
+- Fresh tips
+
+### Development
+Create test data:
+- Sample users
+- Example workouts
+- Test products
+
+## Configuration
+
+Each feature defines its own seeding:
+
+**Basic Configuration:**
+- **name** - Feature identifier
+- **order** - When to run (1-100)
+- **dependencies** - Required features
+- **data** - JSON file paths
+- **assets** - Image configuration
+
+**Processing Options:**
+- **validation** - Schema checking
+- **updates** - Create vs update logic
+- **relationships** - Link to other entities
+
+## Entity Resolution
+
+Automatically find and link related data:
+
+**Example:**
+```json
+{
+  "exercise": {
+    "name": "Bench Press",
+    "category": "barbell",
+    "muscles": ["chest", "triceps"]
+  }
+}
+```
+
+System will:
+1. Find "barbell" category by name
+2. Find "chest" and "triceps" muscles
+3. Create proper database links
+
+## Localization
+
+Support multiple languages:
+
+**JSON Format:**
+```json
+{
+  "name": {
+    "en": "Bench Press",
+    "de": "Bankdrücken"
+  }
+}
+```
+
+**Database Storage:**
+- Primary language (EN) for search
+- All translations in separate table
+- Fallback to English if missing
+
+## Asset Management
+
+Upload images automatically:
+
+**JSON Reference:**
+```json
+{
+  "image": "@asset:bench-press"
+}
+```
+
+**Process:**
+1. Find image file in `.seed/assets/`
+2. Optimize (resize, format conversion)
+3. Upload to cloud storage (Vercel Blob)
+4. Store URL in database
+
+## Performance
+
+**Optimized Processing:**
+- Auto-caching prevents duplicate queries
+- Batch processing for efficiency
+- Transaction support for consistency
+
+**Example:**
+- 540 exercises processed in ~4 minutes
+- Single query loads all categories (cached)
+- No N+1 query problems
+
+## CLI Commands
+
+```bash
+# Seed everything
+yarn nx run api:db:seed
+
+# Reset and re-seed
+yarn nx run api:db:reset
+
+# Seed specific feature
+yarn nx run api:db:seed --feature=fit
+```
+
+## Troubleshooting
+
+### Validation Errors
+Check JSON structure matches schema.
+
+### Missing References
+Ensure related entities seeded first (check order/dependencies).
+
+### Asset Upload Fails
+Verify Vercel Blob token and network connection.
+
+### Duplicate Entries
+Check unique field configuration and existing data.
+
+## Development
+
+### Adding New Features
+
+1. Create `.seed/` directory in feature
+2. Add JSON data files
+3. Create `seed.config.mjs`
+4. Test locally
+5. Commit and deploy
+
+### Updating Content
+
+1. Edit JSON files
+2. Run seeding locally
+3. Verify changes
+4. Commit updates
+5. Deploy to production
+
+### Testing
+
+```bash
+# Test with fresh database
+yarn nx run api:db:reset
+yarn nx run api:db:seed
+
+# Validate JSON
+cat .seed/data/items.json | jq .
+```
+
+## Architecture
+
+**Modular Design:**
+- Each feature owns its data
+- Clear dependencies
+- Isolated testing
+- Easy to extend
+
+**Type-Safe:**
+- TypeScript throughout
+- Prisma type generation
+- Validation schemas
+
+**Production-Ready:**
+- Error handling
+- Logging
+- Performance optimized
+- Tested at scale
+
+## Support
+
+For questions or issues:
+- Check `/docs/seeding/` documentation
+- Review example implementations
+- See feature-specific READMEs
+
+---
+
+**Version:** 2.0
+**Updated:** January 2025

package/ai/AISeedGenerator.d.ts

@@ -0,0 +1,127 @@
+import { PrismaClient } from '@prisma/client';
+import type { IAISeedConfig } from './AISeedTypes.js';
+import type { IFunctionalSeederUtilities } from '../base/functionalSeeder.js';
+import type { ISeedResult } from '../config/ISeedResult.js';
+import type { ISeedContext } from '../config/ISeedContext.js';
+/**
+ * AI-powered seed generator that uses LLMs to generate realistic test data.
+ *
+ * @public
+ */
+export declare class AISeedGenerator {
+    private readonly _prisma;
+    private readonly _modelAnalyzer;
+    private readonly _logger;
+    constructor(_prisma: PrismaClient);
+    /**
+     * Generate entities using AI based on configuration.
+     *
+     * @public
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @param context Seed context with Prisma client and logger
+     * @param utilities Utilities for seeding operations
+     * @returns Result of the seeding operation
+     */
+    generateEntities<T>(config: IAISeedConfig<T>, context: ISeedContext, utilities: IFunctionalSeederUtilities): Promise<ISeedResult>;
+    /**
+     * Build a comprehensive prompt for AI generation.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @param executionContext Execution context with model schema and existing data
+     * @returns The constructed prompt string
+     */
+    private buildPrompt;
+    /**
+     * Call AI service to generate data.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @param prompt The prompt string to send to the AI
+     * @returns Array of generated objects
+     */
+    private callAI;
+    private resolveChunkSize;
+    private initializeUniqueFieldTracker;
+    private hasDuplicateUniqueField;
+    private registerUniqueFieldValues;
+    private extractUniqueFieldValue;
+    /**
+     * Create AI provider based on configuration.
+     *
+     * @private
+     * @param provider The AI provider name
+     * @returns The corresponding environment variable key
+     */
+    private createAIProvider;
+    /**
+     * Validate generated data and apply transformations.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param data The raw generated data from AI
+     * @param config AI seed configuration
+     * @returns Array of validated and transformed entities
+     */
+    private validateAndTransform;
+    /**
+     * Save generated entities to database.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param entities The array of entities to save
+     * @param config AI seed configuration
+     * @param context Seed context with Prisma client and logger
+     * @returns The saved entities
+     */
+    private saveEntities;
+    /**
+     * Get existing values for a field to avoid duplicates.
+     *
+     * @private
+     * @param existingData The existing data array
+     * @param fieldName The field name to extract values from
+     * @returns Array of existing values for the specified field
+     */
+    private getExistingFieldValues;
+    /**
+     * Interpolate template with variables.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param template The template string with placeholders
+     * @param variables Variables to replace in the template
+     * @returns The interpolated string
+     */
+    private interpolateTemplate;
+    /**
+     * Convert model name to camelCase for Prisma client access.
+     *
+     * @private
+     * @param modelName The Prisma model name
+     * @returns The camelCased model name
+     */
+    private toCamelCase;
+    /**
+     * Get or create Zod schema from config.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @returns Zod schema for validating generated entities
+     */
+    private getZodSchema;
+    /**
+     * Generate a basic Zod schema for common Prisma model patterns.
+     *
+     * @private
+     * @template T The type of the entity to be generated
+     * @param config AI seed configuration
+     * @returns Zod schema for validating generated entities
+     */
+    private generateBasicPrismaSchema;
+}
+//# sourceMappingURL=AISeedGenerator.d.ts.map

package/ai/AISeedGenerator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AISeedGenerator.d.ts","sourceRoot":"","sources":["../../src/ai/AISeedGenerator.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,OAAO,KAAK,EAAE,aAAa,EAA8C,MAAM,kBAAkB,CAAC;AAClG,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,6BAA6B,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAM9D;;;;GAIG;AACH,qBAAa,eAAe;IAYpB,OAAO,CAAC,QAAQ,CAAC,OAAO;IAR5B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAsB;IACrD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAoB;gBAOvB,OAAO,EAAE,YAAY;IAS1C;;;;;;;;;OASG;IACU,gBAAgB,CAAC,CAAC,EAAE,MAAM,EAAE,aAAa,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,SAAS,EAAE,0BAA0B,GAAG,OAAO,CAAC,WAAW,CAAC;IAwD9I;;;;;;;;OAQG;IACH,OAAO,CAAC,WAAW;IAsEnB;;;;;;;;OAQG;YACW,MAAM;IAwBpB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,4BAA4B;IAsBpC,OAAO,CAAC,uBAAuB;IAsB/B,OAAO,CAAC,yBAAyB;IAoBjC,OAAO,CAAC,uBAAuB;IAoB/B;;;;;;OAMG;IACH,OAAO,CAAC,gBAAgB;IA6BxB;;;;;;;;OAQG;IACH,OAAO,CAAC,oBAAoB;IAsC5B;;;;;;;;;OASG;YACW,YAAY;IAc1B;;;;;;;OAOG;IACH,OAAO,CAAC,sBAAsB;IAO9B;;;;;;;;OAQG;IACH,OAAO,CAAC,mBAAmB;IAwB3B;;;;;;OAMG;IACH,OAAO,CAAC,WAAW;IAInB;;;;;;;OAOG;IACH,OAAO,CAAC,YAAY;IAUpB;;;;;;;OAOG;IACH,OAAO,CAAC,yBAAyB;CA0BpC"}