@donkeylabs/cli 0.1.0

package/templates/sveltekit-app/README.md

@@ -0,0 +1,103 @@
+# SvelteKit App Example
+
+A complete example of using `@donkeylabs/adapter-sveltekit` to integrate @donkeylabs/server with SvelteKit.
+
+## Features Demonstrated
+
+- **SSR Direct Calls** - API calls in `+page.server.ts` use direct function calls (no HTTP)
+- **Browser HTTP Calls** - API calls in `+page.svelte` use fetch
+- **Unified API Client** - Same interface for both SSR and browser
+- **SSE (Server-Sent Events)** - Real-time updates from server to browser
+- **All Core Services** - Cache, Jobs, Cron, Rate Limiter, Events, SSE
+
+## Project Structure
+
+```
+src/
+├── server/
+│   └── index.ts          # @donkeylabs/server setup (plugins, routes)
+├── lib/
+│   ├── api.ts            # Typed API client
+│   └── components/ui/    # UI components (shadcn-svelte)
+├── routes/
+│   ├── +page.server.ts   # SSR data loading (direct calls)
+│   └── +page.svelte      # Client-side UI
+└── hooks.server.ts       # SvelteKit hooks
+```
+
+## Setup
+
+```bash
+# Install dependencies
+bun install
+
+# Development
+bun run dev
+
+# Build
+bun run build
+
+# Production
+PORT=3000 bun build/server/entry.js
+```
+
+## Key Files
+
+### svelte.config.js
+
+```js
+import adapter from '@donkeylabs/adapter-sveltekit';
+
+export default {
+  kit: {
+    adapter: adapter({
+      serverEntry: './src/server/index.ts',
+    })
+  }
+};
+```
+
+### src/server/index.ts
+
+Defines the @donkeylabs/server with plugins and routes.
+
+### src/lib/api.ts
+
+Typed API client extending `UnifiedApiClientBase`.
+
+### src/hooks.server.ts
+
+```ts
+import { createHandle } from "@donkeylabs/adapter-sveltekit/hooks";
+export const handle = createHandle();
+```
+
+### src/routes/+page.server.ts
+
+```ts
+import { createApi } from '$lib/api';
+
+export const load = async ({ locals }) => {
+  const api = createApi({ locals }); // Direct calls
+  const data = await api.counter.get();
+  return { count: data.count };
+};
+```
+
+### src/routes/+page.svelte
+
+```svelte
+<script>
+  import { createApi } from '$lib/api';
+  const api = createApi(); // HTTP calls
+
+  // SSE subscription
+  api.sse.subscribe(['events'], (event, data) => {
+    // Handle real-time updates
+  });
+</script>
+```
+
+## Documentation
+
+See [docs/sveltekit-adapter.md](../../docs/sveltekit-adapter.md) for complete documentation.

package/templates/sveltekit-app/donkeylabs.config.ts

@@ -0,0 +1,10 @@
+import { defineConfig } from "@donkeylabs/server";
+
+export default defineConfig({
+  plugins: ["./src/server/plugins/**/index.ts"],
+  outDir: ".@donkeylabs/server",
+  adapter: "@donkeylabs/adapter-sveltekit",
+  client: {
+    output: "./src/lib/api.ts",
+  },
+});

package/templates/sveltekit-app/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "my-sveltekit-app",
+  "private": true,
+  "version": "0.0.1",
+  "type": "module",
+  "scripts": {
+    "dev": "bun --bun vite dev",
+    "build": "vite build",
+    "preview": "bun build/server/entry.js",
+    "prepare": "svelte-kit sync || echo ''",
+    "check": "svelte-kit sync && svelte-check --tsconfig ./tsconfig.json",
+    "gen:types": "donkeylabs generate"
+  },
+  "devDependencies": {
+    "@donkeylabs/cli": "*",
+    "@sveltejs/kit": "^2.49.1",
+    "@sveltejs/vite-plugin-svelte": "^6.2.1",
+    "@tailwindcss/vite": "^4.1.18",
+    "svelte": "^5.45.6",
+    "svelte-check": "^4.3.4",
+    "tailwindcss": "^4.1.18",
+    "typescript": "^5.9.3",
+    "vite": "^7.2.6"
+  },
+  "dependencies": {
+    "@donkeylabs/adapter-sveltekit": "*",
+    "@donkeylabs/server": "*",
+    "bits-ui": "^2.15.4",
+    "clsx": "^2.1.1",
+    "kysely": "^0.27.6",
+    "kysely-bun-sqlite": "^0.3.2",
+    "tailwind-merge": "^3.4.0",
+    "tailwind-variants": "^3.2.2",
+    "zod": "^3.24.0"
+  }
+}

