@varity-labs/sdk 2.0.0-alpha.1

package/dist/ui/components/KPICard.d.ts

@@ -0,0 +1,29 @@
+/**
+ * KPI Card Component
+ *
+ * Universal KPI display card for dashboards
+ */
+import React from 'react';
+export interface KPICardProps {
+    /** Card title */
+    title: string;
+    /** Main value to display */
+    value: string | number;
+    /** Optional subtitle */
+    subtitle?: string;
+    /** Loading state */
+    loading?: boolean;
+    /** Trend indicator */
+    trend?: {
+        value: number;
+        label: string;
+    };
+    /** Custom icon */
+    icon?: React.ReactNode;
+    /** Card color variant */
+    variant?: 'default' | 'primary' | 'success' | 'error' | 'warning';
+    /** Click handler */
+    onClick?: () => void;
+}
+export declare const KPICard: React.FC<KPICardProps>;
+//# sourceMappingURL=KPICard.d.ts.map

package/dist/ui/components/KPICard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"KPICard.d.ts","sourceRoot":"","sources":["../../../src/ui/components/KPICard.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAWzB,MAAM,WAAW,YAAY;IAC3B,iBAAiB;IACjB,KAAK,EAAE,MAAM,CAAA;IACb,4BAA4B;IAC5B,KAAK,EAAE,MAAM,GAAG,MAAM,CAAA;IACtB,wBAAwB;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,oBAAoB;IACpB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,sBAAsB;IACtB,KAAK,CAAC,EAAE;QACN,KAAK,EAAE,MAAM,CAAA;QACb,KAAK,EAAE,MAAM,CAAA;KACd,CAAA;IACD,kBAAkB;IAClB,IAAI,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;IACtB,yBAAyB;IACzB,OAAO,CAAC,EAAE,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,GAAG,SAAS,CAAA;IACjE,oBAAoB;IACpB,OAAO,CAAC,EAAE,MAAM,IAAI,CAAA;CACrB;AAUD,eAAO,MAAM,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC,YAAY,CA2G1C,CAAA"}

package/dist/ui/components/KPICard.js

@@ -0,0 +1,61 @@
+/**
+ * KPI Card Component
+ *
+ * Universal KPI display card for dashboards
+ */
+import React from 'react';
+import { Card, CardContent, Typography, Box, Skeleton } from '@mui/material';
+import { TrendingUp, TrendingDown } from '@mui/icons-material';
+const variantColors = {
+    default: '#1976d2',
+    primary: '#1976d2',
+    success: '#2e7d32',
+    error: '#d32f2f',
+    warning: '#ed6c02'
+};
+export const KPICard = ({ title, value, subtitle, loading = false, trend, icon, variant = 'default', onClick }) => {
+    const color = variantColors[variant];
+    if (loading) {
+        return (React.createElement(Card, { sx: {
+                height: '100%',
+                cursor: onClick ? 'pointer' : 'default',
+                transition: 'transform 0.2s, box-shadow 0.2s',
+                '&:hover': onClick ? {
+                    transform: 'translateY(-4px)',
+                    boxShadow: 3
+                } : {}
+            } },
+            React.createElement(CardContent, null,
+                React.createElement(Skeleton, { variant: "text", width: "60%", height: 24 }),
+                React.createElement(Skeleton, { variant: "text", width: "80%", height: 48, sx: { mt: 1 } }),
+                React.createElement(Skeleton, { variant: "text", width: "40%", height: 20, sx: { mt: 1 } }))));
+    }
+    return (React.createElement(Card, { onClick: onClick, sx: {
+            height: '100%',
+            cursor: onClick ? 'pointer' : 'default',
+            transition: 'transform 0.2s, box-shadow 0.2s',
+            '&:hover': onClick ? {
+                transform: 'translateY(-4px)',
+                boxShadow: 3
+            } : {},
+            borderTop: `4px solid ${color}`
+        } },
+        React.createElement(CardContent, null,
+            React.createElement(Box, { sx: { display: 'flex', justifyContent: 'space-between', alignItems: 'flex-start', mb: 2 } },
+                React.createElement(Typography, { variant: "subtitle2", color: "text.secondary", gutterBottom: true, sx: { fontWeight: 500 } }, title),
+                icon && (React.createElement(Box, { sx: { color, display: 'flex', alignItems: 'center' } }, icon))),
+            React.createElement(Typography, { variant: "h4", component: "div", sx: { fontWeight: 700, color: 'text.primary', mb: 1 } }, value),
+            (subtitle || trend) && (React.createElement(Box, { sx: { display: 'flex', alignItems: 'center', gap: 1, flexWrap: 'wrap' } },
+                trend && (React.createElement(Box, { sx: {
+                        display: 'flex',
+                        alignItems: 'center',
+                        gap: 0.5,
+                        color: trend.value >= 0 ? 'success.main' : 'error.main'
+                    } },
+                    trend.value >= 0 ? (React.createElement(TrendingUp, { fontSize: "small" })) : (React.createElement(TrendingDown, { fontSize: "small" })),
+                    React.createElement(Typography, { variant: "body2", sx: { fontWeight: 600 } },
+                        Math.abs(trend.value),
+                        "%"),
+                    React.createElement(Typography, { variant: "caption", color: "text.secondary" }, trend.label))),
+                subtitle && !trend && (React.createElement(Typography, { variant: "body2", color: "text.secondary" }, subtitle)))))));
+};

