@autumnsgrove/groveengine 0.9.3 → 0.9.4

package/dist/config/tiers.js

@@ -0,0 +1,402 @@
+/**
+ * Unified Tier Configuration
+ *
+ * Single source of truth for all tier-related data across the Grove ecosystem.
+ * This file consolidates feature limits, rate limits, pricing, and display info.
+ *
+ * Tier progression:
+ * - free: Meadow-only (no blog) - coming soon
+ * - seedling: $8/mo entry tier
+ * - sapling: $12/mo mid tier - coming soon
+ * - oak: $25/mo with BYOD domain - future
+ * - evergreen: $35/mo full service - future
+ */
+// =============================================================================
+// TIER DEFINITIONS
+// =============================================================================
+export const TIERS = {
+    free: {
+        id: "free",
+        order: 0,
+        status: "coming_soon",
+        limits: {
+            posts: 0,
+            storage: 0,
+            themes: 0,
+            navPages: 0,
+            commentsPerWeek: 20,
+        },
+        features: {
+            blog: false,
+            meadow: true,
+            emailForwarding: false,
+            fullEmail: false,
+            customDomain: false,
+            byod: false,
+            themeCustomizer: false,
+            customFonts: false,
+            centennial: false,
+            shop: false,
+            ai: false,
+            analytics: false,
+        },
+        rateLimits: {
+            requests: { limit: 50, windowSeconds: 60 },
+            writes: { limit: 20, windowSeconds: 3600 },
+            uploads: { limit: 0, windowSeconds: 86400 },
+            ai: { limit: 0, windowSeconds: 86400 },
+        },
+        pricing: {
+            monthlyPrice: 0,
+            yearlyPrice: 0,
+            monthlyPriceCents: 0,
+            yearlyPriceCents: 0,
+        },
+        display: {
+            name: "Free",
+            tagline: "Just visiting",
+            description: "Hang out in Meadow, follow blogs, react and comment.",
+            icon: "user",
+            bestFor: "Readers",
+            featureStrings: [
+                "Meadow access",
+                "20 comments/week",
+                "Follow blogs",
+                "React to posts",
+            ],
+        },
+        support: { level: "help_center", displayString: "Help Center" },
+    },
+    seedling: {
+        id: "seedling",
+        order: 1,
+        status: "available",
+        limits: {
+            posts: 50,
+            storage: 1 * 1024 * 1024 * 1024, // 1 GB
+            themes: 3,
+            navPages: 0,
+            commentsPerWeek: Infinity,
+        },
+        features: {
+            blog: true,
+            meadow: true,
+            emailForwarding: false,
+            fullEmail: false,
+            customDomain: false,
+            byod: false,
+            themeCustomizer: false,
+            customFonts: false,
+            centennial: false,
+            shop: false,
+            ai: true,
+            analytics: false,
+        },
+        rateLimits: {
+            requests: { limit: 100, windowSeconds: 60 },
+            writes: { limit: 50, windowSeconds: 3600 },
+            uploads: { limit: 10, windowSeconds: 86400 },
+            ai: { limit: 25, windowSeconds: 86400 },
+        },
+        pricing: {
+            monthlyPrice: 8,
+            yearlyPrice: 81.6,
+            monthlyPriceCents: 800,
+            yearlyPriceCents: 8160,
+        },
+        display: {
+            name: "Seedling",
+            tagline: "Just planted",
+            description: "Perfect for getting started. A quiet corner to call your own.",
+            icon: "sprout",
+            bestFor: "Curious",
+            featureStrings: [
+                "50 posts",
+                "1 GB storage",
+                "3 curated themes",
+                "Meadow access",
+                "RSS feed",
+                "No ads ever",
+            ],
+        },
+        support: { level: "community", displayString: "Community" },
+    },
+    sapling: {
+        id: "sapling",
+        order: 2,
+        status: "coming_soon",
+        limits: {
+            posts: 250,
+            storage: 5 * 1024 * 1024 * 1024, // 5 GB
+            themes: 10,
+            navPages: 3,
+            commentsPerWeek: Infinity,
+        },
+        features: {
+            blog: true,
+            meadow: true,
+            emailForwarding: true,
+            fullEmail: false,
+            customDomain: false,
+            byod: false,
+            themeCustomizer: false,
+            customFonts: false,
+            centennial: true,
+            shop: true,
+            ai: true,
+            analytics: false,
+        },
+        rateLimits: {
+            requests: { limit: 500, windowSeconds: 60 },
+            writes: { limit: 200, windowSeconds: 3600 },
+            uploads: { limit: 50, windowSeconds: 86400 },
+            ai: { limit: 100, windowSeconds: 86400 },
+        },
+        pricing: {
+            monthlyPrice: 12,
+            yearlyPrice: 122.4,
+            monthlyPriceCents: 1200,
+            yearlyPriceCents: 12240,
+        },
+        display: {
+            name: "Sapling",
+            tagline: "Growing strong",
+            description: "For blogs finding their voice. Room to stretch and grow.",
+            icon: "tree-deciduous",
+            bestFor: "Hobbyists",
+            featureStrings: [
+                "250 posts",
+                "5 GB storage",
+                "10 themes",
+                "3 nav pages",
+                "Email forwarding",
+                "Centennial eligible",
+                "Everything in Seedling",
+            ],
+        },
+        support: { level: "email", displayString: "Email" },
+    },
+    oak: {
+        id: "oak",
+        order: 3,
+        status: "future",
+        limits: {
+            posts: Infinity,
+            storage: 20 * 1024 * 1024 * 1024, // 20 GB
+            themes: Infinity,
+            navPages: 5,
+            commentsPerWeek: Infinity,
+        },
+        features: {
+            blog: true,
+            meadow: true,
+            emailForwarding: true,
+            fullEmail: true,
+            customDomain: true,
+            byod: true,
+            themeCustomizer: true,
+            customFonts: false,
+            centennial: true,
+            shop: true,
+            ai: true,
+            analytics: true,
+        },
+        rateLimits: {
+            requests: { limit: 1000, windowSeconds: 60 },
+            writes: { limit: 500, windowSeconds: 3600 },
+            uploads: { limit: 200, windowSeconds: 86400 },
+            ai: { limit: 500, windowSeconds: 86400 },
+        },
+        pricing: {
+            monthlyPrice: 25,
+            yearlyPrice: 255,
+            monthlyPriceCents: 2500,
+            yearlyPriceCents: 25500,
+        },
+        display: {
+            name: "Oak",
+            tagline: "Deep roots",
+            description: "Full creative control. Your blog, your rules.",
+            icon: "trees",
+            bestFor: "Serious Bloggers",
+            featureStrings: [
+                "Unlimited posts",
+                "20 GB storage",
+                "Theme customizer",
+                "5 nav pages",
+                "Bring your own domain",
+                "Centennial eligible",
+                "Priority support",
+            ],
+        },
+        support: { level: "priority", displayString: "Priority" },
+    },
+    evergreen: {
+        id: "evergreen",
+        order: 4,
+        status: "future",
+        limits: {
+            posts: Infinity,
+            storage: 100 * 1024 * 1024 * 1024, // 100 GB
+            themes: Infinity,
+            navPages: 8,
+            commentsPerWeek: Infinity,
+        },
+        features: {
+            blog: true,
+            meadow: true,
+            emailForwarding: true,
+            fullEmail: true,
+            customDomain: true,
+            byod: false, // Domain included
+            themeCustomizer: true,
+            customFonts: true,
+            centennial: true,
+            shop: true,
+            ai: true,
+            analytics: true,
+        },
+        rateLimits: {
+            requests: { limit: 5000, windowSeconds: 60 },
+            writes: { limit: 2000, windowSeconds: 3600 },
+            uploads: { limit: 1000, windowSeconds: 86400 },
+            ai: { limit: 2500, windowSeconds: 86400 },
+        },
+        pricing: {
+            monthlyPrice: 35,
+            yearlyPrice: 357,
+            monthlyPriceCents: 3500,
+            yearlyPriceCents: 35700,
+        },
+        display: {
+            name: "Evergreen",
+            tagline: "Always flourishing",
+            description: "The complete package. Everything Grove has to offer.",
+            icon: "crown",
+            bestFor: "Professionals",
+            featureStrings: [
+                "Unlimited everything",
+                "100 GB storage",
+                "Custom fonts",
+                "8 nav pages",
+                "Domain included",
+                "Centennial eligible",
+                "8 hrs/mo dedicated support",
+            ],
+        },
+        support: {
+            level: "dedicated",
+            displayString: "8hrs + Priority",
+            includedHours: 8,
+        },
+    },
+};
+// =============================================================================
+// HELPER ARRAYS
+// =============================================================================
+export const TIER_ORDER = [
+    "free",
+    "seedling",
+    "sapling",
+    "oak",
+    "evergreen",
+];
+export const PAID_TIERS = [
+    "seedling",
+    "sapling",
+    "oak",
+    "evergreen",
+];
+// =============================================================================
+// HELPER FUNCTIONS
+// =============================================================================
+/**
+ * Get tier config by key (throws if invalid).
+ */
+export function getTier(key) {
+    return TIERS[key];
+}
+/**
+ * Get tier config safely (returns undefined if invalid).
+ */
+export function getTierSafe(key) {
+    return isValidTier(key) ? TIERS[key] : undefined;
+}
+/**
+ * Check if a string is a valid tier key.
+ */
+export function isValidTier(key) {
+    return key in TIERS;
+}
+/**
+ * Check if a tier is a paid tier.
+ */
+export function isPaidTier(key) {
+    return PAID_TIERS.includes(key);
+}
+/**
+ * Get all tiers with 'available' status.
+ */
+export function getAvailableTiers() {
+    return TIER_ORDER.map((k) => TIERS[k]).filter((t) => t.status === "available");
+}
+/**
+ * Get all tiers in order.
+ */
+export function getTiersInOrder() {
+    return TIER_ORDER.map((k) => TIERS[k]);
+}
+/**
+ * Check if a tier has a specific feature enabled.
+ */
+export function tierHasFeature(tier, feature) {
+    return TIERS[tier].features[feature];
+}
+/**
+ * Get a specific limit for a tier.
+ */
+export function getTierLimit(tier, limit) {
+    return TIERS[tier].limits[limit];
+}
+/**
+ * Get rate limits for a tier.
+ */
+export function getTierRateLimits(tier) {
+    return TIERS[tier].rateLimits;
+}
+/**
+ * Format storage size for display.
+ */
+export function formatStorage(bytes) {
+    if (bytes === 0)
+        return "—";
+    if (bytes === Infinity)
+        return "Unlimited";
+    const gb = bytes / (1024 * 1024 * 1024);
+    return gb >= 1 ? `${gb} GB` : `${bytes / (1024 * 1024)} MB`;
+}
+/**
+ * Format a numeric limit for display.
+ */
+export function formatLimit(value) {
+    if (value === 0)
+        return "—";
+    if (value === Infinity)
+        return "Unlimited";
+    return value.toString();
+}
+/**
+ * Get the next tier in the upgrade path.
+ */
+export function getNextTier(current) {
+    const idx = TIER_ORDER.indexOf(current);
+    return idx === -1 || idx === TIER_ORDER.length - 1
+        ? null
+        : TIER_ORDER[idx + 1];
+}
+/**
+ * Get all tiers that have a specific feature enabled.
+ */
+export function getTiersWithFeature(feature) {
+    return TIER_ORDER.filter((key) => TIERS[key].features[feature]);
+}

