@autumnsgrove/groveengine 0.6.2 → 0.6.3

package/dist/components/custom/LeftGutter.svelte

@@ -2,15 +2,31 @@
 	import { tick } from 'svelte';
 	import GutterItem from './GutterItem.svelte';
 
-	let { items = [], headers = [], contentHeight = 0, onOverflowChange = () => {} } = $props();
+	/**
+	 * @typedef {{ type?: string; file?: string; src?: string; url?: string; anchor?: string; content?: string; [key: string]: unknown }} GutterItemType
+	 * @typedef {{ id: string; text: string; level?: number }} HeaderType
+	 */
 
+	let {
+		items = /** @type {GutterItemType[]} */ ([]),
+		headers = /** @type {HeaderType[]} */ ([]),
+		contentHeight = 0,
+		onOverflowChange = /** @type {(anchors: string[]) => void} */ (() => {})
+	} = $props();
+
+	/** @type {HTMLElement | undefined} */
 	let gutterElement = $state();
+	/** @type {Record<string, number>} */
 	let itemPositions = $state({});
+	/** @type {Record<string, HTMLElement>} */
 	let anchorGroupElements = $state({});
+	/** @type {string[]} */
 	let overflowingAnchors = $state([]);
 
 	/**
 	 * Parse anchor string to determine anchor type and value
+	 * @param {string | undefined} anchor
+	 * @returns {{ type: string; value: string | number | null }}
 	 */
 	function parseAnchor(anchor) {
 		if (!anchor) {
@@ -41,6 +57,8 @@
 
 	/**
 	 * Generate a unique key for an anchor (used for grouping and positioning)
+	 * @param {string} anchor
+	 * @returns {string}
 	 */
 	function getAnchorKey(anchor) {
 		const parsed = parseAnchor(anchor);
@@ -48,7 +66,7 @@
 			case 'header':
 				// For headers, use the header ID
 				const headerText = anchor.replace(/^#+\s*/, '');
-				const header = headers.find(h => h.text === headerText);
+				const header = headers.find((/** @type {HeaderType} */ h) => h.text === headerText);
 				return header ? `header:${header.id}` : `header:${anchor}`;
 			case 'paragraph':
 				return `paragraph:${parsed.value}`;
@@ -61,6 +79,7 @@
 
 	/**
 	 * Get all unique anchors from items (preserving order)
+	 * @returns {string[]}
 	 */
 	function getUniqueAnchors() {
 		const seen = new Set();
@@ -74,19 +93,26 @@
 		return anchors;
 	}
 
-	// Group items by their anchor
+	/**
+	 * Group items by their anchor
+	 * @param {string} anchor
+	 * @returns {GutterItemType[]}
+	 */
 	function getItemsForAnchor(anchor) {
-		return items.filter(item => item.anchor === anchor);
+		return items.filter((/** @type {GutterItemType} */ item) => item.anchor === anchor);
 	}
 
-	// Get items that don't have a valid anchor (show at top)
+	/**
+	 * Get items that don't have a valid anchor (show at top)
+	 * @returns {GutterItemType[]}
+	 */
 	function getOrphanItems() {
-		return items.filter(item => {
+		return items.filter((/** @type {GutterItemType} */ item) => {
 			if (!item.anchor) return true;
 			const parsed = parseAnchor(item.anchor);
 			if (parsed.type === 'header') {
 				const headerText = item.anchor.replace(/^#+\s*/, '');
-				return !headers.find(h => h.text === headerText);
+				return !headers.find((/** @type {HeaderType} */ h) => h.text === headerText);
 			}
 			// Paragraph and tag anchors are valid if they have values
 			return parsed.type === 'none';
@@ -95,6 +121,8 @@
 
 	/**
 	 * Find the DOM element for an anchor
+	 * @param {string} anchor
+	 * @returns {HTMLElement | null}
 	 */
 	function findAnchorElement(anchor) {
 		const parsed = parseAnchor(anchor);
@@ -104,7 +132,7 @@
 		switch (parsed.type) {
 			case 'header': {
 				const headerText = anchor.replace(/^#+\s*/, '');
-				const header = headers.find(h => h.text === headerText);
+				const header = headers.find((/** @type {HeaderType} */ h) => h.text === headerText);
 				if (header) {
 					return document.getElementById(header.id);
 				}
@@ -112,14 +140,15 @@
 			}
 			case 'paragraph': {
 				const paragraphs = contentEl.querySelectorAll('p');
+				if (typeof parsed.value !== 'number') return null;
 				const index = parsed.value - 1; // Convert to 0-based index
 				if (index >= 0 && index < paragraphs.length) {
-					return paragraphs[index];
+					return /** @type {HTMLElement} */ (paragraphs[index]);
 				}
 				return null;
 			}
 			case 'tag': {
-				return contentEl.querySelector(`[data-anchor="${parsed.value}"]`);
+				return /** @type {HTMLElement | null} */ (contentEl.querySelector(`[data-anchor="${parsed.value}"]`));
 			}
 			default:
 				return null;
@@ -137,13 +166,14 @@
 		const bottomPadding = 32; // Padding from bottom of content
 
 		let lastBottom = 0; // Track the bottom edge of the last positioned item
+		/** @type {string[]} */
 		const newOverflowingAnchors = [];
 
 		// Get all unique anchors that have items
 		const anchors = getUniqueAnchors();
 
 		// Sort anchors by their position in the document
-		const anchorPositions = anchors.map(anchor => {
+		const anchorPositions = anchors.map((/** @type {string} */ anchor) => {
 			const el = findAnchorElement(anchor);
 			return {
 				anchor,
@@ -151,9 +181,9 @@
 				element: el,
 				top: el ? el.offsetTop : Infinity
 			};
-		}).sort((a, b) => a.top - b.top);
+		}).sort((/** @type {{ top: number }} */ a, /** @type {{ top: number }} */ b) => a.top - b.top);
 
-		anchorPositions.forEach(({ anchor, key, element }) => {
+		anchorPositions.forEach((/** @type {{ anchor: string; key: string; element: HTMLElement | null; top: number }} */ { anchor, key, element }) => {
 			const groupEl = anchorGroupElements[key];
 
 			if (element && groupEl) {

package/dist/components/custom/LeftGutter.svelte.d.ts

@@ -4,14 +4,14 @@ type LeftGutter = {
     $set?(props: Partial<$$ComponentProps>): void;
 };
 declare const LeftGutter: import("svelte").Component<{
-    items?: any[];
-    headers?: any[];
+    items?: any;
+    headers?: any;
     contentHeight?: number;
-    onOverflowChange?: Function;
+    onOverflowChange?: any;
 }, {}, "">;
 type $$ComponentProps = {
-    items?: any[];
-    headers?: any[];
+    items?: any;
+    headers?: any;
     contentHeight?: number;
-    onOverflowChange?: Function;
+    onOverflowChange?: any;
 };

package/dist/config/ai-models.js

@@ -23,7 +23,7 @@ const CHARS_PER_TOKEN = 4;
  * @returns {{ inputTokens: number, outputTokens: number, cost: number }}
  */
 export function calculateCost(content, model = 'haiku') {
-  const pricing = MODEL_PRICING[model] || MODEL_PRICING.haiku;
+  const pricing = MODEL_PRICING[/** @type {keyof typeof MODEL_PRICING} */ (model)] || MODEL_PRICING.haiku;
   const inputTokens = Math.ceil(content.length / CHARS_PER_TOKEN);
   // Estimate output tokens as ~10% of input for analysis tasks
   const outputTokens = Math.ceil(inputTokens * 0.1);

package/dist/groveauth/client.js

@@ -190,7 +190,7 @@ export class GroveAuthClient {
                 code_verifier: codeVerifier,
             }),
         });
-        const data = await response.json();
+        const data = (await response.json());
         if (!response.ok) {
             throw new GroveAuthError(data.error || "token_error", data.error_description || data.message || "Failed to exchange code", response.status);
         }
@@ -219,7 +219,7 @@ export class GroveAuthClient {
                     client_secret: this.config.clientSecret,
                 }),
             });
-            const data = await response.json();
+            const data = (await response.json());
             if (!response.ok) {
                 throw new GroveAuthError(data.error || "refresh_error", data.error_description || data.message || "Failed to refresh token", response.status);
             }
@@ -255,7 +255,7 @@ export class GroveAuthClient {
             }),
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "revoke_error", data.error_description || data.message || "Failed to revoke token", response.status);
         }
     }
@@ -287,7 +287,7 @@ export class GroveAuthClient {
             },
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "userinfo_error", data.error_description || data.message || "Failed to get user info", response.status);
         }
         return response.json();
@@ -305,7 +305,7 @@ export class GroveAuthClient {
             },
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "subscription_error", data.message || "Failed to get subscription", response.status);
         }
         return response.json();
@@ -359,7 +359,7 @@ export class GroveAuthClient {
             },
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "subscription_error", data.message || "Failed to get subscription", response.status);
         }
         const data = (await response.json());
@@ -381,7 +381,7 @@ export class GroveAuthClient {
             },
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "limit_check_error", data.message || "Failed to check post limit", response.status);
         }
         return response.json();
@@ -401,7 +401,7 @@ export class GroveAuthClient {
             body: JSON.stringify({ action: "increment" }),
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "count_error", data.message || "Failed to update post count", response.status);
         }
         const data = (await response.json());
