@donkeylabs/cli 0.1.1 → 0.4.0

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

@@ -1,73 +1,247 @@
-// Auto-generated by donkeylabs generate
+// Auto-generated by @donkeylabs/server
 // DO NOT EDIT MANUALLY
 
 import { UnifiedApiClientBase, type ClientOptions } from "@donkeylabs/adapter-sveltekit/client";
 
+// Utility type that forces TypeScript to expand types on hover
+type Expand<T> = T extends infer O ? { [K in keyof O]: O[K] } : never;
+
+/**
+ * Handler interface for implementing route handlers in model classes.
+ * @example
+ * class CounterModel implements Handler<Routes.Counter.get> {
+ *   handle(input: Routes.Counter.get.Input): Routes.Counter.get.Output {
+ *     return { count: 0 };
+ *   }
+ * }
+ */
+export interface Handler<T extends { Input: any; Output: any }> {
+  handle(input: T["Input"]): T["Output"] | Promise<T["Output"]>;
+}
+
+// Re-export server context for model classes
+export { type ServerContext as AppContext } from "@donkeylabs/server";
+
+// ============================================
+// Route Types
+// ============================================
+
+export namespace Routes {
+  export namespace Counter {
+    export namespace get {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  count: number;
+}>;
+    }
+
+    export namespace increment {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  count: number;
+}>;
+    }
+
+    export namespace decrement {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  count: number;
+}>;
+    }
+
+    export namespace reset {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  count: number;
+}>;
+    }
+  }
+
+  export namespace Cache {
+    export namespace set {
+      export type Input = Expand<{
+  key: string;
+  value: any;
+  ttl?: number;
+}>;
+      export type Output = Expand<{
+  success: boolean;
+}>;
+    }
+
+    export namespace get {
+      export type Input = Expand<{
+  key: string;
+}>;
+      export type Output = Expand<{
+  value?: any;
+  exists: boolean;
+}>;
+    }
+
+    export namespace delete {
+      export type Input = Expand<{
+  key: string;
+}>;
+      export type Output = Expand<{
+  success: boolean;
+}>;
+    }
+
+    export namespace keys {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  keys: string[];
+}>;
+    }
+  }
+
+  export namespace Jobs {
+    export namespace enqueue {
+      export type Input = Expand<{
+  name: string;
+  data: any;
+  delay?: number;
+}>;
+      export type Output = Expand<{
+  jobId: string;
+}>;
+    }
+
+    export namespace stats {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  pending: number;
+  running: number;
+  completed: number;
+}>;
+    }
+  }
+
+  export namespace Cron {
+    export namespace list {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  tasks: {
+  id: string;
+  name: string;
+  expression: string;
+  enabled: boolean;
+  lastRun?: string;
+  nextRun?: string;
+}[];
+}>;
+    }
+  }
+
+  export namespace Ratelimit {
+    export namespace check {
+      export type Input = Expand<{
+  key: string;
+  limit: number;
+  window: number;
+}>;
+      export type Output = Expand<{
+  allowed: boolean;
+  remaining: number;
+  resetAt: Date;
+}>;
+    }
+
+    export namespace reset {
+      export type Input = Expand<{
+  key: string;
+}>;
+      export type Output = Expand<{
+  success: boolean;
+}>;
+    }
+  }
+
+  export namespace Events {
+    export namespace emit {
+      export type Input = Expand<{
+  event: string;
+  data: any;
+}>;
+      export type Output = Expand<{
+  success: boolean;
+}>;
+    }
+  }
+
+  export namespace Sse {
+    export namespace broadcast {
+      export type Input = Expand<{
+  channel: string;
+  event: string;
+  data: any;
+}>;
+      export type Output = Expand<{
+  success: boolean;
+  recipients: number;
+}>;
+    }
+
+    export namespace clients {
+      export type Input = Expand<Record<string, never>>;
+      export type Output = Expand<{
+  total: number;
+  byChannel: number;
+}>;
+    }
+  }
+}
+
+// ============================================
+// API Client
+// ============================================
+
 export class ApiClient extends UnifiedApiClientBase {
   constructor(options?: ClientOptions) {
     super(options);
   }
 
-  api = {
-    counter: {
-      get: (input: any) => this.request("api.counter.get", input),
-      increment: (input: any) => this.request("api.counter.increment", input),
-      decrement: (input: any) => this.request("api.counter.decrement", input),
-      reset: (input: any) => this.request("api.counter.reset", input)
-    },
-    cache: {
-      set: (input: any) => this.request("api.cache.set", input),
-      get: (input: any) => this.request("api.cache.get", input),
-      delete: (input: any) => this.request("api.cache.delete", input),
-      keys: (input: any) => this.request("api.cache.keys", input)
-    },
-    jobs: {
-      enqueue: (input: any) => this.request("api.jobs.enqueue", input),
-      stats: (input: any) => this.request("api.jobs.stats", input)
-    },
-    cron: {
-      list: (input: any) => this.request("api.cron.list", input)
-    },
-    ratelimit: {
-      check: (input: any) => this.request("api.ratelimit.check", input),
-      reset: (input: any) => this.request("api.ratelimit.reset", input)
-    },
-    events: {
-      emit: (input: any) => this.request("api.events.emit", input)
-    },
-    sse: {
-      broadcast: (input: any) => this.request("api.sse.broadcast", input),
-      clients: (input: any) => this.request("api.sse.clients", input)
-    }
+  counter = {
+    get: (input: Routes.Counter.get.Input): Promise<Routes.Counter.get.Output> => this.request("api.counter.get", input),
+    increment: (input: Routes.Counter.increment.Input): Promise<Routes.Counter.increment.Output> => this.request("api.counter.increment", input),
+    decrement: (input: Routes.Counter.decrement.Input): Promise<Routes.Counter.decrement.Output> => this.request("api.counter.decrement", input),
+    reset: (input: Routes.Counter.reset.Input): Promise<Routes.Counter.reset.Output> => this.request("api.counter.reset", input)
+  };
+
+  cache = {
+    set: (input: Routes.Cache.set.Input): Promise<Routes.Cache.set.Output> => this.request("api.cache.set", input),
+    get: (input: Routes.Cache.get.Input): Promise<Routes.Cache.get.Output> => this.request("api.cache.get", input),
+    delete: (input: Routes.Cache.delete.Input): Promise<Routes.Cache.delete.Output> => this.request("api.cache.delete", input),
+    keys: (input: Routes.Cache.keys.Input): Promise<Routes.Cache.keys.Output> => this.request("api.cache.keys", input)
+  };
+
+  jobs = {
+    enqueue: (input: Routes.Jobs.enqueue.Input): Promise<Routes.Jobs.enqueue.Output> => this.request("api.jobs.enqueue", input),
+    stats: (input: Routes.Jobs.stats.Input): Promise<Routes.Jobs.stats.Output> => this.request("api.jobs.stats", input)
+  };
+
+  cron = {
+    list: (input: Routes.Cron.list.Input): Promise<Routes.Cron.list.Output> => this.request("api.cron.list", input)
+  };
+
+  ratelimit = {
+    check: (input: Routes.Ratelimit.check.Input): Promise<Routes.Ratelimit.check.Output> => this.request("api.ratelimit.check", input),
+    reset: (input: Routes.Ratelimit.reset.Input): Promise<Routes.Ratelimit.reset.Output> => this.request("api.ratelimit.reset", input)
+  };
+
+  events = {
+    emit: (input: Routes.Events.emit.Input): Promise<Routes.Events.emit.Output> => this.request("api.events.emit", input)
+  };
+
+  sse = {
+    broadcast: (input: Routes.Sse.broadcast.Input): Promise<Routes.Sse.broadcast.Output> => this.request("api.sse.broadcast", input),
+    clients: (input: Routes.Sse.clients.Input): Promise<Routes.Sse.clients.Output> => this.request("api.sse.clients", input)
   };
 }
 
 /**
  * Create an API client instance
- *
- * @param options.locals - Pass SvelteKit locals for SSR direct calls (no HTTP overhead)
- * @param options.baseUrl - Override the base URL for HTTP calls
- *
- * @example SSR usage in +page.server.ts:
- * ```ts
- * export const load = async ({ locals }) => {
- *   const api = createApi({ locals });
- *   const data = await api.myRoute.get({}); // Direct call, no HTTP!
- *   return { data };
- * };
- * ```
- *
- * @example Browser usage in +page.svelte:
- * ```svelte
- * <script>
- *   import { createApi } from '$lib/api';
- *   const api = createApi(); // HTTP calls
- *   let data = $state(null);
- *   async function load() {
- *     data = await api.myRoute.get({});
- *   }
- * </script>
- * ```
  */
 export function createApi(options?: ClientOptions) {
   return new ApiClient(options);

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

@@ -4,11 +4,11 @@ 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 });
+  const client = createApi({ locals });
 
   try {
     // Direct service call through typed client
-    const result = await api.api.counter.get({}) as { count: number };
+    const result = await client.counter.get({});
     return {
       count: result.count,
       loadedAt: new Date().toISOString(),