package/dist/ui/components/Modal.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Modal Component
+ *
+ * Universal modal dialog for forms and content
+ */
+import React from 'react';
+export interface ModalProps {
+    /** Modal open state */
+    open: boolean;
+    /** Close handler */
+    onClose: () => void;
+    /** Modal title */
+    title?: string;
+    /** Modal children/content */
+    children: React.ReactNode;
+    /** Action buttons */
+    actions?: Array<{
+        label: string;
+        onClick: () => void;
+        variant?: 'text' | 'outlined' | 'contained';
+        color?: 'primary' | 'secondary' | 'error' | 'success';
+        disabled?: boolean;
+    }>;
+    /** Max width */
+    maxWidth?: 'xs' | 'sm' | 'md' | 'lg' | 'xl' | false;
+    /** Full width */
+    fullWidth?: boolean;
+    /** Disable backdrop click to close */
+    disableBackdropClick?: boolean;
+    /** Show close button */
+    showCloseButton?: boolean;
+}
+export declare const Modal: React.FC<ModalProps>;
+//# sourceMappingURL=Modal.d.ts.map

package/dist/ui/components/Modal.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Modal.d.ts","sourceRoot":"","sources":["../../../src/ui/components/Modal.tsx"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,OAAO,CAAA;AAazB,MAAM,WAAW,UAAU;IACzB,uBAAuB;IACvB,IAAI,EAAE,OAAO,CAAA;IACb,oBAAoB;IACpB,OAAO,EAAE,MAAM,IAAI,CAAA;IACnB,kBAAkB;IAClB,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,6BAA6B;IAC7B,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;IACzB,qBAAqB;IACrB,OAAO,CAAC,EAAE,KAAK,CAAC;QACd,KAAK,EAAE,MAAM,CAAA;QACb,OAAO,EAAE,MAAM,IAAI,CAAA;QACnB,OAAO,CAAC,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,CAAA;QAC3C,KAAK,CAAC,EAAE,SAAS,GAAG,WAAW,GAAG,OAAO,GAAG,SAAS,CAAA;QACrD,QAAQ,CAAC,EAAE,OAAO,CAAA;KACnB,CAAC,CAAA;IACF,gBAAgB;IAChB,QAAQ,CAAC,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,IAAI,GAAG,KAAK,CAAA;IACnD,iBAAiB;IACjB,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,sCAAsC;IACtC,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,wBAAwB;IACxB,eAAe,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,eAAO,MAAM,KAAK,EAAE,KAAK,CAAC,EAAE,CAAC,UAAU,CAoEtC,CAAA"}

package/dist/ui/components/Modal.js