package/dist/groveauth/types.d.ts

@@ -3,6 +3,7 @@
  *
  * Type definitions for integrating with GroveAuth service.
  */
+import { type PaidTierKey } from "../config/tiers.js";
 export interface GroveAuthConfig {
     /** Client ID registered with GroveAuth */
     clientId: string;
@@ -105,7 +106,7 @@ export interface LoginUrlResult {
     state: string;
     codeVerifier: string;
 }
-export type SubscriptionTier = "seedling" | "sapling" | "oak" | "evergreen";
+export type SubscriptionTier = PaidTierKey;
 export interface UserSubscription {
     id: string;
     user_id: string;
@@ -146,6 +147,7 @@ export interface CanPostResponse {
 }
 /**
  * Post limits per subscription tier.
+ * Derived from the unified tier config.
  *
  * Business rationale:
  * - Seedling (50 posts): Entry-level tier for curious newcomers testing the
@@ -165,6 +167,7 @@ export interface CanPostResponse {
 export declare const TIER_POST_LIMITS: Record<SubscriptionTier, number | null>;
 /**
  * Human-readable tier names for UI display.
+ * Derived from the unified tier config.
  */
 export declare const TIER_NAMES: Record<SubscriptionTier, string>;
 /**

package/dist/groveauth/types.js

@@ -3,11 +3,13 @@
  *
  * Type definitions for integrating with GroveAuth service.
  */
+import { TIERS, PAID_TIERS } from "../config/tiers.js";
 // =============================================================================
-// POST LIMIT CONSTANTS
+// POST LIMIT CONSTANTS (derived from unified config)
 // =============================================================================
 /**
  * Post limits per subscription tier.
+ * Derived from the unified tier config.
  *
  * Business rationale:
  * - Seedling (50 posts): Entry-level tier for curious newcomers testing the
@@ -24,21 +26,15 @@
  *
  * @see docs/implementing-post-limits.md for full specification
  */
-export const TIER_POST_LIMITS = {
-    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
-};
+export const TIER_POST_LIMITS = Object.fromEntries(PAID_TIERS.map((key) => [
+    key,
+    TIERS[key].limits.posts === Infinity ? null : TIERS[key].limits.posts,
+]));
 /**
  * Human-readable tier names for UI display.
+ * Derived from the unified tier config.
  */
-export const TIER_NAMES = {
-    seedling: "Seedling",
-    sapling: "Sapling",
-    oak: "Oak",
-    evergreen: "Evergreen",
-};
+export const TIER_NAMES = Object.fromEntries(PAID_TIERS.map((key) => [key, TIERS[key].display.name]));
 /**
  * Client-side error class for GroveAuth operations.
  * Thrown when authentication or subscription operations fail.

package/dist/payments/shop.d.ts

@@ -3,7 +3,7 @@
  *
  * Utilities for managing products, orders, and customers in D1.
  */
-import type { Product, ProductVariant, ProductType, ProductStatus, Order, OrderStatus, PaymentStatus, Customer, PricingType, BillingInterval } from './types.js';
+import type { Product, ProductVariant, ProductType, ProductStatus, Order, OrderStatus, PaymentStatus, Customer, PricingType, BillingInterval } from "./types.js";
 interface D1Database {
     prepare(query: string): D1PreparedStatement;
     batch<T = unknown>(statements: D1PreparedStatement[]): Promise<D1Result<T>[]>;
@@ -73,7 +73,7 @@ export declare function createVariant(db: D1Database, productId: string, tenantI
     billingInterval?: BillingInterval;
     billingIntervalCount?: number;
     inventoryQuantity?: number;
-    inventoryPolicy?: 'deny' | 'continue';
+    inventoryPolicy?: "deny" | "continue";
     trackInventory?: boolean;
     downloadUrl?: string;
     downloadLimit?: number;
@@ -93,7 +93,7 @@ export declare function updateVariant(db: D1Database, variantId: string, data: P
     billingInterval: BillingInterval;
     billingIntervalCount: number;
     inventoryQuantity: number;
-    inventoryPolicy: 'deny' | 'continue';
+    inventoryPolicy: "deny" | "continue";
     trackInventory: boolean;
     downloadUrl: string;
     downloadLimit: number;