mirror of
https://github.com/Memo-2023/mana-monorepo.git
synced 2026-05-18 00:29:40 +02:00
851a281e5a
Zitare was opaque Latin/Italian-flavored branding. Renamed to clear English "quotes" (DE: Zitate) matching short-concrete-noun cluster. - Module, routes, API, i18n, standalone landing app, plans dirs - Dexie tables: quotesFavorites, quotesLists, quotesListTags, customQuotes (dropped redundant "quotes" prefix on the last) - Logo QuotesLogo, theme quotes.css, search provider, dashboard widget QuoteWidget - German user-facing label "Zitate" (English brand stays Quotes) Pre-launch, no data migration needed. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
496 lines
13 KiB
TypeScript
496 lines
13 KiB
TypeScript
/**
|
|
* @mana/credit-operations
|
|
*
|
|
* Central credit operation definitions for all Mana apps.
|
|
* This package defines operation types, costs, and helper functions
|
|
* for the unified credit system across the ecosystem.
|
|
*/
|
|
|
|
// ============================================================================
|
|
// Operation Types
|
|
// ============================================================================
|
|
|
|
/**
|
|
* All credit operations across the Mana ecosystem.
|
|
* Operations are categorized by type: AI, productivity (micro), and premium.
|
|
*/
|
|
export enum CreditOperationType {
|
|
// -------------------------------------------------------------------------
|
|
// AI Operations (Standard Credits: 1-30)
|
|
// -------------------------------------------------------------------------
|
|
|
|
// Chat - AI conversations
|
|
AI_CHAT_GPT4 = 'ai_chat_gpt4',
|
|
AI_CHAT_CLAUDE = 'ai_chat_claude',
|
|
AI_CHAT_GEMINI = 'ai_chat_gemini',
|
|
AI_CHAT_QWEN = 'ai_chat_qwen',
|
|
AI_CHAT_OLLAMA = 'ai_chat_ollama',
|
|
|
|
// Picture - Image generation
|
|
AI_IMAGE_GENERATION = 'ai_image_generation',
|
|
AI_IMAGE_UPSCALE = 'ai_image_upscale',
|
|
|
|
// Questions - Research
|
|
AI_RESEARCH_QUICK = 'ai_research_quick',
|
|
AI_RESEARCH_DEEP = 'ai_research_deep',
|
|
|
|
// Food - Food analysis
|
|
AI_FOOD_ANALYSIS = 'ai_food_analysis',
|
|
|
|
// Cards - AI deck generation
|
|
AI_DECK_GENERATION = 'ai_deck_generation',
|
|
AI_CARD_GENERATION = 'ai_card_generation',
|
|
|
|
// Quotes - AI explanations
|
|
AI_QUOTE_EXPLANATION = 'ai_quote_explanation',
|
|
|
|
// Plants - Plant analysis
|
|
AI_PLANT_ANALYSIS = 'ai_plant_analysis',
|
|
|
|
// Traces - City guide generation
|
|
AI_GUIDE_GENERATION = 'ai_guide_generation',
|
|
|
|
// Context - AI text generation
|
|
AI_CONTEXT_GENERATION = 'ai_context_generation',
|
|
|
|
// General AI features
|
|
AI_SMART_SCHEDULING = 'ai_smart_scheduling',
|
|
AI_SUGGESTIONS = 'ai_suggestions',
|
|
AI_ENRICHMENT = 'ai_enrichment',
|
|
|
|
// -------------------------------------------------------------------------
|
|
// Premium Features (Standard Credits: 0.5-5)
|
|
// -------------------------------------------------------------------------
|
|
|
|
// Sync
|
|
CLOUD_SYNC = 'cloud_sync',
|
|
|
|
// Import/Export
|
|
BULK_IMPORT = 'bulk_import',
|
|
PDF_EXPORT = 'pdf_export',
|
|
|
|
// Premium themes
|
|
PREMIUM_THEME = 'premium_theme',
|
|
}
|
|
|
|
// ============================================================================
|
|
// Credit Costs
|
|
// ============================================================================
|
|
|
|
/**
|
|
* Credit costs for each operation type.
|
|
* Costs are in Credits (decimal values supported for micro-credits).
|
|
*/
|
|
export const CREDIT_COSTS: Record<CreditOperationType, number> = {
|
|
// AI Operations (Standard Credits)
|
|
[CreditOperationType.AI_CHAT_GPT4]: 5,
|
|
[CreditOperationType.AI_CHAT_CLAUDE]: 5,
|
|
[CreditOperationType.AI_CHAT_GEMINI]: 2,
|
|
[CreditOperationType.AI_CHAT_QWEN]: 2,
|
|
[CreditOperationType.AI_CHAT_OLLAMA]: 0.1,
|
|
|
|
[CreditOperationType.AI_IMAGE_GENERATION]: 10,
|
|
[CreditOperationType.AI_IMAGE_UPSCALE]: 5,
|
|
|
|
[CreditOperationType.AI_RESEARCH_QUICK]: 5,
|
|
[CreditOperationType.AI_RESEARCH_DEEP]: 25,
|
|
|
|
[CreditOperationType.AI_FOOD_ANALYSIS]: 3,
|
|
|
|
[CreditOperationType.AI_DECK_GENERATION]: 20,
|
|
[CreditOperationType.AI_CARD_GENERATION]: 2,
|
|
|
|
[CreditOperationType.AI_QUOTE_EXPLANATION]: 2,
|
|
|
|
[CreditOperationType.AI_PLANT_ANALYSIS]: 2,
|
|
[CreditOperationType.AI_GUIDE_GENERATION]: 5,
|
|
[CreditOperationType.AI_CONTEXT_GENERATION]: 2,
|
|
|
|
[CreditOperationType.AI_SMART_SCHEDULING]: 2,
|
|
[CreditOperationType.AI_SUGGESTIONS]: 2,
|
|
[CreditOperationType.AI_ENRICHMENT]: 2,
|
|
|
|
// Premium Features
|
|
[CreditOperationType.CLOUD_SYNC]: 30, // Monthly (or 90/quarterly, 360/yearly)
|
|
|
|
[CreditOperationType.BULK_IMPORT]: 0.2, // Per 10 items
|
|
[CreditOperationType.PDF_EXPORT]: 1,
|
|
|
|
[CreditOperationType.PREMIUM_THEME]: 3,
|
|
};
|
|
|
|
// ============================================================================
|
|
// Operation Metadata
|
|
// ============================================================================
|
|
|
|
/**
|
|
* Category of credit operation for grouping and display.
|
|
*/
|
|
export enum CreditCategory {
|
|
AI = 'ai',
|
|
PREMIUM = 'premium',
|
|
}
|
|
|
|
/**
|
|
* Metadata about each operation for UI display and documentation.
|
|
*/
|
|
export interface OperationMetadata {
|
|
/** Human-readable name */
|
|
name: string;
|
|
/** Description for tooltips/help */
|
|
description: string;
|
|
/** Category for grouping */
|
|
category: CreditCategory;
|
|
/** Which app this operation belongs to */
|
|
app: string;
|
|
/** Is this a per-item cost (e.g., bulk import per 10 items) */
|
|
perItem?: boolean;
|
|
/** Item unit name if perItem is true */
|
|
itemUnit?: string;
|
|
}
|
|
|
|
/**
|
|
* Metadata for all operations.
|
|
*/
|
|
export const OPERATION_METADATA: Record<CreditOperationType, OperationMetadata> = {
|
|
// AI Chat
|
|
[CreditOperationType.AI_CHAT_GPT4]: {
|
|
name: 'GPT-4 Message',
|
|
description: 'Send a message using GPT-4 or GPT-4o',
|
|
category: CreditCategory.AI,
|
|
app: 'chat',
|
|
},
|
|
[CreditOperationType.AI_CHAT_CLAUDE]: {
|
|
name: 'Claude Message',
|
|
description: 'Send a message using Claude (Anthropic)',
|
|
category: CreditCategory.AI,
|
|
app: 'chat',
|
|
},
|
|
[CreditOperationType.AI_CHAT_GEMINI]: {
|
|
name: 'Gemini Message',
|
|
description: 'Send a message using Google Gemini',
|
|
category: CreditCategory.AI,
|
|
app: 'chat',
|
|
},
|
|
[CreditOperationType.AI_CHAT_QWEN]: {
|
|
name: 'Qwen Message',
|
|
description: 'Send a message using Qwen',
|
|
category: CreditCategory.AI,
|
|
app: 'chat',
|
|
},
|
|
[CreditOperationType.AI_CHAT_OLLAMA]: {
|
|
name: 'Ollama Message (Local)',
|
|
description: 'Send a message using local Ollama models',
|
|
category: CreditCategory.AI,
|
|
app: 'chat',
|
|
},
|
|
|
|
// Image Generation
|
|
[CreditOperationType.AI_IMAGE_GENERATION]: {
|
|
name: 'Generate Image',
|
|
description: 'Generate an AI image',
|
|
category: CreditCategory.AI,
|
|
app: 'picture',
|
|
},
|
|
[CreditOperationType.AI_IMAGE_UPSCALE]: {
|
|
name: 'Upscale Image',
|
|
description: 'Upscale an image to higher resolution',
|
|
category: CreditCategory.AI,
|
|
app: 'picture',
|
|
},
|
|
|
|
// Research
|
|
[CreditOperationType.AI_RESEARCH_QUICK]: {
|
|
name: 'Quick Research',
|
|
description: 'Quick research with 5 sources',
|
|
category: CreditCategory.AI,
|
|
app: 'questions',
|
|
},
|
|
[CreditOperationType.AI_RESEARCH_DEEP]: {
|
|
name: 'Deep Research',
|
|
description: 'Comprehensive research with 30+ sources',
|
|
category: CreditCategory.AI,
|
|
app: 'questions',
|
|
},
|
|
|
|
// Food Analysis
|
|
[CreditOperationType.AI_FOOD_ANALYSIS]: {
|
|
name: 'Analyze Food Photo',
|
|
description: 'Analyze nutrition from a food photo',
|
|
category: CreditCategory.AI,
|
|
app: 'food',
|
|
},
|
|
|
|
// Deck Generation
|
|
[CreditOperationType.AI_DECK_GENERATION]: {
|
|
name: 'Generate AI Deck',
|
|
description: 'Generate a complete deck with AI (10 cards)',
|
|
category: CreditCategory.AI,
|
|
app: 'cards',
|
|
},
|
|
[CreditOperationType.AI_CARD_GENERATION]: {
|
|
name: 'Generate AI Card',
|
|
description: 'Generate a single card with AI',
|
|
category: CreditCategory.AI,
|
|
app: 'cards',
|
|
},
|
|
|
|
// Quote Explanation
|
|
[CreditOperationType.AI_QUOTE_EXPLANATION]: {
|
|
name: 'Explain Quote',
|
|
description: 'Get an AI explanation of a quote',
|
|
category: CreditCategory.AI,
|
|
app: 'quotes',
|
|
},
|
|
|
|
// Plants
|
|
[CreditOperationType.AI_PLANT_ANALYSIS]: {
|
|
name: 'Plant Analysis',
|
|
description: 'Identify and analyze a plant from a photo',
|
|
category: CreditCategory.AI,
|
|
app: 'plants',
|
|
},
|
|
|
|
// Traces
|
|
[CreditOperationType.AI_GUIDE_GENERATION]: {
|
|
name: 'City Guide Generation',
|
|
description: 'Generate an AI-powered city walking guide',
|
|
category: CreditCategory.AI,
|
|
app: 'traces',
|
|
},
|
|
|
|
// Context
|
|
[CreditOperationType.AI_CONTEXT_GENERATION]: {
|
|
name: 'AI Text Generation',
|
|
description: 'Generate or transform text with AI',
|
|
category: CreditCategory.AI,
|
|
app: 'context',
|
|
},
|
|
|
|
// General AI
|
|
[CreditOperationType.AI_SMART_SCHEDULING]: {
|
|
name: 'Smart Scheduling',
|
|
description: 'AI-powered task scheduling suggestions',
|
|
category: CreditCategory.AI,
|
|
app: 'todo',
|
|
},
|
|
[CreditOperationType.AI_SUGGESTIONS]: {
|
|
name: 'AI Suggestions',
|
|
description: 'Get AI-powered suggestions',
|
|
category: CreditCategory.AI,
|
|
app: 'general',
|
|
},
|
|
[CreditOperationType.AI_ENRICHMENT]: {
|
|
name: 'AI Enrichment',
|
|
description: 'Enrich data with AI-gathered information',
|
|
category: CreditCategory.AI,
|
|
app: 'contacts',
|
|
},
|
|
|
|
// Premium - Sync
|
|
[CreditOperationType.CLOUD_SYNC]: {
|
|
name: 'Cloud Sync',
|
|
description: 'Cloud-Synchronisation über alle Geräte (30 Credits/Monat)',
|
|
category: CreditCategory.PREMIUM,
|
|
app: 'general',
|
|
},
|
|
|
|
// Premium - Import/Export
|
|
[CreditOperationType.BULK_IMPORT]: {
|
|
name: 'Bulk Import',
|
|
description: 'Import items in bulk',
|
|
category: CreditCategory.PREMIUM,
|
|
app: 'general',
|
|
perItem: true,
|
|
itemUnit: '10 items',
|
|
},
|
|
[CreditOperationType.PDF_EXPORT]: {
|
|
name: 'PDF Export',
|
|
description: 'Export to PDF format',
|
|
category: CreditCategory.PREMIUM,
|
|
app: 'presi',
|
|
},
|
|
|
|
// Premium - Themes
|
|
[CreditOperationType.PREMIUM_THEME]: {
|
|
name: 'Premium Theme',
|
|
description: 'Use a premium theme',
|
|
category: CreditCategory.PREMIUM,
|
|
app: 'presi',
|
|
},
|
|
};
|
|
|
|
// ============================================================================
|
|
// Helper Functions
|
|
// ============================================================================
|
|
|
|
/**
|
|
* Get the credit cost for an operation.
|
|
* @param operation The operation type
|
|
* @returns The cost in credits
|
|
*/
|
|
export function getCreditCost(operation: CreditOperationType): number {
|
|
return CREDIT_COSTS[operation];
|
|
}
|
|
|
|
/**
|
|
* Get the metadata for an operation.
|
|
* @param operation The operation type
|
|
* @returns Operation metadata
|
|
*/
|
|
export function getOperationMetadata(operation: CreditOperationType): OperationMetadata {
|
|
return OPERATION_METADATA[operation];
|
|
}
|
|
|
|
/**
|
|
* Get all operations for a specific app.
|
|
* @param app The app name (e.g., 'chat', 'todo', 'calendar')
|
|
* @returns Array of operations for that app
|
|
*/
|
|
export function getOperationsForApp(app: string): CreditOperationType[] {
|
|
return Object.entries(OPERATION_METADATA)
|
|
.filter(([, meta]) => meta.app === app)
|
|
.map(([op]) => op as CreditOperationType);
|
|
}
|
|
|
|
/**
|
|
* Get all operations in a specific category.
|
|
* @param category The category
|
|
* @returns Array of operations in that category
|
|
*/
|
|
export function getOperationsByCategory(category: CreditCategory): CreditOperationType[] {
|
|
return Object.entries(OPERATION_METADATA)
|
|
.filter(([, meta]) => meta.category === category)
|
|
.map(([op]) => op as CreditOperationType);
|
|
}
|
|
|
|
/**
|
|
* Calculate total cost for bulk operations.
|
|
* @param operation The operation type
|
|
* @param count Number of items
|
|
* @returns Total cost in credits
|
|
*/
|
|
export function calculateBulkCost(operation: CreditOperationType, count: number): number {
|
|
const cost = CREDIT_COSTS[operation];
|
|
const meta = OPERATION_METADATA[operation];
|
|
|
|
if (meta.perItem) {
|
|
// For bulk operations, cost is per batch (e.g., per 10 items)
|
|
return Math.ceil(count / 10) * cost;
|
|
}
|
|
|
|
return cost * count;
|
|
}
|
|
|
|
/**
|
|
* Check if an operation is considered "free" (no credit cost).
|
|
* @param operation The operation type
|
|
* @returns True if the operation is free
|
|
*/
|
|
export function isFreeOperation(operation: CreditOperationType): boolean {
|
|
return CREDIT_COSTS[operation] === 0;
|
|
}
|
|
|
|
/**
|
|
* Check if an operation is an AI operation.
|
|
* @param operation The operation type
|
|
* @returns True if AI operation
|
|
*/
|
|
export function isAiOperation(operation: CreditOperationType): boolean {
|
|
return OPERATION_METADATA[operation].category === CreditCategory.AI;
|
|
}
|
|
|
|
/**
|
|
* Format credit cost for display.
|
|
* @param cost The credit cost
|
|
* @returns Formatted string (e.g., "0.02" or "5")
|
|
*/
|
|
export function formatCreditCost(cost: number): string {
|
|
if (cost === 0) return 'Free';
|
|
if (cost < 1) return cost.toFixed(2);
|
|
return cost.toString();
|
|
}
|
|
|
|
/**
|
|
* Get a pricing table for an app (for display in UI).
|
|
* @param app The app name
|
|
* @returns Array of pricing entries
|
|
*/
|
|
export function getPricingTable(app: string): Array<{
|
|
operation: CreditOperationType;
|
|
name: string;
|
|
description: string;
|
|
cost: number;
|
|
formattedCost: string;
|
|
category: CreditCategory;
|
|
}> {
|
|
return getOperationsForApp(app).map((op) => {
|
|
const meta = OPERATION_METADATA[op];
|
|
const cost = CREDIT_COSTS[op];
|
|
return {
|
|
operation: op,
|
|
name: meta.name,
|
|
description: meta.description,
|
|
cost,
|
|
formattedCost: formatCreditCost(cost),
|
|
category: meta.category,
|
|
};
|
|
});
|
|
}
|
|
|
|
// ============================================================================
|
|
// Free Operations List
|
|
// ============================================================================
|
|
|
|
/**
|
|
* Operations that are always free (no credit cost).
|
|
* These are read operations, status checks, and engagement actions.
|
|
*/
|
|
export const FREE_OPERATIONS = [
|
|
// Reading/viewing
|
|
'read',
|
|
'view',
|
|
'list',
|
|
'get',
|
|
'search',
|
|
'browse',
|
|
|
|
// Task completion (engagement)
|
|
'complete',
|
|
'check',
|
|
'toggle',
|
|
|
|
// Editing (no new resource creation)
|
|
'update',
|
|
'edit',
|
|
'modify',
|
|
|
|
// Deletion
|
|
'delete',
|
|
'remove',
|
|
'archive',
|
|
|
|
// Organization
|
|
'sort',
|
|
'filter',
|
|
'move',
|
|
'reorder',
|
|
|
|
// Metadata
|
|
'tag',
|
|
'label',
|
|
'favorite',
|
|
'unfavorite',
|
|
] as const;
|
|
|
|
/**
|
|
* Check if an action name represents a free operation.
|
|
* @param action The action name (e.g., 'update', 'delete')
|
|
* @returns True if the action is free
|
|
*/
|
|
export function isFreeAction(action: string): boolean {
|
|
const normalizedAction = action.toLowerCase();
|
|
return FREE_OPERATIONS.some(
|
|
(freeOp) => normalizedAction === freeOp || normalizedAction.startsWith(`${freeOp}_`)
|
|
);
|
|
}
|