@@ -0,0 +1,30 @@
+/**
+ * Modal Component
+ *
+ * Universal modal dialog for forms and content
+ */
+import React from 'react';
+import { Dialog, DialogTitle, DialogContent, DialogActions, Button, IconButton, Box, Typography } from '@mui/material';
+import { Close as CloseIcon } from '@mui/icons-material';
+export const Modal = ({ open, onClose, title, children, actions, maxWidth = 'sm', fullWidth = true, disableBackdropClick = false, showCloseButton = true }) => {
+    const handleClose = (_event, reason) => {
+        if (reason === 'backdropClick' && disableBackdropClick) {
+            return;
+        }
+        onClose();
+    };
+    return (React.createElement(Dialog, { open: open, onClose: handleClose, maxWidth: maxWidth, fullWidth: fullWidth, PaperProps: {
+            sx: {
+                borderRadius: 2
+            }
+        } },
+        title && (React.createElement(DialogTitle, null,
+            React.createElement(Box, { sx: { display: 'flex', alignItems: 'center', justifyContent: 'space-between' } },
+                React.createElement(Typography, { variant: "h6" }, title),
+                showCloseButton && (React.createElement(IconButton, { "aria-label": "close", onClick: onClose, sx: {
+                        color: (theme) => theme.palette.grey[500]
+                    } },
+                    React.createElement(CloseIcon, null)))))),
+        React.createElement(DialogContent, { dividers: true }, children),
+        actions && actions.length > 0 && (React.createElement(DialogActions, { sx: { px: 3, py: 2 } }, actions.map((action, index) => (React.createElement(Button, { key: index, onClick: action.onClick, variant: action.variant || 'text', color: action.color || 'primary', disabled: action.disabled }, action.label)))))));
+};

package/dist/ui/components/index.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Varity UI Component Library
+ *
+ * Pre-built Material-UI components for rapid dashboard development
+ */
+export { KPICard } from './KPICard';
+export type { KPICardProps } from './KPICard';
+export { DataTable } from './DataTable';
+export type { DataTableProps, Column } from './DataTable';
+export { EntityForm } from './EntityForm';
+export type { EntityFormProps, FormField } from './EntityForm';
+export { ChartWidget } from './ChartWidget';
+export type { ChartWidgetProps, ChartType, ChartDataPoint } from './ChartWidget';
+export { DashboardLayout } from './DashboardLayout';
+export type { DashboardLayoutProps, NavigationItem } from './DashboardLayout';
+export { Modal } from './Modal';
+export type { ModalProps } from './Modal';
+//# sourceMappingURL=index.d.ts.map

package/dist/ui/components/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/ui/components/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,YAAY,EAAE,YAAY,EAAE,MAAM,WAAW,CAAA;AAE7C,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAA;AACvC,YAAY,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,aAAa,CAAA;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,MAAM,cAAc,CAAA;AAE9D,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAA;AAC3C,YAAY,EAAE,gBAAgB,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,eAAe,CAAA;AAEhF,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAA;AACnD,YAAY,EAAE,oBAAoB,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAA;AAE7E,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAA;AAC/B,YAAY,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA"}

package/dist/ui/components/index.js

@@ -0,0 +1,11 @@
+/**
+ * Varity UI Component Library
+ *
+ * Pre-built Material-UI components for rapid dashboard development
+ */
+export { KPICard } from './KPICard';
+export { DataTable } from './DataTable';
+export { EntityForm } from './EntityForm';
+export { ChartWidget } from './ChartWidget';
+export { DashboardLayout } from './DashboardLayout';
+export { Modal } from './Modal';

package/dist/validation/template-validator.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Template Validator
+ *
+ * Validates template configuration against schema and best practices
+ */
+export interface ValidateTemplateOptions {
+    templatePath: string;
+    strict: boolean;
+}
+export interface ValidationResult {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+    summary: {
+        entities: number;
+        contracts: number;
+        events: number;
+        metrics: number;
+    };
+}
+/**
+ * Validate template configuration
+ */
+export declare function validateTemplate(options: ValidateTemplateOptions): Promise<ValidationResult>;
+//# sourceMappingURL=template-validator.d.ts.map

package/dist/validation/template-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"template-validator.d.ts","sourceRoot":"","sources":["../../src/validation/template-validator.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAMH,MAAM,WAAW,uBAAuB;IACtC,YAAY,EAAE,MAAM,CAAA;IACpB,MAAM,EAAE,OAAO,CAAA;CAChB;AAED,MAAM,WAAW,gBAAgB;IAC/B,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,MAAM,EAAE,CAAA;IAChB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,OAAO,EAAE;QACP,QAAQ,EAAE,MAAM,CAAA;QAChB,SAAS,EAAE,MAAM,CAAA;QACjB,MAAM,EAAE,MAAM,CAAA;QACd,OAAO,EAAE,MAAM,CAAA;KAChB,CAAA;CACF;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CACpC,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,gBAAgB,CAAC,CAmE3B"}

