@robodev-ai/sdk 0.3.0 → 0.5.0

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@robodev-ai/sdk",
-  "version": "0.3.0",
-  "description": "Robodev server SDK — defineDatabase, defineApi, auth, and the injected Drizzle db",
+  "version": "0.5.0",
+  "description": "Robodev server SDK — defineDatabase, defineApi, auth, email, storage, and the injected Drizzle db",
   "type": "module",
   "license": "MIT",
   "repository": {

package/src/api.ts

@@ -1,13 +1,17 @@
 import { z } from "zod";
 import type { ApiAuth, AuthUser } from "./auth.js";
 import type { RobodevDb } from "./db.js";
+import type { EmailClient } from "./email.js";
+import type { StorageClient } from "./storage.js";
 
 /** Marker written onto every `defineApi(...)` result so Starbase can register the handler. */
 export const API_KIND = "robodevApi";
 
-/** Injected into every handler: tenant `db`, parsed query/body, headers, and optional `user`. */
+/** Injected into every handler: tenant `db`, `email`, `storage`, parsed query/body, headers, and optional `user`. */
 export type ApiHandlerContext<TQuery, TBody> = {
   db: RobodevDb;
+  email: EmailClient;
+  storage: StorageClient;
   query: TQuery;
   body: TBody;
   headers: Record<string, string | string[] | undefined>;

package/src/email.ts

@@ -0,0 +1,16 @@
+export type EmailSendInput = {
+  to: string | string[];
+  subject: string;
+  html?: string;
+  text?: string;
+  from?: string;
+};
+
+export type EmailSendResult = {
+  id: string;
+  status: "sent";
+};
+
+export type EmailClient = {
+  send: (input: EmailSendInput) => Promise<EmailSendResult>;
+};

package/src/index.ts

@@ -11,6 +11,8 @@ export {
   type HttpMethod,
 } from "./api.js";
 export { type ApiAuth, type AuthUser, type AuthVerifier } from "./auth.js";
+export { type EmailClient, type EmailSendInput, type EmailSendResult } from "./email.js";
+export { type StorageClient, type StorageObject, type StorageUploadOptions } from "./storage.js";
 export { createDb, type RobodevDb } from "./db.js";
 export {
   and,

package/src/storage.ts

@@ -0,0 +1,28 @@
+export type StorageUploadOptions = {
+  public?: boolean;
+  contentType?: string;
+};
+
+export type StorageObject = {
+  key: string;
+  public: boolean;
+  size: number;
+  contentType: string;
+  url: string;
+};
+
+export type StorageClient = {
+  upload(
+    key: string,
+    data: Buffer | Uint8Array | string,
+    options?: StorageUploadOptions,
+  ): Promise<StorageObject>;
+  get(key: string): Promise<{ body: Buffer; contentType: string; public: boolean }>;
+  getUrl(key: string, options?: { expiresIn?: number }): Promise<string>;
+  delete(key: string): Promise<void>;
+  list(options?: {
+    prefix?: string;
+    limit?: number;
+    offset?: number;
+  }): Promise<{ objects: StorageObject[]; total: number }>;
+};