@leadertechie/personal-site-kit 0.1.0-alpha.2 → 0.1.0-alpha.21

package/README.md

@@ -1,6 +1,6 @@
 # @leadertechie/personal-site-kit
 
-A high-performance, modular engine for building personal websites and professional portfolios. Powered by Cloudflare Workers, R2 Storage, and Lit Web Components.
+A high-performance, modular engine for building personal websites and professional portfolios. Powered by Cloudflare Workers, R2 Storage, Lit Web Components, and the **@leadertechie** ecosystem.
 
 ## Features
 
@@ -8,18 +8,21 @@ A high-performance, modular engine for building personal websites and profession
 - **🛠️ 4-Section Engine**: Fully integrated logic for **API**, **UI**, **Prerender**, and **Admin**.
 - **🎨 Modern Layout**: Semantic grid system with responsive `main-column` and `sidebar-column` components.
 - **🌓 Theme Engine**: Built-in light/dark mode support with persistent user preferences.
-- **📝 Content Driven**: Dynamic Markdown rendering with frontmatter support via `@leadertechie/md2html`.
+- **📝 Content Driven**: Dynamic Markdown rendering with frontmatter support via `@leadertechie/md2html` (v2).
 - **⚙️ Remote Config**: Manage site settings (title, copyright, social links) directly from R2 without re-deploying.
 - **🔍 SEO Optimized**: Server-side prerendering ensures search engines see your content perfectly.
+- **🔄 SWR Caching**: Stale-while-revalidate caching via `@leadertechie/r2tohtml` for optimal performance.
+- **⚡ Client-Side Interactivity**: DOM interaction patterns (poll, live-update, click-toggle, infinite-scroll, form-live) via `@leadertechie/md2interact`.
+- **🎯 CSS Hydration**: Inline critical CSS, layer injection, and theme toggle support.
 
 ## Architecture
 
 The kit is divided into four logical subpaths:
 
-1.  **/shared**: Common interfaces, types, and the reactive `SiteStore`.
-2.  **/ui**: Web components for the Banner, Footer, About Me, and Admin Portal.
-3.  **/api**: Standard handlers for Cloudflare Workers to manage R2 content.
-4.  **/prerender**: SEO engine to generate static HTML for crawlers.
+1.  **/shared**: Common interfaces, types, the reactive `SiteStore`, and the `WebsiteUI` bootstrap.
+2.  **/ui**: Web components for the Banner, Footer, About Me, Blog Viewer, Story Viewer, and Admin Portal.
+3.  **/api**: Standard handlers for Cloudflare Workers to manage R2 content with v2 caching.
+4.  **/prerender**: SEO engine to generate static HTML for crawlers with SWR caching.
 
 ## Installation
 
@@ -29,26 +32,100 @@ npm install @leadertechie/personal-site-kit
 
 ## Quick Start (Usage)
 
-### 1. API Worker (`api.ts`)
+### 1. API Worker (`api/index.ts`)
+
 ```typescript
-import { handleAPIRoute } from '@leadertechie/personal-site-kit/api';
+import { WebsiteAPI } from '@leadertechie/personal-site-kit/api';
+
+export default new WebsiteAPI();
+```
+
+### 2. UI Entry (`ui/index.ts`)
 