package/dist/validation/template-validator.js

@@ -0,0 +1,305 @@
+/**
+ * Template Validator
+ *
+ * Validates template configuration against schema and best practices
+ */
+import * as fs from 'fs';
+/**
+ * Validate template configuration
+ */
+export async function validateTemplate(options) {
+    const result = {
+        valid: false,
+        errors: [],
+        warnings: [],
+        summary: {
+            entities: 0,
+            contracts: 0,
+            events: 0,
+            metrics: 0
+        }
+    };
+    try {
+        // Check if file exists
+        if (!fs.existsSync(options.templatePath)) {
+            result.errors.push(`Template file not found: ${options.templatePath}`);
+            return result;
+        }
+        // Parse JSON
+        const templateContent = fs.readFileSync(options.templatePath, 'utf-8');
+        let template;
+        try {
+            template = JSON.parse(templateContent);
+        }
+        catch (parseError) {
+            result.errors.push(`Invalid JSON: ${parseError instanceof Error ? parseError.message : 'Parse error'}`);
+            return result;
+        }
+        // Validate schema
+        validateSchema(template, result, options.strict);
+        // Validate entities
+        validateEntities(template, result, options.strict);
+        // Validate contracts
+        validateContracts(template, result, options.strict);
+        // Validate storage configuration
+        validateStorage(template, result, options.strict);
+        // Validate API configuration
+        validateAPI(template, result, options.strict);
+        // Validate features
+        validateFeatures(template, result, options.strict);
+        // Generate summary
+        result.summary = {
+            entities: template.entities?.length || 0,
+            contracts: template.contracts?.length || 0,
+            events: template.events?.length || 0,
+            metrics: template.metrics?.length || 0
+        };
+        // Set overall validity
+        result.valid = result.errors.length === 0;
+    }
+    catch (error) {
+        result.errors.push(`Validation error: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+    return result;
+}
+/**
+ * Validate template schema
+ */
+function validateSchema(template, result, strict) {
+    // Required fields
+    if (!template.type) {
+        result.errors.push('Missing required field: type');
+    }
+    if (!template.name) {
+        result.errors.push('Missing required field: name');
+    }
+    if (!template.version) {
+        result.errors.push('Missing required field: version');
+    }
+    // Version format
+    if (template.version && !/^\d+\.\d+\.\d+$/.test(template.version)) {
+        result.warnings.push('Version should follow semantic versioning (e.g., 1.0.0)');
+    }
+    // Description
+    if (!template.description) {
+        if (strict) {
+            result.errors.push('Missing required field: description');
+        }
+        else {
+            result.warnings.push('Missing description field');
+        }
+    }
+}
+/**
+ * Validate entities
+ */
+function validateEntities(template, result, strict) {
+    if (!template.entities || template.entities.length === 0) {
+        result.errors.push('Template must have at least one entity');
+        return;
+    }
+    template.entities.forEach((entity, index) => {
+        const prefix = `Entity ${entity.name || index}`;
+        // Required fields
+        if (!entity.name) {
+            result.errors.push(`${prefix}: Missing name`);
+        }
+        if (!entity.idField) {
+            result.errors.push(`${prefix}: Missing idField`);
+        }
+        // Fields validation
+        if (!entity.fields || entity.fields.length === 0) {
+            result.errors.push(`${prefix}: Must have at least one field`);
+        }
+        else {
+            // Check for idField existence
+            const hasIdField = entity.fields.some(f => f.name === entity.idField);
+            if (!hasIdField) {
+                result.errors.push(`${prefix}: idField "${entity.idField}" not found in fields`);
+            }
+            // Check for required tracking fields
+            const hasCreatedAt = entity.fields.some(f => f.name === 'createdAt');
+            const hasIsActive = entity.fields.some(f => f.name === 'isActive');
+            if (!hasCreatedAt) {
+                result.warnings.push(`${prefix}: Missing recommended field "createdAt"`);
+            }
+            if (!hasIsActive) {
+                result.warnings.push(`${prefix}: Missing recommended field "isActive"`);
+            }
+            // Validate field types
+            entity.fields.forEach((field, fieldIndex) => {
+                const fieldPrefix = `${prefix}.fields[${fieldIndex}]`;
+                if (!field.name) {
+                    result.errors.push(`${fieldPrefix}: Missing name`);
+                }
+                if (!field.type) {
+                    result.errors.push(`${fieldPrefix}: Missing type`);
+                }
+                else {
+                    // Universal field types - supporting all industries
+                    const validTypes = [
+                        // Basic types
+                        'string', 'number', 'boolean', 'enum', 'array', 'object',
+                        // Financial types
+                        'currency', 'decimal', 'percentage',
+                        // Temporal types
+                        'date', 'time', 'datetime', 'duration',
+                        // Contact types
+                        'email', 'phone', 'url',
+                        // Blockchain types
+                        'address',
+                        // Identification types
+                        'ssn', 'tax-id', 'medical-code', 'sku', 'barcode',
+                        // Content types
+                        'rich-text', 'markdown', 'json',
+                        // Media types
+                        'file', 'image', 'document',
+                        // Advanced types
+                        'lookup', 'multi-select', 'coordinates', 'color', 'ip-address',
+                        // Legacy types
+                        'bytes', 'bytes32'
+                    ];
+                    if (!validTypes.includes(field.type)) {
+                        result.warnings.push(`${fieldPrefix}: Unknown type "${field.type}". Valid types: ${validTypes.join(', ')}`);
+                    }
+                }
+                // Additional validation for specific field types
+                if (field.type === 'enum' || field.type === 'multi-select') {
+                    if (!field.enumValues || field.enumValues.length === 0) {
+                        result.errors.push(`${fieldPrefix}: Field type "${field.type}" requires enumValues`);
+                    }
+                }
+                if (field.type === 'lookup') {
+                    if (!field.lookupConfig) {
+                        result.errors.push(`${fieldPrefix}: Field type "lookup" requires lookupConfig`);
+                    }
+                }
+                // Validation rule checks
+                if (field.validation) {
+                    // Validate email pattern
+                    if (field.type === 'email' && !field.validation.pattern) {
+                        result.warnings.push(`${fieldPrefix}: Email field should have validation pattern`);
+                    }
+                    // Validate phone pattern
+                    if (field.type === 'phone' && !field.validation.pattern) {
+                        result.warnings.push(`${fieldPrefix}: Phone field should have validation pattern`);
+                    }
+                    // Validate currency precision
+                    if (field.type === 'currency' && !field.validation.precision) {
+                        result.warnings.push(`${fieldPrefix}: Currency field should have precision validation`);
+                    }
+                    // Validate file types
+                    if (['file', 'image', 'document'].includes(field.type) && !field.validation.fileTypes) {
+                        result.warnings.push(`${fieldPrefix}: File field should specify allowed fileTypes`);
+                    }
+                }
+            });
+        }
+        // Display name
+        if (!entity.displayName && strict) {
+            result.warnings.push(`${prefix}: Missing displayName`);
+        }
+    });
+}
+/**
+ * Validate contracts
+ */
+function validateContracts(template, result, strict) {
+    if (!template.contracts || template.contracts.length === 0) {
+        result.warnings.push('No contracts defined in template');
+        return;
+    }
+    template.contracts.forEach((contract, index) => {
+        const prefix = `Contract ${contract.name || index}`;
+        if (!contract.name) {
+            result.errors.push(`${prefix}: Missing name`);
+        }
+        if (!contract.abi) {
+            result.warnings.push(`${prefix}: Missing ABI path`);
+        }
+        if (!contract.addresses) {
+            result.warnings.push(`${prefix}: Missing addresses configuration`);
+        }
+        else {
+            // Check for network addresses
+            const networks = ['arbitrum-sepolia', 'arbitrum-l3-testnet', 'arbitrum-l3-mainnet'];
+            networks.forEach(network => {
+                if (!(network in contract.addresses)) {
+                    result.warnings.push(`${prefix}: Missing address for network "${network}"`);
+                }
+            });
+        }
+    });
+}
+/**
+ * Validate storage configuration
+ */
+function validateStorage(template, result, strict) {
+    if (!template.storage) {
+        if (strict) {
+            result.errors.push('Missing storage configuration');
+        }
+        else {
+            result.warnings.push('Missing storage configuration');
+        }
+        return;
+    }
+    // Check namespace patterns
+    if (!template.storage.varityNamespace) {
+        result.warnings.push('Missing varityNamespace in storage config');
+    }
+    if (!template.storage.industryNamespace) {
+        result.warnings.push('Missing industryNamespace in storage config');
+    }
+    if (!template.storage.customerNamespacePattern) {
+        result.warnings.push('Missing customerNamespacePattern in storage config');
+    }
+    // Validate namespace pattern format
+    const patterns = [
+        template.storage.customerNamespacePattern
+    ].filter(Boolean);
+    patterns.forEach(pattern => {
+        if (pattern && !pattern.includes('{') && !pattern.includes('}')) {
+            result.warnings.push(`Namespace pattern "${pattern}" should include placeholders like {category}`);
+        }
+    });
+}
+/**
+ * Validate API configuration
+ */
+function validateAPI(template, result, strict) {
+    if (!template.api) {
+        result.warnings.push('Missing API configuration');
+        return;
+    }
+    if (!template.api.basePath) {
+        result.warnings.push('Missing API basePath');
+    }
+    else if (!template.api.basePath.startsWith('/api/')) {
+        result.warnings.push('API basePath should start with /api/');
+    }
+}
+/**
+ * Validate features
+ */
+function validateFeatures(template, result, strict) {
+    if (!template.features) {
+        result.warnings.push('Missing features configuration');
+        return;
+    }
+    const recommendedFeatures = [
+        'analytics',
+        'forecasting',
+        'notifications',
+        'export',
+        'cache',
+        'monitoring'
+    ];
+    if (template.features) {
+        recommendedFeatures.forEach(feature => {
+            if (!(feature in template.features)) {
+                result.warnings.push(`Missing recommended feature: ${feature}`);
+            }
+        });
+    }
+}

package/package.json

@@ -0,0 +1,102 @@
+{
+  "name": "@varity-labs/sdk",
+  "version": "2.0.0-alpha.1",
+  "description": "Varity SDK - Build any app on Varity L3 with complete thirdweb integration (Engine, Nebula AI, Storage, Bridge, Gateway, x402)",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "sideEffects": false,
+  "bin": {
+    "varity": "dist/cli/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "build:watch": "tsc --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "lint": "eslint src --ext .ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "cli:dev": "npm run build && node dist/cli/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "varity",
+    "varity-l3",
+    "thirdweb",
+    "multi-chain",
+    "web3",
+    "blockchain",
+    "erc-4337",
+    "account-abstraction",
+    "gasless-transactions",
+    "depin",
+    "arbitrum",
+    "base",
+    "ipfs",
+    "arweave",
+    "cross-chain",
+    "ai-blockchain",
+    "nebula-ai"
+  ],
+  "author": "Varity",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/varity/varity-sdk"
+  },
+  "dependencies": {
+    "@emotion/react": "^11.11.0",
+    "@emotion/styled": "^11.11.0",
+    "@mui/icons-material": "^5.15.0",
+    "@mui/material": "^5.15.0",
+    "@mui/x-date-pickers": "^6.19.0",
+    "@varity-labs/types": "workspace:*",
+    "axios": "^1.6.0",
+    "chalk": "^5.3.0",
+    "chokidar": "^3.5.3",
+    "commander": "^11.1.0",
+    "crypto-js": "^4.2.0",
+    "date-fns": "^2.30.0",
+    "ethers": "^6.0.0",
+    "handlebars": "^4.7.8",
+    "inquirer": "^9.2.12",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "recharts": "^2.10.0",
+    "thirdweb": "^5.112.0"
+  },
+  "devDependencies": {
+    "@types/crypto-js": "^4.2.1",
+    "@types/inquirer": "^9.0.7",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.10.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "eslint": "^8.50.0",
+    "jest": "^29.7.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "typescript": "^5.3.0"
+  },
+  "peerDependencies": {
+    "ethers": "^6.0.0"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  }
+}