@autumnsgrove/groveengine 0.5.0 → 0.6.2

package/README.md

@@ -1,6 +1,8 @@
-# @grove/engine
+# Lattice (@autumnsgrove/groveengine)
 
-Multi-tenant blog engine for the Grove Platform. Each Grove site runs as its own Cloudflare Worker, powered by this engine.
+> **Internal codename:** GroveEngine
+
+Multi-tenant blog engine for the Grove Platform. Each Grove site runs as its own Cloudflare Worker, powered by Lattice. A lattice is the framework that supports growth—vines climb it, gardens are built around it.
 
 ## Features
 
@@ -106,7 +108,7 @@ RESEND_API_KEY=re_xxxxx
 
 ## Fonts
 
-GroveEngine includes self-hosted accessibility-focused fonts in `static/fonts/`. After installing the package, copy the fonts to your project's static directory:
+Lattice includes self-hosted accessibility-focused fonts in `static/fonts/`. After installing the package, copy the fonts to your project's static directory:
 
 ```bash
 # Copy fonts from node_modules to your static folder

package/dist/components/OnboardingChecklist.svelte

@@ -0,0 +1,118 @@
+<script lang="ts">
+	import { Check, Circle, X, Sparkles } from 'lucide-svelte';
+
+	interface ChecklistItem {
+		id: string;
+		label: string;
+		completed: boolean;
+		href?: string;
+	}
+
+	interface Props {
+		items: ChecklistItem[];
+		onDismiss?: () => void;
+		class?: string;
+	}
+
+	let { items, onDismiss, class: className = '' }: Props = $props();
+
+	const completedCount = $derived(items.filter((i) => i.completed).length);
+	const allCompleted = $derived(completedCount === items.length);
+	const progress = $derived((completedCount / items.length) * 100);
+</script>
+
+<div class="bg-surface-elevated border border-default rounded-lg p-4 {className}">
+	<!-- Header -->
+	<div class="flex items-center justify-between mb-4">
+		<div class="flex items-center gap-2">
+			<Sparkles size={18} class="text-primary" />
+			<h3 class="font-medium text-foreground text-sm">Getting Started</h3>
+		</div>
+		{#if onDismiss}
+			<button
+				onclick={onDismiss}
+				class="text-foreground-subtle hover:text-foreground transition-colors"
+				title="Dismiss checklist"
+			>
+				<X size={16} />
+			</button>
+		{/if}
+	</div>
+
+	<!-- Progress bar -->
+	<div class="mb-4">
+		<div class="h-1.5 bg-surface rounded-full overflow-hidden">
+			<div
+				class="h-full bg-primary transition-all duration-500"
+				style="width: {progress}%"
+			></div>
+		</div>
+		<p class="text-xs text-foreground-subtle mt-1">
+			{completedCount} of {items.length} complete
+		</p>
+	</div>
+
+	<!-- Checklist items -->
+	<ul class="space-y-2">
+		{#each items as item}
+			<li>
+				{#if item.href && !item.completed}
+					<a
+						href={item.href}
+						class="flex items-center gap-3 p-2 rounded-md hover:bg-surface transition-colors group"
+					>
+						<div
+							class="w-5 h-5 rounded-full border-2 flex items-center justify-center flex-shrink-0 transition-colors"
+							class:border-primary={item.completed}
+							class:bg-primary={item.completed}
+							class:border-default={!item.completed}
+							class:group-hover:border-primary={!item.completed}
+						>
+							{#if item.completed}
+								<Check size={12} class="text-white" />
+							{/if}
+						</div>
+						<span
+							class="text-sm transition-colors"
+							class:text-foreground-subtle={item.completed}
+							class:line-through={item.completed}
+							class:text-foreground={!item.completed}
+						>
+							{item.label}
+						</span>
+					</a>
+				{:else}
+					<div class="flex items-center gap-3 p-2">
+						<div
+							class="w-5 h-5 rounded-full border-2 flex items-center justify-center flex-shrink-0"
+							class:border-primary={item.completed}
+							class:bg-primary={item.completed}
+							class:border-default={!item.completed}
+						>
+							{#if item.completed}
+								<Check size={12} class="text-white" />
+							{/if}
+						</div>
+						<span
+							class="text-sm"
+							class:text-foreground-subtle={item.completed}
+							class:line-through={item.completed}
+							class:text-foreground={!item.completed}
+						>
+							{item.label}
+						</span>
+					</div>
+				{/if}
+			</li>
+		{/each}
+	</ul>
+
+	<!-- Completion celebration -->
+	{#if allCompleted}
+		<div class="mt-4 p-3 bg-accent rounded-md text-center">
+			<p class="text-sm text-foreground">
+				🎉 All done! You're a Grove pro now.
+			</p>
+		</div>
+	{/if}
+</div>

package/dist/components/OnboardingChecklist.svelte.d.ts

@@ -0,0 +1,14 @@
+interface ChecklistItem {
+    id: string;
+    label: string;
+    completed: boolean;
+    href?: string;
+}
+interface Props {
+    items: ChecklistItem[];
+    onDismiss?: () => void;
+    class?: string;
+}
+declare const OnboardingChecklist: import("svelte").Component<Props, {}, "">;
+type OnboardingChecklist = ReturnType<typeof OnboardingChecklist>;
+export default OnboardingChecklist;

package/dist/components/quota/UpgradePrompt.svelte

@@ -52,10 +52,10 @@
 
   // Safe status with fallback values
   const safeStatus = $derived(isValidStatus ? status : {
-    tier: 'starter' as const,
+    tier: 'seedling' as const,
     post_count: 0,
-    post_limit: 250,
-    posts_remaining: 250,
+    post_limit: 50,
+    posts_remaining: 50,
     percentage_used: 0,
     is_at_limit: false,
     is_in_grace_period: false,
@@ -73,8 +73,9 @@
 
   // Tier upgrade path
   const nextTier = $derived(
-    safeStatus.tier === 'starter' ? 'professional' :
-    safeStatus.tier === 'professional' ? 'business' :
+    safeStatus.tier === 'seedling' ? 'sapling' :
+    safeStatus.tier === 'sapling' ? 'oak' :
+    safeStatus.tier === 'oak' ? 'evergreen' :
     null
   );
 
@@ -237,8 +238,8 @@
               <div>
                 <p class="font-medium text-blue-900 dark:text-blue-100">{nextTierName} Plan</p>
                 <p class="text-sm text-blue-700 dark:text-blue-300">
-                  {#if nextTier === 'professional'}
-                    Up to 2,000 posts
+                  {#if nextTier === 'sapling'}
+                    Up to 250 posts
                   {:else}
                     Unlimited posts
                   {/if}

package/dist/groveauth/limits.js

@@ -75,7 +75,7 @@ export function getSuggestedActions(status) {
  */
 export function getUpgradeRecommendation(status) {
     const tierName = TIER_NAMES[status.tier];
-    if (status.tier === 'business') {
+    if (status.tier === 'evergreen') {
         return {
             recommended: false,
             fromTier: tierName,
@@ -83,8 +83,16 @@ export function getUpgradeRecommendation(status) {
             reason: 'You have the highest tier with unlimited posts',
         };
     }
+    if (status.tier === 'oak') {
+        return {
+            recommended: false,
+            fromTier: tierName,
+            toTier: 'Evergreen',
+            reason: 'You already have unlimited posts. Evergreen adds domain search and support hours.',
+        };
+    }
     if (status.upgrade_required || status.is_at_limit) {
-        const toTier = status.tier === 'starter' ? 'Professional' : 'Business';
+        const toTier = status.tier === 'seedling' ? 'Sapling' : 'Oak';
         return {
             recommended: true,
             fromTier: tierName,
@@ -93,7 +101,7 @@ export function getUpgradeRecommendation(status) {
         };
     }
     if (status.percentage_used !== null && status.percentage_used >= 80) {
-        const toTier = status.tier === 'starter' ? 'Professional' : 'Business';
+        const toTier = status.tier === 'seedling' ? 'Sapling' : 'Oak';
         return {
             recommended: true,
             fromTier: tierName,

package/dist/groveauth/types.d.ts

@@ -41,7 +41,7 @@ export interface LoginUrlResult {
     state: string;
     codeVerifier: string;
 }
-export type SubscriptionTier = "starter" | "professional" | "business";
+export type SubscriptionTier = "seedling" | "sapling" | "oak" | "evergreen";
 export interface UserSubscription {
     id: string;
     user_id: string;
@@ -84,12 +84,14 @@ export interface CanPostResponse {
  * Post limits per subscription tier.
  *
  * Business rationale:
- * - Starter (250 posts): Entry-level tier for hobbyists, personal bloggers,
- *   and users testing the platform. ~1 post/day for 8 months.
- * - Professional (2,000 posts): For active content creators, small businesses,
- *   and dedicated bloggers. ~1 post/day for 5+ years.
- * - Business (unlimited): For enterprises, agencies, and power users who need
- *   no restrictions. Includes custom domain support.
+ * - Seedling (50 posts): Entry-level tier for curious newcomers testing the
+ *   platform. Low commitment, creates upgrade path.
+ * - Sapling (250 posts): For hobbyists and regular bloggers who know they'll
+ *   stick around. ~1 post/day for 8 months.
+ * - Oak (unlimited): For serious bloggers whose blog is part of their
+ *   identity. Includes BYOD (bring your own domain) and full email.
+ * - Evergreen (unlimited): Full-service tier for professionals. Includes domain
+ *   search, registration, and priority support.
  *
  * Grace period: When users hit their limit, they have 14 days to upgrade or
  * delete posts before their account becomes read-only.

package/dist/groveauth/types.js

@@ -10,12 +10,14 @@
  * Post limits per subscription tier.
  *
  * Business rationale:
- * - Starter (250 posts): Entry-level tier for hobbyists, personal bloggers,
- *   and users testing the platform. ~1 post/day for 8 months.
- * - Professional (2,000 posts): For active content creators, small businesses,
- *   and dedicated bloggers. ~1 post/day for 5+ years.
- * - Business (unlimited): For enterprises, agencies, and power users who need
- *   no restrictions. Includes custom domain support.
+ * - Seedling (50 posts): Entry-level tier for curious newcomers testing the
+ *   platform. Low commitment, creates upgrade path.
+ * - Sapling (250 posts): For hobbyists and regular bloggers who know they'll
+ *   stick around. ~1 post/day for 8 months.
+ * - Oak (unlimited): For serious bloggers whose blog is part of their
+ *   identity. Includes BYOD (bring your own domain) and full email.
+ * - Evergreen (unlimited): Full-service tier for professionals. Includes domain
+ *   search, registration, and priority support.
  *
  * Grace period: When users hit their limit, they have 14 days to upgrade or
  * delete posts before their account becomes read-only.
@@ -23,17 +25,19 @@
  * @see docs/implementing-post-limits.md for full specification
  */
 export const TIER_POST_LIMITS = {
-    starter: 250, // For hobbyists and personal blogs
-    professional: 2000, // For active bloggers and small businesses
-    business: null, // Unlimited for enterprises and power users
+    seedling: 50, // For curious newcomers trying blogging
+    sapling: 250, // For hobbyists and regular bloggers
+    oak: null, // Unlimited for serious bloggers
+    evergreen: null, // Unlimited for professionals
 };
 /**
  * Human-readable tier names for UI display.
  */
 export const TIER_NAMES = {
-    starter: "Starter",
-    professional: "Professional",
-    business: "Business",
+    seedling: "Seedling",
+    sapling: "Sapling",
+    oak: "Oak",
+    evergreen: "Evergreen",
 };
 /**
  * Client-side error class for GroveAuth operations.

package/dist/payments/types.d.ts

@@ -227,21 +227,26 @@ export interface ConnectOnboardingResult {
     onboardingUrl: string;
     expiresAt?: Date;
 }
-export type PlanTier = 'starter' | 'professional' | 'business';
+export type PlanTier = 'seedling' | 'sapling' | 'oak' | 'evergreen';
 export interface PlatformPlan {
     tier: PlanTier;
     name: string;
     price: Money;
+    yearlyPrice?: Money;
     interval: BillingInterval;
     features: string[];
     limits: {
         posts?: number;
         storage?: number;
         customDomain?: boolean;
-        analytics?: boolean;
+        byod?: boolean;
+        email?: 'none' | 'forward' | 'full';
+        analytics?: 'basic' | 'full';
+        supportHours?: number;
         shop?: boolean;
     };
     providerPriceId?: string;
+    yearlyPriceId?: string;
 }
 export interface TenantBilling {
     tenantId: string;

package/dist/server/services/__mocks__/cloudflare.d.ts

@@ -0,0 +1,54 @@
+/**
+ * Mock implementations for Cloudflare services (D1, KV, R2)
+ * Used for testing the service abstraction layer
+ */
+interface MockRow {
+    [key: string]: unknown;
+}
+/**
+ * Creates a mock D1 database with in-memory storage
+ */
+export declare function createMockD1(): D1Database & {
+    _tables: Map<string, MockRow[]>;
+};
+interface KVEntry {
+    value: string;
+    expiresAt?: number;
+    metadata?: unknown;
+}
+/**
+ * Creates a mock KV namespace with in-memory storage
+ */
+export declare function createMockKV(): KVNamespace & {
+    _store: Map<string, KVEntry>;
+};
+interface R2Entry {
+    body: ArrayBuffer;
+    httpMetadata?: {
+        contentType?: string;
+        cacheControl?: string;
+    };
+    customMetadata?: Record<string, string>;
+    etag: string;
+    uploaded: Date;
+    size: number;
+}
+/**
+ * Creates a mock R2 bucket with in-memory storage
+ */
+export declare function createMockR2(): R2Bucket & {
+    _objects: Map<string, R2Entry>;
+};
+/**
+ * Seed a mock D1 database with initial data
+ */
+export declare function seedMockD1(db: ReturnType<typeof createMockD1>, tableName: string, rows: MockRow[]): void;
+/**
+ * Clear all data from a mock D1 database
+ */
+export declare function clearMockD1(db: ReturnType<typeof createMockD1>): void;
+/**
+ * Advance time for KV expiration testing
+ */
+export declare function advanceKVTime(kv: ReturnType<typeof createMockKV>, ms: number): void;
+export {};