PyPI - moai-adk - Versions diffs - 0.8.0__py3-none-any.whl → 1.1.0__py3-none-any.whl - Mend

moai-adk 0.8.0py3-none-any.whl → 1.1.0py3-none-any.whl

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (881) hide show

moai_adk/templates/.claude/skills/moai-platform-vercel/modules/analytics-speed.md ADDED Viewed

@@ -0,0 +1,348 @@
+# Analytics and Speed Insights
+## Overview
+Vercel provides built-in analytics and performance monitoring through Vercel Analytics (page views and visitors) and Speed Insights (Core Web Vitals). Both integrate seamlessly with Next.js applications.
+## Vercel Analytics
+### Installation
+```bash
+npm install @vercel/analytics
+```
+### Basic Integration
+```typescript
+// app/layout.tsx
+import { Analytics } from '@vercel/analytics/react'
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <Analytics />
+      </body>
+    </html>
+  )
+}
+```
+### Configuration Options
+```typescript
+// app/layout.tsx
+import { Analytics } from '@vercel/analytics/react'
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <Analytics
+          mode="production" // or "development"
+          debug={process.env.NODE_ENV === 'development'}
+          beforeSend={(event) => {
+            // Filter out sensitive paths
+            if (event.url.includes('/admin')) {
+              return null
+            }
+            return event
+          }}
+        />
+      </body>
+    </html>
+  )
+}
+```
+### Custom Events
+```typescript
+// components/Button.tsx
+import { track } from '@vercel/analytics'
+export function BuyButton({ productId }: { productId: string }) {
+  return (
+    <button
+      onClick={() => {
+        track('purchase_clicked', {
+          productId,
+          timestamp: new Date().toISOString()
+        })
+      }}
+    >
+      Buy Now
+    </button>
+  )
+}
+```
+## Speed Insights
+### Installation
+```bash
+npm install @vercel/speed-insights
+```
+### Basic Integration
+```typescript
+// app/layout.tsx
+import { Analytics } from '@vercel/analytics/react'
+import { SpeedInsights } from '@vercel/speed-insights/next'
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <Analytics />
+        <SpeedInsights />
+      </body>
+    </html>
+  )
+}
+```
+### Configuration Options
+```typescript
+// app/layout.tsx
+import { SpeedInsights } from '@vercel/speed-insights/next'
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <SpeedInsights
+          sampleRate={0.5} // Sample 50% of page views
+          debug={process.env.NODE_ENV === 'development'}
+          route={null} // Override detected route
+        />
+      </body>
+    </html>
+  )
+}
+```
+## Custom Web Vitals Reporting
+### Client-Side Implementation
+```typescript
+// app/components/WebVitals.tsx
+'use client'
+import { useReportWebVitals } from 'next/web-vitals'
+export function WebVitals() {
+  useReportWebVitals((metric) => {
+    const body = JSON.stringify({
+      name: metric.name,
+      value: metric.value,
+      rating: metric.rating,
+      delta: metric.delta,
+      id: metric.id,
+      navigationType: metric.navigationType
+    })
+    // Send to custom analytics endpoint
+    if (navigator.sendBeacon) {
+      navigator.sendBeacon('/api/vitals', body)
+    } else {
+      fetch('/api/vitals', { body, method: 'POST', keepalive: true })
+    }
+  })
+  return null
+}
+```
+### API Endpoint for Custom Analytics
+```typescript
+// app/api/vitals/route.ts
+import { NextRequest } from 'next/server'
+export async function POST(request: NextRequest) {
+  const metric = await request.json()
+  // Log to console in development
+  if (process.env.NODE_ENV === 'development') {
+    console.log('Web Vital:', metric)
+  }
+  // Send to external analytics service
+  await fetch('https://analytics.example.com/vitals', {
+    method: 'POST',
+    headers: { 'Content-Type': 'application/json' },
+    body: JSON.stringify({
+      ...metric,
+      page: request.headers.get('referer'),
+      userAgent: request.headers.get('user-agent'),
+      timestamp: new Date().toISOString()
+    })
+  })
+  return Response.json({ received: true })
+}
+```
+## Core Web Vitals
+### Metrics Tracked
+LCP (Largest Contentful Paint):
+- Measures loading performance
+- Good: under 2.5 seconds
+- Needs improvement: 2.5-4 seconds
+- Poor: over 4 seconds
+FID (First Input Delay):
+- Measures interactivity
+- Good: under 100ms
+- Needs improvement: 100-300ms
+- Poor: over 300ms
+CLS (Cumulative Layout Shift):
+- Measures visual stability
+- Good: under 0.1
+- Needs improvement: 0.1-0.25
+- Poor: over 0.25
+INP (Interaction to Next Paint):
+- Measures responsiveness
+- Good: under 200ms
+- Needs improvement: 200-500ms
+- Poor: over 500ms
+TTFB (Time to First Byte):
+- Measures server response time
+- Good: under 800ms
+- Needs improvement: 800-1800ms
+- Poor: over 1800ms
+### Optimization Strategies
+```typescript
+// Optimize LCP with priority images
+import Image from 'next/image'
+export function Hero() {
+  return (
+    <Image
+      src="/hero.jpg"
+      alt="Hero"
+      width={1200}
+      height={600}
+      priority // Load immediately
+      fetchPriority="high"
+    />
+  )
+}
+```
+```typescript
+// Optimize CLS with size hints
+export function ProductCard({ product }) {
+  return (
+    <div className="aspect-square"> {/* Reserve space */}
+      <Image
+        src={product.image}
+        alt={product.name}
+        width={300}
+        height={300}
+        className="object-cover"
+      />
+    </div>
+  )
+}
+```
+## Real User Monitoring
+### Aggregate Metrics Dashboard
+Access via Vercel Dashboard:
+1. Navigate to your project
+2. Click on "Analytics" tab
+3. View page views, unique visitors, and top pages
+4. Click on "Speed Insights" for Web Vitals
+### Performance Budgets
+```typescript
+// next.config.js
+module.exports = {
+  experimental: {
+    webVitalsAttribution: ['CLS', 'LCP', 'FID', 'INP', 'TTFB']
+  }
+}
+```
+## Third-Party Analytics Integration
+### Google Analytics 4
+```typescript
+// app/layout.tsx
+import Script from 'next/script'
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        <Script
+          src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX"
+          strategy="afterInteractive"
+        />
+        <Script id="google-analytics" strategy="afterInteractive">
+          {`
+            window.dataLayer = window.dataLayer || [];
+            function gtag(){dataLayer.push(arguments);}
+            gtag('js', new Date());
+            gtag('config', 'G-XXXXXXXXXX');
+          `}
+        </Script>
+      </body>
+    </html>
+  )
+}
+```
+### Combining with Vercel Analytics
+```typescript
+// app/layout.tsx
+import { Analytics } from '@vercel/analytics/react'
+import { SpeedInsights } from '@vercel/speed-insights/next'
+import Script from 'next/script'
+export default function RootLayout({ children }: { children: React.ReactNode }) {
+  return (
+    <html lang="en">
+      <body>
+        {children}
+        {/* Vercel Analytics */}
+        <Analytics />
+        <SpeedInsights />
+        {/* Google Analytics */}
+        <Script src="https://www.googletagmanager.com/gtag/js?id=G-XXXXXXXXXX" />
+      </body>
+    </html>
+  )
+}
+```
+## Context7 Integration
+For latest analytics and Speed Insights documentation, use:
+- Library: `/vercel/vercel`
+- Topics: analytics, speed-insights, web-vitals
+- Token allocation: 5000-8000 for comprehensive coverage