-export default {
-  async fetch(request, env) {
-    return handleAPIRoute(request, env);
+```typescript
+import { WebsiteUI } from '@leadertechie/personal-site-kit/shared';
+import '@leadertechie/personal-site-kit/styles/theme.css';
+import '@leadertechie/personal-site-kit/ui';
+
+// Bootstrap the UI — md2interact is automatically initialized
+WebsiteUI.getInstance({
+  apiUrl: window.location.origin,
+  // Optional: configure md2interact interactions
+  interactConfig: {
+    interactions: {
+      'poll': { selector: '[data-interact="poll"]' },
+      'live-update': { selector: '[data-interact="live-update"]' },
+      'click-toggle': { selector: '[data-interact="click-toggle"]' },
+      'infinite-scroll': { selector: '[data-interact="infinite-scroll"]' },
+      'form-live': { selector: '[data-interact="form-live"]' }
+    },
+    cssHydration: {
+      inlineCritical: true,
+      layerInjection: true,
+      themeToggle: true
+    }
   }
-};
+}).bootstrap();
 ```
 
-### 2. UI Entry (`main.ts`)
+### 3. Prerender (`prerender/index.ts`)
+
 ```typescript
-import { SiteStore } from '@leadertechie/personal-site-kit/shared';
-import '@leadertechie/personal-site-kit/ui/banner';
+import { WebsitePrerender } from '@leadertechie/personal-site-kit/prerender';
 
-const store = SiteStore.getInstance();
-await store.init({ apiUrl: 'https://api.yourdomain.com' });
+export default new WebsitePrerender();
 ```
 
+## Client-Side Interactivity with md2interact
+
+The kit automatically initializes `@leadertechie/md2interact` during `WebsiteUI.bootstrap()`. This enables:
+
+### DOM Interaction Patterns
+
+Markdown content with frontmatter can declare interaction patterns:
+
+```markdown
+---
+interaction: poll
+interactConfig:
+  url: /api/data
+  interval: 5000
+---
+
+# Live Poll Data
+```
+
+Supported patterns: `poll`, `live-update`, `click-toggle`, `infinite-scroll`, `form-live`, `mfe`, `custom`
+
+### CSS Hydration
+
+- **inlineCritical**: Injects critical CSS directly into the DOM
+- **layerInjection**: Uses CSS `@layer` for organized style injection
+- **themeToggle**: Enables light/dark theme toggling
+
+### SPA Navigation
+
+After dynamic content loads (e.g., blog detail pages), call `reinitInteract()` to re-scan the DOM:
+
+```typescript
+const ui = WebsiteUI.getInstance();
+ui.reinitInteract();
+```
+
+## Caching Strategy (v2)
+
+The kit uses `@leadertechie/r2tohtml` with a multi-tier caching strategy:
+
+| Tier | Cache | TTL |
+|------|-------|-----|
+| In-Memory | `ContentCacheV2` with SWR | 5 min fresh, 30 min stale |
+| Cloudflare Edge | `cfCache` | 5 min |
+
+This means:
+- **Fresh**: Served instantly from memory
+- **Stale**: Served from memory while revalidating in background (SWR)
+- **Miss**: Fetched from R2, cached at edge and in-memory
+
 ## Deployment
 
 This kit is designed to be deployed to **Cloudflare**. Ensure your `wrangler.toml` is configured with an R2 bucket named `CONTENT_BUCKET`.

package/dist/api/content-utils.d.ts

@@ -0,0 +1,27 @@
+export interface ContentMetadata {
+    slug: string;
+    title: string;
+    description: string;
+    summary?: string;
+    date: string;
+    imageUrl?: string;
+    tags?: string[];
+    author?: string;
+}
+export interface BlogPost extends ContentMetadata {
+    content: string;
+}
+export interface StoryPost extends ContentMetadata {
+    content: string;
+}
+export declare function getCachedOrFetch<T>(key: string, fetchFn: () => Promise<T>): Promise<T>;
+export declare function clearContentCache(prefix?: string): void;
+export declare function parseFrontmatter(content: string): {
+    metadata: ContentMetadata;
+    content: string;
+};
+export declare function checkContentBucket(env: any): Response | null;
+export declare function fetchContentItem(bucket: any, type: 'blogs' | 'stories', slug: string): Promise<BlogPost | StoryPost>;
+export declare function fetchContentList(bucket: any, type: 'blogs' | 'stories', latest?: number): Promise<ContentMetadata[]>;
+export declare function searchContent(bucket: any, query: string): Promise<(BlogPost | StoryPost)[]>;
+//# sourceMappingURL=content-utils.d.ts.map

package/dist/api/content-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"content-utils.d.ts","sourceRoot":"","sources":["../../src/api/content-utils.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,QAAS,SAAQ,eAAe;IAC/C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,SAAU,SAAQ,eAAe;IAChD,OAAO,EAAE,MAAM,CAAC;CACjB;AASD,wBAAgB,gBAAgB,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAoBtF;AAED,wBAAgB,iBAAiB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAMvD;AAED,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAAE,QAAQ,EAAE,eAAe,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAMhG;AAED,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,GAAG,GAAG,QAAQ,GAAG,IAAI,CAK5D;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAqB1H;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE,GAAG,EAAE,IAAI,EAAE,OAAO,GAAG,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAiB1H;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,QAAQ,GAAG,SAAS,CAAC,EAAE,CAAC,CA2BjG"}

package/dist/api/handlers/about-me.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"about-me.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/about-me.ts"],"names":[],"mappings":"AA4CA,wBAAgB,iBAAiB,SAEhC;AAED,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkDhE"}
+{"version":3,"file":"about-me.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/about-me.ts"],"names":[],"mappings":"AAmDA,wBAAgB,iBAAiB,SAEhC;AAED,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CA4DhE"}