@@ -427,7 +427,7 @@ export class GroveAuthClient {
             body: JSON.stringify({ action: "decrement" }),
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "count_error", data.message || "Failed to update post count", response.status);
         }
         const data = (await response.json());
@@ -453,7 +453,7 @@ export class GroveAuthClient {
             body: JSON.stringify({ count }),
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "count_error", data.message || "Failed to update post count", response.status);
         }
         const data = (await response.json());
@@ -479,7 +479,7 @@ export class GroveAuthClient {
             body: JSON.stringify({ tier }),
         });
         if (!response.ok) {
-            const data = await response.json();
+            const data = (await response.json());
             throw new GroveAuthError(data.error || "tier_error", data.message || "Failed to update tier", response.status);
         }
         const data = (await response.json());

package/dist/index.d.ts

@@ -13,4 +13,6 @@ export { default as LightboxCaption } from './ui/components/gallery/LightboxCapt
 export { default as ZoomableImage } from './ui/components/gallery/ZoomableImage.svelte';
 export * from './ui/index';
 export { cn } from './utils/cn';
-export * from './groveauth/index';
+export { GroveAuthClient, createGroveAuthClient, generateCodeVerifier, generateCodeChallenge, generateState, GroveAuthError, TIER_POST_LIMITS, TIER_NAMES, getQuotaDescription, getQuotaUrgency, getSuggestedActions, getUpgradeRecommendation, getQuotaWidgetData, getPreSubmitCheck, STATUS_COLORS, ALERT_VARIANTS, getStatusColorFromPercentage, getAlertVariantFromColor, RateLimiter, RateLimitError, withRateLimit, DEFAULT_RATE_LIMITS, } from './groveauth/index';
+export type { GroveAuthConfig, TokenResponse, TokenInfo, UserInfo, LoginUrlResult, UserSubscription, SubscriptionStatus, SubscriptionResponse, CanPostResponse, SubscriptionTier, AuthError, QuotaWidgetData, PreSubmitCheckResult, AlertVariant, } from './groveauth/index';
+export type { StatusColor as GroveAuthStatusColor } from './groveauth/index';

