@autumnsgrove/groveengine 0.4.12 → 0.5.0

package/dist/groveauth/types.d.ts

@@ -0,0 +1,137 @@
+/**
+ * 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 = "starter" | "professional" | "business";
+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:
+ * - 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.
+ *
+ * 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,57 @@
+/**
+ * GroveAuth Client Types
+ *
+ * Type definitions for integrating with GroveAuth service.
+ */
+// =============================================================================
+// POST LIMIT CONSTANTS
+// =============================================================================
+/**
+ * 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.
+ *
+ * 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 = {
+    starter: 250, // For hobbyists and personal blogs
+    professional: 2000, // For active bloggers and small businesses
+    business: null, // Unlimited for enterprises and power users
+};
+/**
+ * Human-readable tier names for UI display.
+ */
+export const TIER_NAMES = {
+    starter: "Starter",
+    professional: "Professional",
+    business: "Business",
+};
+/**
+ * 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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@autumnsgrove/groveengine",
-  "version": "0.4.12",
+  "version": "0.5.0",
   "description": "Multi-tenant blog engine for Grove Platform. Features gutter annotations, markdown editing, magic code auth, and Cloudflare Workers deployment.",
   "author": "AutumnsGrove",
   "license": "MIT",