package/dist/api/handlers/auth-handler.d.ts

@@ -0,0 +1,2 @@
+export declare function handleAuth(request: Request, env: any, subpath: string): Promise<Response>;
+//# sourceMappingURL=auth-handler.d.ts.map

package/dist/api/handlers/auth-handler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth-handler.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/auth-handler.ts"],"names":[],"mappings":"AAyBA,wBAAsB,UAAU,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgC/F"}

package/dist/api/handlers/auth.d.ts

@@ -0,0 +1,23 @@
+declare const AUTH_KV = "auth_store";
+declare const RATE_LIMIT_KV = "rate_limit";
+declare const MAX_ATTEMPTS = 5;
+declare const BASE_DELAY_MS = 1000;
+interface AuthStore {
+    username: string;
+    passwordHash: string;
+    salt: string;
+}
+declare function hashPassword(password: string, salt: string): Promise<string>;
+declare function generateSalt(): Promise<string>;
+declare function checkRateLimit(env: any, ip: string): Promise<{
+    allowed: boolean;
+    delayMs: number;
+}>;
+declare function recordFailedAttempt(env: any, ip: string): Promise<void>;
+declare function clearRateLimit(env: any, ip: string): Promise<void>;
+declare function getAuthStore(env: any): Promise<AuthStore | null>;
+declare function setupAuth(env: any, username: string, password: string): Promise<void>;
+declare function verifyCredentials(env: any, username: string, password: string): Promise<boolean>;
+declare function getClientIP(request: Request): string;
+export { hashPassword, generateSalt, checkRateLimit, recordFailedAttempt, clearRateLimit, getAuthStore, setupAuth, verifyCredentials, getClientIP, AUTH_KV, RATE_LIMIT_KV, MAX_ATTEMPTS, BASE_DELAY_MS };
+//# sourceMappingURL=auth.d.ts.map

package/dist/api/handlers/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/auth.ts"],"names":[],"mappings":"AAAA,QAAA,MAAM,OAAO,eAAe,CAAC;AAC7B,QAAA,MAAM,aAAa,eAAe,CAAC;AACnC,QAAA,MAAM,YAAY,IAAI,CAAC;AACvB,QAAA,MAAM,aAAa,OAAO,CAAC;AAG3B,UAAU,SAAS;IACjB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd;AAQD,iBAAe,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAuB3E;AAED,iBAAe,YAAY,IAAI,OAAO,CAAC,MAAM,CAAC,CAG7C;AAED,iBAAe,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CA2BlG;AAED,iBAAe,mBAAmB,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBtE;AAED,iBAAe,cAAc,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAGjE;AAED,iBAAe,YAAY,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC,CAG/D;AAED,iBAAe,SAAS,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CASpF;AAED,iBAAe,iBAAiB,CAAC,GAAG,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAa/F;AAED,iBAAS,WAAW,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAI7C;AAED,OAAO,EACL,YAAY,EACZ,YAAY,EACZ,cAAc,EACd,mBAAmB,EACnB,cAAc,EACd,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,WAAW,EACX,OAAO,EACP,aAAa,EACb,YAAY,EACZ,aAAa,EACd,CAAC"}

package/dist/api/handlers/content-api.d.ts

@@ -1,5 +1,4 @@
 export declare function handleBlogs(env?: any, slug?: string, latest?: number): Promise<Response>;
 export declare function handleStories(env?: any, slug?: string, latest?: number): Promise<Response>;
 export declare function handleSearch(env?: any, query?: string): Promise<Response>;
