@autumnsgrove/groveengine 0.4.12 → 0.6.1

package/dist/groveauth/types.d.ts

@@ -0,0 +1,139 @@
+/**
+ * GroveAuth Client Types
+ *
+ * Type definitions for integrating with GroveAuth service.
+ */
+export interface GroveAuthConfig {
+    /** Client ID registered with GroveAuth */
+    clientId: string;
+    /** Client secret for token exchange (keep secure!) */
+    clientSecret: string;
+    /** OAuth callback URL for this application */
+    redirectUri: string;
+    /** GroveAuth base URL (defaults to https://auth.grove.place) */
+    authBaseUrl?: string;
+}
+export interface TokenResponse {
+    access_token: string;
+    token_type: "Bearer";
+    expires_in: number;
+    refresh_token: string;
+    scope: string;
+}
+export interface TokenInfo {
+    active: boolean;
+    sub?: string;
+    email?: string;
+    name?: string;
+    exp?: number;
+    iat?: number;
+    client_id?: string;
+}
+export interface UserInfo {
+    sub: string;
+    email: string;
+    name: string | null;
+    picture: string | null;
+    provider: "google" | "github" | "magic_code";
+}
+export interface LoginUrlResult {
+    url: string;
+    state: string;
+    codeVerifier: string;
+}
+export type SubscriptionTier = "seedling" | "sapling" | "oak" | "evergreen";
+export interface UserSubscription {
+    id: string;
+    user_id: string;
+    tier: SubscriptionTier;
+    post_limit: number | null;
+    post_count: number;
+    grace_period_start: string | null;
+    grace_period_days: number;
+    stripe_customer_id: string | null;
+    stripe_subscription_id: string | null;
+    billing_period_start: string | null;
+    billing_period_end: string | null;
+    custom_domain: string | null;
+    custom_domain_verified: number;
+    created_at: string;
+    updated_at: string;
+}
+export interface SubscriptionStatus {
+    tier: SubscriptionTier;
+    post_count: number;
+    post_limit: number | null;
+    posts_remaining: number | null;
+    percentage_used: number | null;
+    is_at_limit: boolean;
+    is_in_grace_period: boolean;
+    grace_period_days_remaining: number | null;
+    can_create_post: boolean;
+    upgrade_required: boolean;
+}
+export interface SubscriptionResponse {
+    subscription: UserSubscription;
+    status: SubscriptionStatus;
+}
+export interface CanPostResponse {
+    allowed: boolean;
+    status: SubscriptionStatus;
+    subscription: UserSubscription;
+}
+/**
+ * Post limits per subscription tier.
+ *
+ * Business rationale:
+ * - 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.
+ *
+ * @see docs/implementing-post-limits.md for full specification
+ */
+export declare const TIER_POST_LIMITS: Record<SubscriptionTier, number | null>;
+/**
+ * Human-readable tier names for UI display.
+ */
+export declare const TIER_NAMES: Record<SubscriptionTier, string>;
+/**
+ * OAuth/API error response structure from GroveAuth.
+ * Used to parse error responses from the authentication API.
+ *
+ * @example
+ * ```typescript
+ * const response = await fetch('/token');
+ * if (!response.ok) {
+ *   const error: AuthError = await response.json();
+ *   console.error(error.error, error.error_description);
+ * }
+ * ```
+ */
+export interface AuthError {
+    /** OAuth error code (e.g., 'invalid_grant', 'access_denied') */
+    error: string;
+    /** Human-readable error description (OAuth standard) */
+    error_description?: string;
+    /** Alternative message field used by some endpoints */
+    message?: string;
+}
+/**
+ * Client-side error class for GroveAuth operations.
+ * Thrown when authentication or subscription operations fail.
+ */
+export declare class GroveAuthError extends Error {
+    /** Error code (e.g., 'invalid_user_id', 'subscription_error') */
+    readonly code: string;
+    /** HTTP status code from the response */
+    readonly statusCode: number;
+    constructor(code: string, message: string, statusCode?: number);
+    /** Alias for statusCode for compatibility */
+    get status(): number;
+}

package/dist/groveauth/types.js

@@ -0,0 +1,61 @@
+/**
+ * GroveAuth Client Types
+ *
+ * Type definitions for integrating with GroveAuth service.
+ */
+// =============================================================================
+// POST LIMIT CONSTANTS
+// =============================================================================
+/**
+ * Post limits per subscription tier.
+ *
+ * Business rationale:
+ * - 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.
+ *
+ * @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
+};
+/**
+ * Human-readable tier names for UI display.
+ */
+export const TIER_NAMES = {
+    seedling: "Seedling",
+    sapling: "Sapling",
+    oak: "Oak",
+    evergreen: "Evergreen",
+};
+/**
+ * Client-side error class for GroveAuth operations.
+ * Thrown when authentication or subscription operations fail.
+ */
+export class GroveAuthError extends Error {
+    /** Error code (e.g., 'invalid_user_id', 'subscription_error') */
+    code;
+    /** HTTP status code from the response */
+    statusCode;
+    constructor(code, message, statusCode = 400) {
+        super(message);
+        this.name = "GroveAuthError";
+        this.code = code;
+        this.statusCode = statusCode;
+    }
+    /** Alias for statusCode for compatibility */
+    get status() {
+        return this.statusCode;
+    }
+}

package/dist/index.d.ts

@@ -6,9 +6,11 @@ export { default as MobileTOC } from './components/custom/MobileTOC.svelte';
 export { default as CollapsibleSection } from './components/custom/CollapsibleSection.svelte';
 export { default as MarkdownEditor } from './components/admin/MarkdownEditor.svelte';
 export { default as GutterManager } from './components/admin/GutterManager.svelte';
+export { QuotaWidget, QuotaWarning, UpgradePrompt } from './components/quota/index';
 export { default as ImageGallery } from './ui/components/gallery/ImageGallery.svelte';
 export { default as Lightbox } from './ui/components/gallery/Lightbox.svelte';
 export { default as LightboxCaption } from './ui/components/gallery/LightboxCaption.svelte';
 export { default as ZoomableImage } from './ui/components/gallery/ZoomableImage.svelte';
 export * from './ui/index';
 export { cn } from './utils/cn';
+export * from './groveauth/index';

package/dist/index.js

@@ -9,6 +9,8 @@ export { default as CollapsibleSection } from './components/custom/CollapsibleSe
 // Admin components
 export { default as MarkdownEditor } from './components/admin/MarkdownEditor.svelte';
 export { default as GutterManager } from './components/admin/GutterManager.svelte';
+// Quota components
+export { QuotaWidget, QuotaWarning, UpgradePrompt } from './components/quota/index';
 // Gallery components (from UI module)
 export { default as ImageGallery } from './ui/components/gallery/ImageGallery.svelte';
 export { default as Lightbox } from './ui/components/gallery/Lightbox.svelte';
@@ -18,3 +20,5 @@ export { default as ZoomableImage } from './ui/components/gallery/ZoomableImage.
 export * from './ui/index';
 // Utilities
 export { cn } from './utils/cn';
+// GroveAuth client (re-export for convenience)
+export * from './groveauth/index';

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 {};