package/templates/sveltekit-app/src/app.css

@@ -0,0 +1,40 @@
+@import "tailwindcss";
+
+@theme {
+  --color-background: oklch(100% 0 0);
+  --color-foreground: oklch(14.1% 0.005 285.82);
+  --color-card: oklch(100% 0 0);
+  --color-card-foreground: oklch(14.1% 0.005 285.82);
+  --color-popover: oklch(100% 0 0);
+  --color-popover-foreground: oklch(14.1% 0.005 285.82);
+  --color-primary: oklch(20.5% 0.006 285.88);
+  --color-primary-foreground: oklch(98.5% 0.002 247.86);
+  --color-secondary: oklch(96.8% 0.003 264.54);
+  --color-secondary-foreground: oklch(20.5% 0.006 285.88);
+  --color-muted: oklch(96.8% 0.003 264.54);
+  --color-muted-foreground: oklch(55.2% 0.016 285.94);
+  --color-accent: oklch(96.8% 0.003 264.54);
+  --color-accent-foreground: oklch(20.5% 0.006 285.88);
+  --color-destructive: oklch(57.7% 0.245 27.33);
+  --color-destructive-foreground: oklch(98.5% 0.002 247.86);
+  --color-border: oklch(91.4% 0.007 264.53);
+  --color-input: oklch(91.4% 0.007 264.53);
+  --color-ring: oklch(70.7% 0.022 261.33);
+  --color-success: oklch(72.3% 0.219 149.58);
+  --color-success-foreground: oklch(20.5% 0.006 285.88);
+  --color-warning: oklch(79.5% 0.184 86.05);
+  --color-warning-foreground: oklch(20.5% 0.006 285.88);
+  --radius-sm: 0.25rem;
+  --radius-md: 0.375rem;
+  --radius-lg: 0.5rem;
+  --radius-xl: 0.75rem;
+}
+
+@layer base {
+  * {
+    @apply border-border;
+  }
+  body {
+    @apply bg-background text-foreground;
+  }
+}

package/templates/sveltekit-app/src/app.html

@@ -0,0 +1,12 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="utf-8" />
+    <link rel="icon" href="%sveltekit.assets%/favicon.png" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    %sveltekit.head%
+  </head>
+  <body data-sveltekit-preload-data="hover">
+    <div style="display: contents">%sveltekit.body%</div>
+  </body>
+</html>

package/templates/sveltekit-app/src/hooks.server.ts

@@ -0,0 +1,4 @@
+// SvelteKit hooks for @donkeylabs/adapter-sveltekit
+import { createHandle } from "@donkeylabs/adapter-sveltekit/hooks";
+
+export const handle = createHandle();

package/templates/sveltekit-app/src/lib/api.ts