-export declare function clearContentCache(): void;
 //# sourceMappingURL=content-api.d.ts.map

package/dist/api/handlers/content-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content-api.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/content-api.ts"],"names":[],"mappings":"AA8EA,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgE9F;AAED,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CA8DhG;AAED,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuD/E;AAED,wBAAgB,iBAAiB,IAAI,IAAI,CAExC"}
+{"version":3,"file":"content-api.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/content-api.ts"],"names":[],"mappings":"AAWA,wBAAsB,WAAW,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmB9F;AAED,wBAAsB,aAAa,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAmBhG;AAED,wBAAsB,YAAY,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAkB/E"}

package/dist/api/handlers/content.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/content.ts"],"names":[],"mappings":"AAEA,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqElG"}
+{"version":3,"file":"content.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/content.ts"],"names":[],"mappings":"AAqBA,wBAAsB,aAAa,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAqElG"}

package/dist/api/handlers/home.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/home.ts"],"names":[],"mappings":"AAiCA,wBAAgB,iBAAiB,SAEhC;AAED,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAyC7D"}
+{"version":3,"file":"home.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/home.ts"],"names":[],"mappings":"AAwCA,wBAAgB,iBAAiB,SAEhC;AAED,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAwC7D"}

package/dist/api/handlers/static-details.d.ts

@@ -1,2 +1,2 @@
-export declare function handleStaticDetails(env?: any, method?: string, body?: any): Promise<Response>;
+export declare function handleStaticDetails(env?: any, method?: string, _body?: any): Promise<Response>;
 //# sourceMappingURL=static-details.d.ts.map

package/dist/api/handlers/static-details.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"static-details.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/static-details.ts"],"names":[],"mappings":"AAQA,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuCnG"}
+{"version":3,"file":"static-details.d.ts","sourceRoot":"","sources":["../../../src/api/handlers/static-details.ts"],"names":[],"mappings":"AAQA,wBAAsB,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC,CAuCpG"}

package/dist/api/index.d.ts

@@ -1,6 +1,8 @@
 import { WebsiteAPI } from './website-api';
 export { WebsiteAPI };
 export type { APIHandler } from './website-api';
+export * from './handlers/auth';
+export * from './handlers/auth-handler';
 declare const defaultAPI: WebsiteAPI;
 export default defaultAPI;
 //# sourceMappingURL=index.d.ts.map

package/dist/api/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGhD,QAAA,MAAM,UAAU,YAAmB,CAAC;AACpC,eAAe,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/api/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,CAAC;AACtB,YAAY,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,cAAc,iBAAiB,CAAC;AAChC,cAAc,yBAAyB,CAAC;AAGxC,QAAA,MAAM,UAAU,YAAmB,CAAC;AACpC,eAAe,UAAU,CAAC"}

package/dist/api/website-api.d.ts

@@ -3,8 +3,8 @@ export declare class WebsiteAPI {
     private customHandlers;
     registerHandler(route: string, handler: APIHandler): void;
     private addCORSHeaders;
+    private addAdminCORSHeaders;
     private handleCORS;
-    private requireAuth;
     fetch(request: Request, env: any): Promise<Response>;
 }
 //# sourceMappingURL=website-api.d.ts.map

package/dist/api/website-api.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"website-api.d.ts","sourceRoot":"","sources":["../../src/api/website-api.ts"],"names":[],"mappings":"AASA,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3E,qBAAa,UAAU;IACrB,OAAO,CAAC,cAAc,CAAiC;IAEhD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IAIzD,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,UAAU;IAYlB,OAAO,CAAC,WAAW;IAYN,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;CA0ElE"}
+{"version":3,"file":"website-api.d.ts","sourceRoot":"","sources":["../../src/api/website-api.ts"],"names":[],"mappings":"AAUA,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE3E,qBAAa,UAAU;IACrB,OAAO,CAAC,cAAc,CAAiC;IAEhD,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU;IAIzD,OAAO,CAAC,cAAc;IAStB,OAAO,CAAC,mBAAmB;IAmB3B,OAAO,CAAC,UAAU;IAqBL,KAAK,CAAC,OAAO,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,QAAQ,CAAC;CAkGlE"}

package/dist/api.js