moai_adk/templates/.claude/skills/moai-platform-vercel/modules/deployment-config.md ADDED Viewed

@@ -0,0 +1,344 @@
+# Deployment Configuration
+## Overview
+Vercel deployment configuration is managed through `vercel.json` and environment variables. This module covers project settings, function configuration, and CI/CD integration.
+## vercel.json Configuration
+### Complete Configuration Example
+```json
+{
+  "$schema": "https://openapi.vercel.sh/vercel.json",
+  "framework": "nextjs",
+  "buildCommand": "pnpm build",
+  "installCommand": "pnpm install",
+  "outputDirectory": ".next",
+  "regions": ["iad1", "sfo1", "fra1", "hnd1"],
+  "functions": {
+    "app/api/**/*.ts": {
+      "memory": 1024,
+      "maxDuration": 30
+    },
+    "app/api/heavy/**/*.ts": {
+      "memory": 3008,
+      "maxDuration": 60
+    }
+  },
+  "crons": [
+    {
+      "path": "/api/cron/cleanup",
+      "schedule": "0 0 * * *"
+    },
+    {
+      "path": "/api/cron/sync",
+      "schedule": "*/15 * * * *"
+    }
+  ],
+  "headers": [
+    {
+      "source": "/api/(.*)",
+      "headers": [
+        { "key": "Access-Control-Allow-Origin", "value": "*" },
+        { "key": "Cache-Control", "value": "s-maxage=60, stale-while-revalidate" }
+      ]
+    },
+    {
+      "source": "/(.*)",
+      "headers": [
+        { "key": "X-Content-Type-Options", "value": "nosniff" },
+        { "key": "X-Frame-Options", "value": "DENY" },
+        { "key": "X-XSS-Protection", "value": "1; mode=block" }
+      ]
+    }
+  ],
+  "rewrites": [
+    { "source": "/blog/:slug", "destination": "/posts/:slug" },
+    { "source": "/api/v1/:path*", "destination": "/api/:path*" }
+  ],
+  "redirects": [
+    { "source": "/old-page", "destination": "/new-page", "permanent": true }
+  ]
+}
+```
+## Environment Variables
+### CLI Management
+```bash
+# Production environment
+vercel env add DATABASE_URL production
+vercel env add API_SECRET production
+vercel env add NEXT_PUBLIC_API_URL production
+# Preview environments (PR deployments)
+vercel env add DATABASE_URL preview
+vercel env add API_SECRET preview
+# Development environment
+vercel env add DATABASE_URL development
+# Pull environment for local development
+vercel env pull .env.local
+# List all environment variables
+vercel env ls
+# Remove environment variable
+vercel env rm DATABASE_URL production
+```
+### Environment-Specific Configuration
+```typescript
+// next.config.js
+module.exports = {
+  env: {
+    CUSTOM_KEY: process.env.CUSTOM_KEY
+  },
+  // Public variables (available in browser)
+  publicRuntimeConfig: {
+    apiUrl: process.env.NEXT_PUBLIC_API_URL
+  },
+  // Server-only variables
+  serverRuntimeConfig: {
+    secretKey: process.env.API_SECRET
+  }
+}
+```
+## Preview Deployments
+### GitHub Integration
+```yaml
+# .github/workflows/vercel-preview.yml
+name: Vercel Preview Deployment
+on:
+  pull_request:
+    types: [opened, synchronize, reopened]
+jobs:
+  deploy-preview:
+    runs-on: ubuntu-latest
+    environment:
+      name: Preview
+      url: ${{ steps.deploy.outputs.url }}
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Vercel CLI
+        run: npm i -g vercel@latest
+      - name: Pull Vercel Environment
+        run: vercel pull --yes --environment=preview --token=${{ secrets.VERCEL_TOKEN }}
+      - name: Build Project
+        run: vercel build --token=${{ secrets.VERCEL_TOKEN }}
+      - name: Deploy to Vercel
+        id: deploy
+        run: |
+          url=$(vercel deploy --prebuilt --token=${{ secrets.VERCEL_TOKEN }})
+          echo "url=$url" >> $GITHUB_OUTPUT
+      - name: Comment PR with Preview URL
+        uses: actions/github-script@v7
+        with:
+          script: |
+            github.rest.issues.createComment({
+              owner: context.repo.owner,
+              repo: context.repo.repo,
+              issue_number: context.issue.number,
+              body: 'Preview deployed: ${{ steps.deploy.outputs.url }}'
+            })
+```
+### Production Deployment
+```yaml
+# .github/workflows/vercel-production.yml
+name: Vercel Production Deployment
+on:
+  push:
+    branches: [main]
+jobs:
+  deploy-production:
+    runs-on: ubuntu-latest
+    environment:
+      name: Production
+      url: https://your-domain.com
+    steps:
+      - uses: actions/checkout@v4
+      - name: Install Vercel CLI
+        run: npm i -g vercel@latest
+      - name: Pull Vercel Environment
+        run: vercel pull --yes --environment=production --token=${{ secrets.VERCEL_TOKEN }}
+      - name: Build Project
+        run: vercel build --prod --token=${{ secrets.VERCEL_TOKEN }}
+      - name: Deploy to Vercel
+        run: vercel deploy --prebuilt --prod --token=${{ secrets.VERCEL_TOKEN }}
+```
+## Function Configuration
+### Memory and Duration
+```json
+{
+  "functions": {
+    "app/api/light/**/*.ts": {
+      "memory": 512,
+      "maxDuration": 10
+    },
+    "app/api/standard/**/*.ts": {
+      "memory": 1024,
+      "maxDuration": 30
+    },
+    "app/api/heavy/**/*.ts": {
+      "memory": 3008,
+      "maxDuration": 60
+    }
+  }
+}
+```
+Memory options: 128, 256, 512, 1024, 2048, 3008 MB
+Duration limits: Hobby (10s), Pro (60s), Enterprise (900s)
+### Cron Jobs
+```json
+{
+  "crons": [
+    {
+      "path": "/api/cron/daily-cleanup",
+      "schedule": "0 0 * * *"
+    },
+    {
+      "path": "/api/cron/hourly-sync",
+      "schedule": "0 * * * *"
+    },
+    {
+      "path": "/api/cron/every-15-min",
+      "schedule": "*/15 * * * *"
+    }
+  ]
+}
+```
+## Monorepo Configuration
+### Turborepo Setup
+```json
+{
+  "buildCommand": "cd ../.. && pnpm turbo build --filter=web",
+  "installCommand": "cd ../.. && pnpm install",
+  "framework": "nextjs",
+  "outputDirectory": "apps/web/.next"
+}
+```
+### Root Configuration
+```json
+{
+  "version": 2,
+  "projects": [
+    {
+      "name": "web",
+      "src": "apps/web"
+    },
+    {
+      "name": "docs",
+      "src": "apps/docs"
+    }
+  ]
+}
+```
+## Domain Configuration
+### Custom Domains
+```bash
+# Add custom domain
+vercel domains add example.com
+# Add subdomain
+vercel domains add api.example.com
+# List domains
+vercel domains ls
+# Remove domain
+vercel domains rm example.com
+```
+### DNS Configuration
+```bash
+# View DNS records
+vercel dns ls example.com
+# Add DNS record
+vercel dns add example.com @ A 76.76.21.21
+# Add CNAME for subdomain
+vercel dns add example.com www CNAME cname.vercel-dns.com
+```
+## Security Configuration
+### Security Headers
+```json
+{
+  "headers": [
+    {
+      "source": "/(.*)",
+      "headers": [
+        { "key": "Strict-Transport-Security", "value": "max-age=63072000; includeSubDomains" },
+        { "key": "X-Content-Type-Options", "value": "nosniff" },
+        { "key": "X-Frame-Options", "value": "DENY" },
+        { "key": "X-XSS-Protection", "value": "1; mode=block" },
+        { "key": "Referrer-Policy", "value": "strict-origin-when-cross-origin" },
+        { "key": "Permissions-Policy", "value": "camera=(), microphone=(), geolocation=()" }
+      ]
+    }
+  ]
+}
+```
+### CORS Configuration
+```json
+{
+  "headers": [
+    {
+      "source": "/api/(.*)",
+      "headers": [
+        { "key": "Access-Control-Allow-Credentials", "value": "true" },
+        { "key": "Access-Control-Allow-Origin", "value": "https://example.com" },
+        { "key": "Access-Control-Allow-Methods", "value": "GET,OPTIONS,PATCH,DELETE,POST,PUT" },
+        { "key": "Access-Control-Allow-Headers", "value": "X-CSRF-Token, X-Requested-With, Accept, Accept-Version, Content-Length, Content-MD5, Content-Type, Date, X-Api-Version" }
+      ]
+    }
+  ]
+}
+```
+## Context7 Integration
+For latest deployment configuration documentation, use:
+- Library: `/vercel/vercel`
+- Topics: vercel.json, environment-variables, deployment
+- Token allocation: 5000-8000 for comprehensive coverage

moai-adk 0.8.0__py3-none-any.whl → 1.1.0__py3-none-any.whl

moai-adk 0.8.0py3-none-any.whl → 1.1.0py3-none-any.whl