package/dist/index.js

@@ -20,5 +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';
+// GroveAuth client (re-export explicitly to avoid StatusColor conflict with UI)
+export { GroveAuthClient, createGroveAuthClient, generateCodeVerifier, generateCodeChallenge, generateState, GroveAuthError, TIER_POST_LIMITS, TIER_NAMES, getQuotaDescription, getQuotaUrgency, getSuggestedActions, getUpgradeRecommendation, getQuotaWidgetData, getPreSubmitCheck, STATUS_COLORS, ALERT_VARIANTS, getStatusColorFromPercentage, getAlertVariantFromColor, RateLimiter, RateLimitError, withRateLimit, DEFAULT_RATE_LIMITS, } from './groveauth/index';

package/dist/server/logger.d.ts

@@ -1,53 +1,101 @@
+/**
+ * Server-side logging utility with in-memory circular buffers
+ * Supports real-time log streaming to admin console
+ */
+/** Log severity levels */
+export type LogLevel = "info" | "warn" | "error" | "success";
+/** Log categories */
+export type LogCategory = "api" | "github" | "errors" | "cache";
+/** Metadata for API logs */
+export interface APIMetadata {
+    endpoint?: string;
+    method?: string;
+    status?: number;
+    duration?: number;
+    [key: string]: unknown;
+}
+/** Metadata for GitHub logs */
+export interface GitHubMetadata {
+    error?: boolean;
+    warning?: boolean;
+    rateLimit?: {
+        remaining: number;
+        limit: number;
+    };
+    [key: string]: unknown;
+}
+/** Metadata for error logs */
+export interface ErrorMetadata {
+    error?: {
+        message: string;
+        stack?: string;
+        name: string;
+    } | null;
+    [key: string]: unknown;
+}
+/** Metadata for cache logs */
+export interface CacheMetadata {
+    operation?: string;
+    key?: string;
+    error?: boolean;
+    [key: string]: unknown;
+}
+/** Log entry structure */
+export interface LogEntry {
+    id: string;
+    timestamp: string;
+    level: LogLevel;
+    category: LogCategory;
+    message: string;
+    metadata: Record<string, unknown>;
+}
+/** Log statistics for a category */
+export interface CategoryStats {
+    total: number;
+    recent: number;
+}
+/** Overall log statistics */
+export interface LogStats {
+    api: CategoryStats;
+    github: CategoryStats;
+    errors: CategoryStats;
+    cache: CategoryStats;
+}
+/** Subscriber callback type */
+export type LogSubscriber = (log: LogEntry) => void;
 /**
  * Log API activity (requests, responses, timing)
  */
