business-as-code 2.1.1 → 2.1.3

package/src/canvas/types.ts

@@ -0,0 +1,363 @@
+/**
+ * Business Model Canvas Types
+ *
+ * TypeScript types for the 9 building blocks of the Business Model Canvas
+ * plus unit economics and financial projections.
+ */
+
+// =============================================================================
+// Customer Segments
+// =============================================================================
+
+export type CustomerSegmentType =
+  | 'mass-market'
+  | 'niche'
+  | 'segmented'
+  | 'diversified'
+  | 'multi-sided'
+
+export interface CustomerSegment {
+  name: string
+  description?: string
+  type: CustomerSegmentType
+  characteristics?: string[]
+  size?: number
+  revenuePerCustomer?: number
+  expectedPenetration?: number
+  potential?: number
+}
+
+// =============================================================================
+// Value Propositions
+// =============================================================================
+
+export type ValueType =
+  | 'newness'
+  | 'performance'
+  | 'customization'
+  | 'getting-job-done'
+  | 'design'
+  | 'brand-status'
+  | 'price'
+  | 'cost-reduction'
+  | 'risk-reduction'
+  | 'accessibility'
+  | 'convenience'
+
+export interface ValueProposition {
+  name: string
+  description?: string
+  valueType?: ValueType
+  benefits: string[]
+  targetSegments?: string[]
+  quantifiedValue?: string
+  segmentFit?: Record<string, number>
+}
+
+// =============================================================================
+// Channels
+// =============================================================================
+
+export type ChannelType = 'direct' | 'indirect' | 'partner' | 'digital'
+
+export type ChannelPhase =
+  | 'awareness'
+  | 'evaluation'
+  | 'purchase'
+  | 'delivery'
+  | 'support'
+
+export interface Channel {
+  name: string
+  type: ChannelType
+  phases?: ChannelPhase[]
+  costPerAcquisition?: number
+  partnerType?: string
+  revenueShare?: number
+  conversionRate?: number
+}
+
+// =============================================================================
+// Customer Relationships
+// =============================================================================
+
+export type RelationshipType =
+  | 'personal-assistance'
+  | 'dedicated-assistance'
+  | 'self-service'
+  | 'automated'
+  | 'community'
+  | 'co-creation'
+
+export interface CustomerRelationship {
+  name: string
+  type: RelationshipType
+  segment?: string
+  touchFrequency?: string
+  automationLevel?: number
+  supportChannels?: string[]
+  platforms?: string[]
+}
+
+// =============================================================================
+// Revenue Streams
+// =============================================================================
+
+export type RevenueType = 'recurring' | 'one-time' | 'transaction'
+
+export type PricingModel =
+  | 'subscription'
+  | 'usage-based'
+  | 'tiered'
+  | 'freemium'
+  | 'fixed'
+  | 'dynamic'
+  | 'auction'
+  | 'licensing'
+
+export interface PricingTier {
+  name: string
+  price: number
+  features?: string[]
+}
+
+export interface RevenueStream {
+  name: string
+  type: RevenueType
+  pricingModel: PricingModel
+  price?: number
+  billingCycle?: 'monthly' | 'quarterly' | 'annual'
+  pricePerUnit?: number
+  unitName?: string
+  tiers?: PricingTier[]
+  activeCustomers?: number
+  annualRevenue?: number
+}
+
+// =============================================================================
+// Key Resources
+// =============================================================================
+
+export type ResourceType = 'physical' | 'intellectual' | 'human' | 'financial'
+
+export interface KeyResource {
+  name: string
+  type: ResourceType
+  cost?: number
+  depreciation?: string
+  protectionType?: string
+  headcount?: number
+  averageCost?: number
+  totalCost?: number
+}
+
+// =============================================================================
+// Key Activities
+// =============================================================================
+
+export type ActivityCategory = 'production' | 'problem-solving' | 'platform'
+
+export interface KeyActivity {
+  name: string
+  category: ActivityCategory
+  description?: string
+  resources?: string[]
+  metrics?: string[]
+  uptime?: number
+}
+
+// =============================================================================
+// Key Partnerships
+// =============================================================================
+
+export type PartnershipType =
+  | 'strategic-alliance'
+  | 'coopetition'
+  | 'joint-venture'
+  | 'buyer-supplier'
+
+export interface KeyPartnership {
+  name: string
+  type: PartnershipType
+  purpose?: string
+  benefits?: string[]
+  contractValue?: number
+  contractTerm?: number
+  sharedActivities?: string[]
+}
+
+// =============================================================================
+// Cost Structure
+// =============================================================================
+
+export type CostCategory = 'fixed' | 'variable' | 'semi-variable'
+
+export interface CostItem {
+  name: string
+  category: CostCategory
+  amount?: number
+  period?: 'monthly' | 'quarterly' | 'annual'
+  unitCost?: number
+  unitName?: string
+  volumeEstimate?: number
+  estimatedTotal?: number
+}
+
+// =============================================================================
+// Business Model Canvas
+// =============================================================================
+
+export interface BusinessModelCanvas {
+  name: string
+  customerSegments: CustomerSegment[]
+  valuePropositions: ValueProposition[]
+  channels: Channel[]
+  customerRelationships: CustomerRelationship[]
+  revenueStreams: RevenueStream[]
+  keyResources: KeyResource[]
+  keyActivities: KeyActivity[]
+  keyPartnerships: KeyPartnership[]
+  costStructure: CostItem[]
+  metadata?: Record<string, unknown>
+}
+
+export interface CanvasValidation {
+  isComplete: boolean
+  missingBlocks: string[]
+  warnings: string[]
+}
+
+export interface CanvasSummary {
+  totalAddressableMarket: number
+  projectedAnnualRevenue: number
+  totalAnnualCosts: number
+  projectedProfit: number
+}
+
+// =============================================================================
+// Unit Economics
+// =============================================================================
+
+export interface UnitEconomics {
+  ltv: number
+  cac: number
+  ltvCacRatio: number
+  paybackMonths: number
+}
+
+export interface LTVInput {
+  averageRevenuePerUser: number
+  grossMargin: number
+  churnRate: number
+}
+
+export interface CACInput {
+  marketingSpend: number
+  salesSpend: number
+  newCustomers: number
+}
+
+export interface UnitEconomicsInput extends LTVInput, CACInput {}
+
+export interface Margins {
+  grossMargin: number
+  grossProfit: number
+  operatingMargin: number
+  operatingIncome: number
+  netMargin: number
+  netIncome: number
+}
+
+export interface MarginsInput {
+  revenue: number
+  cogs: number
+  operatingExpenses: number
+  taxes?: number
+}
+
+// =============================================================================
+// Financial Projections
+// =============================================================================
+
+export interface MonthlyRevenue {
+  month: number
+  mrr: number
+  arr: number
+}
+
+export interface RevenueProjection {
+  months: MonthlyRevenue[]
+  endingMRR: number
+  endingARR: number
+}
+
+export interface MonthlyCost {
+  month: number
+  fixedCosts: number
+  variableCosts: number
+  totalCost: number
+}
+
+export interface CostProjection {
+  months: MonthlyCost[]
+  totalCosts: number
+}
+
+export interface MonthlyProfitability {
+  month: number
+  revenue: number
+  costs: number
+  profit: number
+  cumulativeProfit: number
+}
+
+export interface ProfitabilityProjection {
+  months: MonthlyProfitability[]
+  breakEvenMonth: number | undefined
+  totalProfit: number
+}
+
+export interface RevenueProjectionInput {
+  startingMRR: number
+  monthlyGrowthRate: number
+  months: number
+}
+
+export interface CostProjectionInput {
+  fixedCosts: number
+  variableCostPerUser: number
+  startingUsers: number
+  monthlyUserGrowth: number
+  months: number
+}
+
+export interface ProfitabilityProjectionInput {
+  startingMRR: number
+  monthlyGrowthRate: number
+  fixedCosts: number
+  grossMargin: number
+  months: number
+}
+
+// =============================================================================
+// Canvas Analysis
+// =============================================================================
+
+export interface CanvasStrengthAnalysis {
+  overallScore: number
+  strengths: string[]
+  weaknesses: string[]
+  blockScores: Record<string, number>
+}
+
+export interface CanvasGaps {
+  criticalGaps: string[]
+  warnings: string[]
+  recommendations: string[]
+}
+
+export interface FinancialProjection {
+  revenue: RevenueProjection
+  costs: CostProjection
+  profitability: ProfitabilityProjection
+}

package/src/canvas/value.ts

@@ -0,0 +1,34 @@
+/**
+ * Value Propositions
+ *
+ * Functions for creating and working with value propositions.
+ */
+
+import type { ValueProposition, ValueType } from './types.js'
+
+export interface CreateValuePropositionInput {
+  name: string
+  description?: string
+  valueType?: ValueType
+  benefits?: string[]
+  targetSegments?: string[]
+  quantifiedValue?: string
+  segmentFit?: Record<string, number>
+}
+
+/**
+ * Create a value proposition
+ */
+export function createValueProposition(input: CreateValuePropositionInput): ValueProposition {
+  const { name, description, valueType, benefits = [], targetSegments, quantifiedValue, segmentFit } = input
+
+  return {
+    name,
+    description,
+    valueType,
+    benefits,
+    targetSegments,
+    quantifiedValue,
+    segmentFit,
+  }
+}