@@ -0,0 +1,134 @@
+/**
+ * Generated API client for the demo
+ * Extends UnifiedApiClientBase to handle SSR direct calls and browser HTTP calls
+ */
+import { UnifiedApiClientBase } from "@donkeylabs/adapter-sveltekit/client";
+
+// Route type definitions
+export interface CounterResponse {
+  count: number;
+}
+
+export interface CacheGetResponse {
+  value: any;
+  exists: boolean;
+}
+
+export interface CacheKeysResponse {
+  keys: string[];
+  size: number;
+}
+
+export interface JobEnqueueResponse {
+  jobId: string;
+}
+
+export interface JobStatsResponse {
+  pending: number;
+  running: number;
+  completed: number;
+}
+
+export interface CronTask {
+  id: string;
+  name: string;
+  expression: string;
+  enabled: boolean;
+  lastRun?: string;
+  nextRun?: string;
+}
+
+export interface CronListResponse {
+  tasks: CronTask[];
+}
+
+export interface RateLimitResult {
+  allowed: boolean;
+  remaining: number;
+  limit: number;
+  resetAt: string;
+  retryAfter?: number;
+}
+
+export interface SSEClientsResponse {
+  total: number;
+  byChannel: number;
+}
+
+/**
+ * Typed API client for the demo server
+ */
+export class ApiClient extends UnifiedApiClientBase {
+  // Counter routes
+  counter = {
+    get: () => this.request<{}, CounterResponse>("api.counter.get", {}),
+    increment: () => this.request<{}, CounterResponse>("api.counter.increment", {}),
+    decrement: () => this.request<{}, CounterResponse>("api.counter.decrement", {}),
+    reset: () => this.request<{}, CounterResponse>("api.counter.reset", {}),
+  };
+
+  // Cache routes
+  cache = {
+    set: (input: { key: string; value: any; ttl?: number }) =>
+      this.request<typeof input, { success: boolean }>("api.cache.set", input),
+    get: (input: { key: string }) =>
+      this.request<typeof input, CacheGetResponse>("api.cache.get", input),
+    delete: (input: { key: string }) =>
+      this.request<typeof input, { success: boolean }>("api.cache.delete", input),
+    keys: () =>
+      this.request<{}, CacheKeysResponse>("api.cache.keys", {}),
+  };
+
+  // Jobs routes
+  jobs = {
+    enqueue: (input: { name?: string; data?: any; delay?: number }) =>
+      this.request<typeof input, JobEnqueueResponse>("api.jobs.enqueue", input),
+    stats: () =>
+      this.request<{}, JobStatsResponse>("api.jobs.stats", {}),
+  };
+
+  // Cron routes
+  cron = {
+    list: () =>
+      this.request<{}, CronListResponse>("api.cron.list", {}),
+  };
+
+  // Rate limiter routes
+  ratelimit = {
+    check: (input: { key?: string; limit?: number; window?: number }) =>
+      this.request<typeof input, RateLimitResult>("api.ratelimit.check", input),
+    reset: (input: { key?: string }) =>
+      this.request<typeof input, { success: boolean }>("api.ratelimit.reset", input),
+  };
+
+  // Events routes
+  events = {
+    emit: (input: { event?: string; data?: any }) =>
+      this.request<typeof input, { success: boolean }>("api.events.emit", input),
+  };
+
+  // SSE routes
+  sseRoutes = {
+    broadcast: (input: { channel?: string; event?: string; data: any }) =>
+      this.request<typeof input, { success: boolean }>("api.sse.broadcast", input),
+    clients: () =>
+      this.request<{}, SSEClientsResponse>("api.sse.clients", {}),
+  };
+}
+
+/**
+ * Create an API client instance
+ *
+ * @example
+ * // In +page.server.ts (SSR - direct calls)
+ * const api = createApi({ locals });
+ * const data = await api.counter.get();
+ *
+ * @example
+ * // In +page.svelte (browser - HTTP calls)
+ * const api = createApi();
+ * const data = await api.counter.get();
+ */
+export function createApi(options?: { locals?: any }) {
+  return new ApiClient(options);
+}

package/templates/sveltekit-app/src/lib/components/ui/badge/badge.svelte