-export function logAPI(endpoint: any, method: any, status: any, metadata?: {}): void;
+export declare function logAPI(endpoint: string, method: string, status: number, metadata?: APIMetadata): void;
 /**
  * Log GitHub API operations (rate limits, queries, errors)
  */
-export function logGitHub(operation: any, metadata?: {}): void;
+export declare function logGitHub(operation: string, metadata?: GitHubMetadata): void;
 /**
  * Log errors (exceptions, failed operations, validation errors)
  */
-export function logError(message: any, error?: null, metadata?: {}): void;
+export declare function logError(message: string, error?: Error | null, metadata?: Record<string, unknown>): void;
 /**
  * Log cache operations (KV get/set, hits/misses)
  */
-export function logCache(operation: any, key: any, metadata?: {}): void;
+export declare function logCache(operation: string, key: string, metadata?: CacheMetadata): void;
 /**
  * Get logs from a specific category
  */
-export function getLogs(category: any, since?: null): any;
+export declare function getLogs(category: LogCategory, since?: string | null): LogEntry[];
 /**
  * Get all logs across all categories
  */
-export function getAllLogs(since?: null): any[];
+export declare function getAllLogs(since?: string | null): LogEntry[];
 /**
  * Get log statistics
  */
-export function getLogStats(): {
-    api: {
-        total: number;
-        recent: number;
-    };
-    github: {
-        total: number;
-        recent: number;
-    };
-    errors: {
-        total: number;
-        recent: number;
-    };
-    cache: {
-        total: number;
-        recent: number;
-    };
-};
+export declare function getLogStats(): LogStats;
 /**
  * Subscribe to log events (for SSE streaming)
  */
-export function subscribe(callback: any): () => boolean;
+export declare function subscribe(callback: LogSubscriber): () => boolean;
 /**
  * Clear logs for a specific category or all categories
  */
-export function clearLogs(category?: null): void;
+export declare function clearLogs(category?: LogCategory | null): void;