@@ -1,6 +1,21 @@
-import { W as WebsiteAPI } from "./chunks/website-api-CVsi-OLc.js";
+import { W as WebsiteAPI } from "./chunks/website-api-CFRUPu0X.js";
+import { A, B, M, R, c, a, g, b, d, h, e, r, s, v } from "./chunks/website-api-CFRUPu0X.js";
 const defaultAPI = new WebsiteAPI();
 export {
+  A as AUTH_KV,
+  B as BASE_DELAY_MS,
+  M as MAX_ATTEMPTS,
+  R as RATE_LIMIT_KV,
   WebsiteAPI,
-  defaultAPI as default
+  c as checkRateLimit,
+  a as clearRateLimit,
+  defaultAPI as default,
+  g as generateSalt,
+  b as getAuthStore,
+  d as getClientIP,
+  h as handleAuth,
+  e as hashPassword,
+  r as recordFailedAttempt,
+  s as setupAuth,
+  v as verifyCredentials
 };

package/dist/assets/logo-placeholder.svg

@@ -0,0 +1,21 @@
+<svg width="600" height="320" viewBox="0 0 600 320" xmlns="http://www.w3.org/2000/svg">
+  <style>
+    .text-main { 
+      fill: light-dark(#4A5568, #E2E8F0);
+      font-family: 'Segoe UI', 'Arial Black', sans-serif; 
+      font-weight: 900; 
+      font-size: 46px; 
+      letter-spacing: -0.01em; 
+      text-anchor: middle; 
+    }
+  </style>
+
+  <!-- Big circle placeholder -->
+  <circle cx="300" cy="160" r="100" fill="none" stroke="light-dark(#A0AEC0, #718096)" stroke-width="2" stroke-dasharray="8 4" opacity="0.5" />
+  
+  <!-- Plus sign in circle -->
+  <line x1="300" y1="100" x2="300" y2="220" stroke="light-dark(#A0AEC0, #718096)" stroke-width="2" opacity="0.3" />
+  <line x1="240" y1="160" x2="360" y2="160" stroke="light-dark(#A0AEC0, #718096)" stroke-width="2" opacity="0.3" />
+
+  <text x="300" y="290" class="text-main">YOUR LOGO</text>
+</svg>

package/dist/chunks/index-C1krnvU3.js

@@ -0,0 +1,211 @@
+class BasePageGenerator {
+  generateBanner(routes, siteTitle, logo) {
+    const navLinks = routes.map((r) => `<a href="${r.link}" class="nav-link" data-route="${r.link === "/" ? "home" : r.text.toLowerCase()}">${r.text}</a>`).join("");
+    return `
+      <my-banner header="${siteTitle}" logo="${logo}">
+        <theme-toggle slot="theme-switcher"></theme-toggle>
+        <nav slot="nav-links">
+          ${navLinks}
+        </nav>
+      </my-banner>`;
+  }
+  generateFooter(footerLinks, copyright) {
+    return `
+      <my-footer
+        copyright="${copyright}"
+        footerlinks='${JSON.stringify(footerLinks)}'>
+      </my-footer>`;
+  }
+  wrapContent(banner, mainContent, footer) {
+    return `${banner}${mainContent}${footer}`;
+  }
+  generatePage(pathname, routes, footerLinks, staticDetails, apiUrl, baseUrl, mainContent, title, description) {
+    const logo = "/api/logo";
+    const banner = this.generateBanner(routes, staticDetails.siteTitle || "My Personal Website", logo);
+    const footer = this.generateFooter(footerLinks, staticDetails.copyright || "2026 My Personal Website");
+    const canonicalUrl = new URL(pathname, baseUrl).toString();
+    const content = this.wrapContent(banner, mainContent, footer);
+    return {
+      title,
+      description,
+      canonicalUrl,
+      content
+    };
+  }
+}
+class HomePageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { profile, homeContent, latestBlogs, latestStories, staticDetails, ...baseData } = data;
+    const name = profile?.name || "User";
+    const title = profile?.title || "Professional";
+    const homeHtml = homeContent || `<h1>Welcome to ${name}</h1><p>Upload home.md to customize this page.</p>`;
+    const blogGists = latestBlogs.map((b) => `<div class="gist-card"><a href="/blogs/${b.slug}"><h4>${b.title}</h4></a><p>${b.summary}</p><small>${b.date}</small></div>`).join("");
+    const storyGists = latestStories.map((s) => `<div class="gist-card"><a href="/stories/${s.slug}"><h4>${s.title}</h4></a><p>${s.summary}</p><small>${s.date}</small></div>`).join("");
+    const mainContent = `
+      <main class="container container-wide column-layout">
+        <div class="main-column">
+          ${homeHtml}
+        </div>
+        <div class="sidebar-column">
+          <h3>Recent Blogs</h3>
+          ${blogGists || "<p>No blogs yet.</p>"}
+          <h3 class="mt-2">Recent Stories</h3>
+          ${storyGists || "<p>No stories yet.</p>"}
+        </div>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      `${name} – ${title}`,
+      `Welcome to ${name}'s personal website. Professional portfolio and content.`
+    );
+  }
+}
+class AboutPageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { profile, staticDetails, ...baseData } = data;
+    const name = profile?.name || "User";
+    const mainContent = `
+      <main class="container container-narrow">
+        <my-aboutme base-url="${baseData.apiUrl}"></my-aboutme>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      `About - ${name}`,
+      `Learn more about ${name}'s experience and skills.`
+    );
+  }
+}
+class BlogsListPageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { latestBlogs, name, staticDetails, ...baseData } = data;
+    const blogGists = latestBlogs.map((b) => `<div class="gist-card"><a href="/blogs/${b.slug}"><h4>${b.title}</h4></a><p>${b.summary}</p><small>${b.date}</small></div>`).join("");
+    const mainContent = `
+      <main class="container container-wide">
+        <h1>Blogs</h1>
+        <input type="text" placeholder="Search blogs..." class="search-input" />
+        <div class="blog-list">
+          ${blogGists || "<p>No blogs yet.</p>"}
+        </div>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      `Blogs – ${name}`,
+      "Read the latest blog posts."
+    );
+  }
+}
+class StoriesListPageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { latestStories, name, staticDetails, ...baseData } = data;
+    const storyGists = latestStories.map((s) => `<div class="gist-card"><a href="/stories/${s.slug}"><h4>${s.title}</h4></a><p>${s.summary}</p><small>${s.date}</small></div>`).join("");
+    const mainContent = `
+      <main class="container container-wide">
+        <h1>Stories</h1>
+        <input type="text" placeholder="Search stories..." class="search-input" />
+        <div class="story-list">
+          ${storyGists || "<p>No stories yet.</p>"}
+        </div>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      `Stories – ${name}`,
+      "Read the latest stories."
+    );
+  }
+}
+class BlogDetailPageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { slug, staticDetails, ...baseData } = data;
+    const mainContent = `
+      <main class="container container-narrow">
+        <my-blog-viewer slug="${slug}"></my-blog-viewer>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      `Blog: ${slug}`,
+      "Blog post"
+    );
+  }
+}
+class StoryDetailPageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { slug, staticDetails, ...baseData } = data;
+    const mainContent = `
+      <main class="container container-narrow">
+        <my-story-viewer slug="${slug}"></my-story-viewer>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      `Story: ${slug}`,
+      "Story post"
+    );
+  }
+}
+class NotFoundPageGenerator extends BasePageGenerator {
+  generate(data) {
+    const { staticDetails, ...baseData } = data;
+    const mainContent = `
+      <main class="container container-narrow text-center">
+        <h1>Page Not Found</h1>
+        <p>The page you're looking for doesn't exist.</p>
+        <p><a href="/">Return to home</a></p>
+      </main>`;
+    return this.generatePage(
+      baseData.pathname,
+      baseData.routes,
+      baseData.footerLinks,
+      staticDetails,
+      baseData.apiUrl,
+      baseData.baseUrl,
+      mainContent,
+      "404 Not Found",
+      "The page you requested could not be found."
+    );
+  }
+}
+export {
+  AboutPageGenerator,
+  BasePageGenerator,
+  BlogDetailPageGenerator,
+  BlogsListPageGenerator,
+  HomePageGenerator,
+  NotFoundPageGenerator,
+  StoriesListPageGenerator,
+  StoryDetailPageGenerator
+};