@@ -0,0 +1,30 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { BadgeVariant } from "./index";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLDivElement> {
+    variant?: BadgeVariant;
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { variant = "default", class: className, children, ...restProps }: Props = $props();
+
+  const baseStyles = "inline-flex items-center rounded-md border px-2.5 py-0.5 text-xs font-semibold transition-colors focus:outline-none focus:ring-2 focus:ring-ring focus:ring-offset-2";
+
+  const variants: Record<BadgeVariant, string> = {
+    default: "border-transparent bg-primary text-primary-foreground shadow hover:bg-primary/80",
+    secondary: "border-transparent bg-secondary text-secondary-foreground hover:bg-secondary/80",
+    destructive: "border-transparent bg-destructive text-destructive-foreground shadow hover:bg-destructive/80",
+    outline: "text-foreground",
+    success: "border-transparent bg-success text-success-foreground shadow hover:bg-success/80",
+  };
+</script>
+
+<div class={cn(baseStyles, variants[variant], className)} {...restProps}>
+  {#if children}
+    {@render children()}
+  {/if}
+</div>

package/templates/sveltekit-app/src/lib/components/ui/badge/index.ts

@@ -0,0 +1,3 @@
+import Root from "./badge.svelte";
+export type BadgeVariant = "default" | "secondary" | "destructive" | "outline" | "success";
+export { Root, Root as Badge };

package/templates/sveltekit-app/src/lib/components/ui/button/button.svelte

@@ -0,0 +1,48 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { ButtonVariant, ButtonSize } from "./index";
+  import type { Snippet } from "svelte";
+  import type { HTMLButtonAttributes } from "svelte/elements";
+
+  interface Props extends HTMLButtonAttributes {
+    variant?: ButtonVariant;
+    size?: ButtonSize;
+    class?: string;
+    children?: Snippet;
+  }
+
+  let {
+    variant = "default",
+    size = "default",
+    class: className,
+    children,
+    ...restProps
+  }: Props = $props();
+
+  const baseStyles = "inline-flex items-center justify-center gap-2 whitespace-nowrap rounded-md text-sm font-medium transition-colors focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:pointer-events-none disabled:opacity-50";
+
+  const variants: Record<ButtonVariant, string> = {
+    default: "bg-primary text-primary-foreground shadow hover:bg-primary/90",
+    destructive: "bg-destructive text-destructive-foreground shadow-sm hover:bg-destructive/90",
+    outline: "border border-input bg-background shadow-sm hover:bg-accent hover:text-accent-foreground",
+    secondary: "bg-secondary text-secondary-foreground shadow-sm hover:bg-secondary/80",
+    ghost: "hover:bg-accent hover:text-accent-foreground",
+    link: "text-primary underline-offset-4 hover:underline",
+  };
+
+  const sizes: Record<ButtonSize, string> = {
+    default: "h-9 px-4 py-2",
+    sm: "h-8 rounded-md px-3 text-xs",
+    lg: "h-10 rounded-md px-8",
+    icon: "h-9 w-9",
+  };
+</script>
+
+<button
+  class={cn(baseStyles, variants[variant], sizes[size], className)}
+  {...restProps}
+>
+  {#if children}
+    {@render children()}
+  {/if}
+</button>

package/templates/sveltekit-app/src/lib/components/ui/button/index.ts

@@ -0,0 +1,9 @@
+import Root from "./button.svelte";
+
+export type ButtonVariant = "default" | "destructive" | "outline" | "secondary" | "ghost" | "link";
+export type ButtonSize = "default" | "sm" | "lg" | "icon";
+
+export {
+  Root,
+  Root as Button,
+};

package/templates/sveltekit-app/src/lib/components/ui/card/card-content.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLDivElement> {
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { class: className, children, ...restProps }: Props = $props();
+</script>
+
+<div class={cn("p-6 pt-0", className)} {...restProps}>
+  {#if children}
+    {@render children()}
+  {/if}
+</div>

package/templates/sveltekit-app/src/lib/components/ui/card/card-description.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLParagraphElement> {
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { class: className, children, ...restProps }: Props = $props();
+</script>
+
+<p class={cn("text-sm text-muted-foreground", className)} {...restProps}>
+  {#if children}
+    {@render children()}
+  {/if}
+</p>

package/templates/sveltekit-app/src/lib/components/ui/card/card-footer.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLDivElement> {
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { class: className, children, ...restProps }: Props = $props();
+</script>
+
+<div class={cn("flex items-center p-6 pt-0", className)} {...restProps}>
+  {#if children}
+    {@render children()}
+  {/if}
+</div>

package/templates/sveltekit-app/src/lib/components/ui/card/card-header.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLDivElement> {
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { class: className, children, ...restProps }: Props = $props();
+</script>
+
+<div class={cn("flex flex-col space-y-1.5 p-6", className)} {...restProps}>
+  {#if children}
+    {@render children()}
+  {/if}
+</div>

package/templates/sveltekit-app/src/lib/components/ui/card/card-title.svelte

@@ -0,0 +1,18 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLHeadingElement> {
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { class: className, children, ...restProps }: Props = $props();
+</script>
+
+<h3 class={cn("font-semibold leading-none tracking-tight", className)} {...restProps}>
+  {#if children}
+    {@render children()}
+  {/if}
+</h3>

package/templates/sveltekit-app/src/lib/components/ui/card/card.svelte

@@ -0,0 +1,21 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { Snippet } from "svelte";
+  import type { HTMLAttributes } from "svelte/elements";
+
+  interface Props extends HTMLAttributes<HTMLDivElement> {
+    class?: string;
+    children?: Snippet;
+  }
+
+  let { class: className, children, ...restProps }: Props = $props();
+</script>
+
+<div
+  class={cn("rounded-xl border bg-card text-card-foreground shadow", className)}
+  {...restProps}
+>
+  {#if children}
+    {@render children()}
+  {/if}
+</div>

package/templates/sveltekit-app/src/lib/components/ui/card/index.ts

@@ -0,0 +1,21 @@
+import Root from "./card.svelte";
+import Content from "./card-content.svelte";
+import Description from "./card-description.svelte";
+import Footer from "./card-footer.svelte";
+import Header from "./card-header.svelte";
+import Title from "./card-title.svelte";
+
+export {
+  Root,
+  Content,
+  Description,
+  Footer,
+  Header,
+  Title,
+  Root as Card,
+  Content as CardContent,
+  Description as CardDescription,
+  Footer as CardFooter,
+  Header as CardHeader,
+  Title as CardTitle,
+};

package/templates/sveltekit-app/src/lib/components/ui/index.ts

@@ -0,0 +1,4 @@
+export * from "./button";
+export * from "./card";
+export * from "./input";
+export * from "./badge";

package/templates/sveltekit-app/src/lib/components/ui/input/index.ts

@@ -0,0 +1,2 @@
+import Root from "./input.svelte";
+export { Root, Root as Input };

package/templates/sveltekit-app/src/lib/components/ui/input/input.svelte

@@ -0,0 +1,20 @@
+<script lang="ts">
+  import { cn } from "$lib/utils";
+  import type { HTMLInputAttributes } from "svelte/elements";
+
+  interface Props extends HTMLInputAttributes {
+    class?: string;
+    value?: string | number;
+  }
+
+  let { class: className, value = $bindable(), ...restProps }: Props = $props();
+</script>
+
+<input
+  class={cn(
+    "flex h-9 w-full rounded-md border border-input bg-transparent px-3 py-1 text-base shadow-sm transition-colors file:border-0 file:bg-transparent file:text-sm file:font-medium file:text-foreground placeholder:text-muted-foreground focus-visible:outline-none focus-visible:ring-1 focus-visible:ring-ring disabled:cursor-not-allowed disabled:opacity-50 md:text-sm",
+    className
+  )}
+  bind:value
+  {...restProps}
+/>

package/templates/sveltekit-app/src/lib/utils/index.ts

@@ -0,0 +1,6 @@
+import { clsx, type ClassValue } from "clsx";
+import { twMerge } from "tailwind-merge";
+
+export function cn(...inputs: ClassValue[]) {
+  return twMerge(clsx(inputs));
+}

package/templates/sveltekit-app/src/routes/+layout.svelte

@@ -0,0 +1,8 @@
+<script lang="ts">
+  import "../app.css";
+  import type { Snippet } from "svelte";
+
+  let { children }: { children: Snippet } = $props();
+</script>
+
+{@render children()}

package/templates/sveltekit-app/src/routes/+page.server.ts

@@ -0,0 +1,25 @@
+// Test SSR direct service calls using the typed API client
+import type { PageServerLoad } from './$types';
+import { createApi } from '$lib/api';
+
+export const load: PageServerLoad = async ({ locals }) => {
+  // Create API client with locals for direct SSR calls (no HTTP!)
+  const api = createApi({ locals });
+
+  try {
+    // Direct service call through typed client
+    const { count } = await api.counter.get();
+    return {
+      count,
+      loadedAt: new Date().toISOString(),
+      isSSR: true,
+    };
+  } catch (e) {
+    // Fallback if plugins not loaded yet
+    return {
+      count: 'N/A (plugins not loaded)',
+      loadedAt: new Date().toISOString(),
+      isSSR: true,
+    };
+  }
+};