@calculator-5329/cloud-proxy 0.1.0

package/README.md

@@ -0,0 +1,243 @@
+# @et2bo/cloud-proxy
+
+TypeScript client SDK for the Cloud Run proxy server. Zero runtime dependencies, fully typed, ESM-only.
+
+## Install
+
+```bash
+npm install @et2bo/cloud-proxy
+```
+
+**Requirements:** Node 18+ (uses global `fetch`)
+
+## Quick Start
+
+```typescript
+import { createClient } from "@et2bo/cloud-proxy";
+
+const proxy = createClient({
+  baseUrl: process.env.PROXY_URL!,
+  token: process.env.PROXY_TOKEN!,
+});
+
+// Health check
+const { status } = await proxy.health();
+```
+
+Set two environment variables and you're done:
+
+```env
+PROXY_URL=https://your-service-xyz.run.app
+PROXY_TOKEN=your-static-bearer-token
+```
+
+## Modules
+
+Every module is accessible as a property on the client object. Modules are lazily instantiated on first access.
+
+| Module | Accessor | Description |
+|--------|----------|-------------|
+| AI | `proxy.ai` | OpenAI, Anthropic, Gemini, OpenRouter passthrough |
+| Auth | `proxy.auth` | Firebase Auth user management |
+| Firestore | `proxy.firestore` | Firestore CRUD, queries, batch, aggregates |
+| Storage | `proxy.storage` | GCS upload, download, signed URLs, buckets |
+| Vectors | `proxy.vectors` | Vector search + Gemini embeddings |
+| Setup | `proxy.setup` | Provisioning + project bootstrap |
+
+---
+
+## AI
+
+```typescript
+// Direct provider passthrough
+const response = await proxy.ai.openai("/v1/chat/completions", {
+  model: "gpt-4o",
+  messages: [{ role: "user", content: "Hello" }],
+});
+
+// Convenience chat — normalized response across all providers
+const reply = await proxy.ai.chat({
+  provider: "anthropic",
+  model: "claude-sonnet-4-20250514",
+  messages: [{ role: "user", content: "Explain quantum computing" }],
+  maxTokens: 1024,
+});
+console.log(reply.content);
+
+// Streaming
+const stream = await proxy.ai.chatStream({
+  provider: "openai",
+  model: "gpt-4o",
+  messages: [{ role: "user", content: "Write a poem" }],
+});
+for await (const chunk of stream) {
+  process.stdout.write(new TextDecoder().decode(chunk));
+}
+```
+
+## Auth
+
+```typescript
+const user = await proxy.auth.createUser({
+  email: "alice@example.com",
+  password: "securepassword",
+  displayName: "Alice",
+});
+
+await proxy.auth.setClaims(user.uid, { admin: true });
+
+const users = await proxy.auth.listUsers({ limit: 50 });
+
+// Email links
+const { link } = await proxy.auth.generatePasswordResetLink("alice@example.com");
+
+// Session cookies
+const { cookie } = await proxy.auth.createSessionCookie(idToken, 7 * 24 * 60 * 60 * 1000);
+const decoded = await proxy.auth.verifySessionCookie(cookie, true);
+```
+
+## Firestore
+
+```typescript
+// CRUD
+const post = await proxy.firestore.create("posts", { title: "Hello", body: "World" });
+const doc = await proxy.firestore.get<{ title: string }>("posts/abc123");
+await proxy.firestore.update("posts/abc123", { title: "Updated" });
+await proxy.firestore.delete("posts/abc123");
+
+// Query
+const published = await proxy.firestore.query("posts", {
+  filters: [{ field: "status", op: "==", value: "published" }],
+  orderBy: [{ field: "createdAt", direction: "desc" }],
+  limit: 50,
+});
+
+// Subcollections
+const comments = await proxy.firestore.list("posts/abc123/comments");
+// Or scoped:
+const scoped = proxy.firestore.sub("posts/abc123");
+await scoped.list("comments");
+
+// Atomic field operations
+import { FieldOp } from "@et2bo/cloud-proxy";
+
+await proxy.firestore.patch("posts/abc123", {
+  views: FieldOp.increment(1),
+  tags: FieldOp.arrayUnion("featured"),
+});
+
+// Batch
+await proxy.firestore.batch([
+  { type: "create", collection: "posts", data: { title: "A" } },
+  { type: "delete", collection: "posts", docId: "old" },
+]);
+
+// Aggregates
+const stats = await proxy.firestore.aggregate("orders", {
+  aggregations: [
+    { type: "count", alias: "total" },
+    { type: "sum", field: "amount", alias: "revenue" },
+  ],
+  filters: [{ field: "status", op: "==", value: "completed" }],
+});
+
+// Collection group queries
+const allComments = await proxy.firestore.query("comments", {
+  collectionGroup: true,
+  filters: [{ field: "flagged", op: "==", value: true }],
+});
+```
+
+## Storage
+
+```typescript
+// Direct upload
+const result = await proxy.storage.upload("my-bucket", file, {
+  path: "avatars",
+  public: true,
+});
+
+// Signed URL upload (large files)
+const { uploadUrl } = await proxy.storage.getUploadUrl("my-bucket", {
+  filename: "video.mp4",
+  contentType: "video/mp4",
+  expiresInMinutes: 30,
+});
+
+// Download
+const { downloadUrl } = await proxy.storage.getDownloadUrl("my-bucket", "photo.jpg", 120);
+const response = await proxy.storage.download("my-bucket", "report.pdf");
+
+// List & delete
+const files = await proxy.storage.listFiles("my-bucket", { prefix: "avatars/" });
+await proxy.storage.deleteFile("my-bucket", "old-file.txt");
+
+// Bucket management
+await proxy.storage.createBucket({ name: "new-bucket", location: "US" });
+const { buckets } = await proxy.storage.listBuckets();
+```
+
+## Vectors
+
+```typescript
+// Embed and store
+const doc = await proxy.vectors.embed("articles", "Quantum computing uses qubits...", {
+  data: { title: "Intro to Quantum", category: "science" },
+});
+
+// Batch embed
+await proxy.vectors.embedBatch("articles", [
+  { text: "First article...", data: { title: "AI" } },
+  { text: "Second article...", data: { title: "ML" } },
+]);
+
+// Semantic search
+const hits = await proxy.vectors.semanticSearch("articles", "quantum physics basics", {
+  topK: 5,
+  filters: [{ field: "category", op: "==", value: "science" }],
+});
+
+// Update & delete
+await proxy.vectors.update("articles", doc.id, { text: "Updated content..." });
+await proxy.vectors.delete("articles", doc.id);
+```
+
+## Setup
+
+```typescript
+// Bootstrap an entire project
+const status = await proxy.setup.bootstrapProject({
+  projectName: "my-app",
+  firestore: {
+    collections: [
+      { name: "users" },
+      { name: "documents", vectorIndex: true },
+    ],
+  },
+  storage: { bucketName: "my-app-assets", public: true },
+  auth: { enableEmailPassword: true },
+});
+
+// Check status
+const current = await proxy.setup.getStatus();
+```
+
+## Error Handling
+
+All errors are thrown as `ProxyError` with `code`, `status`, and `details`:
+
+```typescript
+import { ProxyError } from "@et2bo/cloud-proxy";
+
+try {
+  await proxy.firestore.get("posts/nonexistent");
+} catch (err) {
+  if (err instanceof ProxyError && err.code === "FIRESTORE_NOT_FOUND") {
+    // handle 404
+  }
+}
+```
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,32 @@
+import type { ClientConfig } from "./types.js";
+import { AiModule } from "./modules/ai.js";
+import { AuthModule } from "./modules/auth.js";
+import { FirestoreModule } from "./modules/firestore.js";
+import { StorageModule } from "./modules/storage.js";
+import { VectorModule } from "./modules/vectors.js";
+import { SetupModule } from "./modules/setup.js";
+/**
+ * Main SDK entry object. Provides lazy access to every module
+ * and a shared HTTP client for all requests.
+ */
+export declare class CloudProxy {
+    private readonly http;
+    private _ai?;
+    private _auth?;
+    private _firestore?;
+    private _storage?;
+    private _vectors?;
+    private _setup?;
+    constructor(config: ClientConfig);
+    get ai(): AiModule;
+    get auth(): AuthModule;
+    get firestore(): FirestoreModule;
+    get storage(): StorageModule;
+    get vectors(): VectorModule;
+    get setup(): SetupModule;
+    /** Quick health check against the proxy server. */
+    health(): Promise<{
+        status: string;
+    }>;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAa;IAElC,OAAO,CAAC,GAAG,CAAC,CAAW;IACvB,OAAO,CAAC,KAAK,CAAC,CAAa;IAC3B,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,QAAQ,CAAC,CAAgB;IACjC,OAAO,CAAC,QAAQ,CAAC,CAAe;IAChC,OAAO,CAAC,MAAM,CAAC,CAAc;gBAEjB,MAAM,EAAE,YAAY;IAShC,IAAI,EAAE,IAAI,QAAQ,CAEjB;IAED,IAAI,IAAI,IAAI,UAAU,CAErB;IAED,IAAI,SAAS,IAAI,eAAe,CAE/B;IAED,IAAI,OAAO,IAAI,aAAa,CAE3B;IAED,IAAI,OAAO,IAAI,YAAY,CAE1B;IAED,IAAI,KAAK,IAAI,WAAW,CAEvB;IAED,mDAAmD;IAC7C,MAAM,IAAI,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CAG5C"}

package/dist/client.js

@@ -0,0 +1,51 @@
+import { HttpClient } from "./http.js";
+import { AiModule } from "./modules/ai.js";
+import { AuthModule } from "./modules/auth.js";
+import { FirestoreModule } from "./modules/firestore.js";
+import { StorageModule } from "./modules/storage.js";
+import { VectorModule } from "./modules/vectors.js";
+import { SetupModule } from "./modules/setup.js";
+/**
+ * Main SDK entry object. Provides lazy access to every module
+ * and a shared HTTP client for all requests.
+ */
+export class CloudProxy {
+    http;
+    _ai;
+    _auth;
+    _firestore;
+    _storage;
+    _vectors;
+    _setup;
+    constructor(config) {
+        this.http = new HttpClient({
+            baseUrl: config.baseUrl,
+            token: config.token,
+            defaultHeaders: config.defaultHeaders,
+            timeout: config.timeout,
+        });
+    }
+    get ai() {
+        return (this._ai ??= new AiModule(this.http));
+    }
+    get auth() {
+        return (this._auth ??= new AuthModule(this.http));
+    }
+    get firestore() {
+        return (this._firestore ??= new FirestoreModule(this.http));
+    }
+    get storage() {
+        return (this._storage ??= new StorageModule(this.http));
+    }
+    get vectors() {
+        return (this._vectors ??= new VectorModule(this.http));
+    }
+    get setup() {
+        return (this._setup ??= new SetupModule(this.http));
+    }
+    /** Quick health check against the proxy server. */
+    async health() {
+        return this.http.request("GET", "/health");
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAC3C,OAAO,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAC/C,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,UAAU;IACJ,IAAI,CAAa;IAE1B,GAAG,CAAY;IACf,KAAK,CAAc;IACnB,UAAU,CAAmB;IAC7B,QAAQ,CAAiB;IACzB,QAAQ,CAAgB;IACxB,MAAM,CAAe;IAE7B,YAAY,MAAoB;QAC9B,IAAI,CAAC,IAAI,GAAG,IAAI,UAAU,CAAC;YACzB,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,KAAK,EAAE,MAAM,CAAC,KAAK;YACnB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,OAAO,EAAE,MAAM,CAAC,OAAO;SACxB,CAAC,CAAC;IACL,CAAC;IAED,IAAI,EAAE;QACJ,OAAO,CAAC,IAAI,CAAC,GAAG,KAAK,IAAI,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAChD,CAAC;IAED,IAAI,IAAI;QACN,OAAO,CAAC,IAAI,CAAC,KAAK,KAAK,IAAI,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACpD,CAAC;IAED,IAAI,SAAS;QACX,OAAO,CAAC,IAAI,CAAC,UAAU,KAAK,IAAI,eAAe,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC9D,CAAC;IAED,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IAC1D,CAAC;IAED,IAAI,OAAO;QACT,OAAO,CAAC,IAAI,CAAC,QAAQ,KAAK,IAAI,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACzD,CAAC;IAED,IAAI,KAAK;QACP,OAAO,CAAC,IAAI,CAAC,MAAM,KAAK,IAAI,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,CAAC;IAED,mDAAmD;IACnD,KAAK,CAAC,MAAM;QACV,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,SAAS,CAAC,CAAC;IACjE,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Error thrown by the SDK when the proxy server returns a non-2xx response.
+ * Mirrors the server's error shape: `{ code, message, status }`.
+ */
+export declare class ProxyError extends Error {
+    readonly code: string;
+    readonly status: number;
+    readonly details?: unknown;
+    constructor(message: string, code: string, status: number, details?: unknown);
+    /** Parse a non-2xx fetch Response into a ProxyError. */
+    static fromResponse(response: Response): Promise<ProxyError>;
+}
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,qBAAa,UAAW,SAAQ,KAAK;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;IAQ5E,wDAAwD;WAC3C,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,UAAU,CAAC;CAmBnE"}

package/dist/errors.js

@@ -0,0 +1,34 @@
+/**
+ * Error thrown by the SDK when the proxy server returns a non-2xx response.
+ * Mirrors the server's error shape: `{ code, message, status }`.
+ */
+export class ProxyError extends Error {
+    code;
+    status;
+    details;
+    constructor(message, code, status, details) {
+        super(message);
+        this.name = "ProxyError";
+        this.code = code;
+        this.status = status;
+        this.details = details;
+    }
+    /** Parse a non-2xx fetch Response into a ProxyError. */
+    static async fromResponse(response) {
+        let body;
+        try {
+            body = await response.json();
+        }
+        catch {
+            body = await response.text().catch(() => null);
+        }
+        const obj = body;
+        const message = (typeof obj?.message === "string" ? obj.message : null) ??
+            (typeof obj?.error === "string" ? obj.error : null) ??
+            `Request failed with status ${response.status}`;
+        const code = (typeof obj?.code === "string" ? obj.code : null) ??
+            `HTTP_${response.status}`;
+        return new ProxyError(message, code, response.status, body);
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,OAAO,UAAW,SAAQ,KAAK;IAC1B,IAAI,CAAS;IACb,MAAM,CAAS;IACf,OAAO,CAAW;IAE3B,YAAY,OAAe,EAAE,IAAY,EAAE,MAAc,EAAE,OAAiB;QAC1E,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACjB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACzB,CAAC;IAED,wDAAwD;IACxD,MAAM,CAAC,KAAK,CAAC,YAAY,CAAC,QAAkB;QAC1C,IAAI,IAAa,CAAC;QAClB,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QAC/B,CAAC;QAAC,MAAM,CAAC;YACP,IAAI,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;QACjD,CAAC;QAED,MAAM,GAAG,GAAG,IAAsC,CAAC;QACnD,MAAM,OAAO,GACX,CAAC,OAAO,GAAG,EAAE,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;YACvD,CAAC,OAAO,GAAG,EAAE,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC;YACnD,8BAA8B,QAAQ,CAAC,MAAM,EAAE,CAAC;QAClD,MAAM,IAAI,GACR,CAAC,OAAO,GAAG,EAAE,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC;YACjD,QAAQ,QAAQ,CAAC,MAAM,EAAE,CAAC;QAE5B,OAAO,IAAI,UAAU,CAAC,OAAO,EAAE,IAAI,EAAE,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAC9D,CAAC;CACF"}

package/dist/http.d.ts

@@ -0,0 +1,29 @@
+export interface HttpClientConfig {
+    baseUrl: string;
+    token: string;
+    defaultHeaders?: Record<string, string>;
+    timeout?: number;
+}
+interface RequestOptions {
+    body?: unknown;
+    query?: Record<string, string>;
+    headers?: Record<string, string>;
+}
+export declare class HttpClient {
+    private readonly baseUrl;
+    private readonly token;
+    private readonly defaultHeaders;
+    private readonly timeout;
+    constructor(config: HttpClientConfig);
+    /** JSON request → parsed JSON response. Throws ProxyError on non-2xx. */
+    request<T>(method: string, path: string, options?: RequestOptions): Promise<T>;
+    /** Streaming response. Returns the raw ReadableStream body. */
+    stream(method: string, path: string, options?: Omit<RequestOptions, "query">): Promise<ReadableStream<Uint8Array>>;
+    /** Raw Response (for file downloads, etc.). Throws ProxyError on non-2xx. */
+    raw(method: string, path: string, options?: RequestOptions): Promise<Response>;
+    /** Multipart form upload. Throws ProxyError on non-2xx. */
+    upload<T>(path: string, formData: FormData): Promise<T>;
+    private send;
+}
+export {};
+//# sourceMappingURL=http.d.ts.map

package/dist/http.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.d.ts","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,UAAU,cAAc;IACtB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC/B,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAClC;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAyB;IACxD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,MAAM,EAAE,gBAAgB;IAOpC,yEAAyE;IACnE,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,CAAC,CAAC;IAkBpF,+DAA+D;IACzD,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;IAkBxH,6EAA6E;IACvE,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,cAAc,GAAG,OAAO,CAAC,QAAQ,CAAC;IAWpF,2DAA2D;IACrD,MAAM,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,CAAC,CAAC;YAQ/C,IAAI;CAqCnB"}

package/dist/http.js

@@ -0,0 +1,91 @@
+import { ProxyError } from "./errors.js";
+export class HttpClient {
+    baseUrl;
+    token;
+    defaultHeaders;
+    timeout;
+    constructor(config) {
+        this.baseUrl = config.baseUrl.replace(/\/+$/, "");
+        this.token = config.token;
+        this.defaultHeaders = config.defaultHeaders ?? {};
+        this.timeout = config.timeout ?? 30_000;
+    }
+    /** JSON request → parsed JSON response. Throws ProxyError on non-2xx. */
+    async request(method, path, options) {
+        const response = await this.send(method, path, {
+            body: options?.body,
+            query: options?.query,
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                ...options?.headers,
+            },
+        });
+        if (!response.ok)
+            throw await ProxyError.fromResponse(response);
+        const text = await response.text();
+        if (!text)
+            return undefined;
+        return JSON.parse(text);
+    }
+    /** Streaming response. Returns the raw ReadableStream body. */
+    async stream(method, path, options) {
+        const response = await this.send(method, path, {
+            body: options?.body,
+            headers: {
+                "Content-Type": "application/json",
+                Accept: "text/event-stream",
+                ...options?.headers,
+            },
+        });
+        if (!response.ok)
+            throw await ProxyError.fromResponse(response);
+        if (!response.body) {
+            throw new ProxyError("Response body is null — streaming not supported", "STREAM_ERROR", 0);
+        }
+        return response.body;
+    }
+    /** Raw Response (for file downloads, etc.). Throws ProxyError on non-2xx. */
+    async raw(method, path, options) {
+        const response = await this.send(method, path, {
+            body: options?.body,
+            query: options?.query,
+            headers: options?.headers,
+        });
+        if (!response.ok)
+            throw await ProxyError.fromResponse(response);
+        return response;
+    }
+    /** Multipart form upload. Throws ProxyError on non-2xx. */
+    async upload(path, formData) {
+        const response = await this.send("POST", path, { formData });
+        if (!response.ok)
+            throw await ProxyError.fromResponse(response);
+        return (await response.json());
+    }
+    // ── Internal ──
+    async send(method, path, options) {
+        let url = `${this.baseUrl}${path.startsWith("/") ? path : `/${path}`}`;
+        if (options.query) {
+            const params = new URLSearchParams(options.query);
+            url += `?${params.toString()}`;
+        }
+        const headers = {
+            "x-api-key": this.token,
+            ...this.defaultHeaders,
+            ...options.headers,
+        };
+        // Don't set Content-Type for FormData — the browser/runtime sets it with boundary
+        if (options.formData) {
+            delete headers["Content-Type"];
+        }
+        const init = {
+            method,
+            headers,
+            body: options.formData ?? (options.body !== undefined ? JSON.stringify(options.body) : undefined),
+            signal: AbortSignal.timeout(this.timeout),
+        };
+        return fetch(url, init);
+    }
+}
+//# sourceMappingURL=http.js.map

package/dist/http.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"http.js","sourceRoot":"","sources":["../src/http.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,21 @@
+import { CloudProxy } from "./client.js";
+import type { ClientConfig } from "./types.js";
+/**
+ * Create a fully configured CloudProxy client.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@et2bo/cloud-proxy";
+ *
+ * const proxy = createClient({
+ *   baseUrl: process.env.PROXY_URL!,
+ *   token: process.env.PROXY_TOKEN!,
+ * });
+ * ```
+ */
+export declare function createClient(config: ClientConfig): CloudProxy;
+export { CloudProxy } from "./client.js";
+export { ProxyError } from "./errors.js";
+export { FieldOp } from "./types.js";
+export type { ClientConfig, StreamOptions, ChatParams, ChatResponse, CreateUserParams, UpdateUserParams, UserRecord, UserListResult, DecodedToken, WhereOp, ListOptions, QueryParams, ListResult, BatchOperation, AggregateParams, FieldOpValue, UploadOptions, UploadResult, UploadUrlParams, SignedUploadUrl, SignedDownloadUrl, ListFilesOptions, FileListResult, CreateBucketParams, BucketInfo, EmbedOptions, EmbedBatchItem, StoreResult, EmbedResult, BatchEmbedResult, SearchOptions, SearchResult, SemanticSearchResult, UpdateVectorParams, CollectionSetup, SetupBucketParams, ProjectSetup, DatabaseStatus, CollectionsStatus, BucketSetupResult, AuthStatus, ProjectStatus, ProvisioningStatus, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C;;;;;;;;;;;;GAYG;AACH,wBAAgB,YAAY,CAAC,MAAM,EAAE,YAAY,GAAG,UAAU,CAE7D;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAGrC,YAAY,EACV,YAAY,EACZ,aAAa,EACb,UAAU,EACV,YAAY,EACZ,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,YAAY,EACZ,OAAO,EACP,WAAW,EACX,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EACf,YAAY,EACZ,aAAa,EACb,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,UAAU,EACV,YAAY,EACZ,cAAc,EACd,WAAW,EACX,WAAW,EACX,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,EAClB,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,kBAAkB,GACnB,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,24 @@
+import { CloudProxy } from "./client.js";
+/**
+ * Create a fully configured CloudProxy client.
+ *
+ * @example
+ * ```ts
+ * import { createClient } from "@et2bo/cloud-proxy";
+ *
+ * const proxy = createClient({
+ *   baseUrl: process.env.PROXY_URL!,
+ *   token: process.env.PROXY_TOKEN!,
+ * });
+ * ```
+ */
+export function createClient(config) {
+    return new CloudProxy(config);
+}
+// Re-export the client class for advanced use
+export { CloudProxy } from "./client.js";
+// Re-export error class
+export { ProxyError } from "./errors.js";
+// Re-export FieldOp helpers
+export { FieldOp } from "./types.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAGzC;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,YAAY,CAAC,MAAoB;IAC/C,OAAO,IAAI,UAAU,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,8CAA8C;AAC9C,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,wBAAwB;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,4BAA4B;AAC5B,OAAO,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC"}

package/dist/modules/ai.d.ts

@@ -0,0 +1,33 @@
+import type { HttpClient } from "../http.js";
+import type { ChatParams, ChatResponse, StreamOptions } from "../types.js";
+/**
+ * AI provider proxy. Forwards requests to upstream providers
+ * (OpenAI, Anthropic, Gemini, OpenRouter) through the proxy,
+ * which injects its own API keys.
+ */
+export declare class AiModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Raw passthrough to OpenAI. Path is appended to `/ai/openai`. */
+    openai<T = unknown>(path: string, body: unknown, options?: StreamOptions): Promise<T>;
+    /** Raw passthrough to Anthropic. Path is appended to `/ai/anthropic`. */
+    anthropic<T = unknown>(path: string, body: unknown, options?: StreamOptions): Promise<T>;
+    /** Raw passthrough to Gemini. Path is appended to `/ai/gemini`. */
+    gemini<T = unknown>(path: string, body: unknown, options?: StreamOptions): Promise<T>;
+    /** Raw passthrough to OpenRouter. Path is appended to `/ai/openrouter`. */
+    openrouter<T = unknown>(path: string, body: unknown, options?: StreamOptions): Promise<T>;
+    /**
+     * Convenience chat completion that normalizes the response across providers.
+     * The provider is auto-selected from `params.provider`.
+     */
+    chat(params: ChatParams): Promise<ChatResponse>;
+    /**
+     * Streaming chat completion. Sets `stream: true` and returns
+     * a `ReadableStream<Uint8Array>` suitable for `for await...of`.
+     */
+    chatStream(params: ChatParams): Promise<ReadableStream<Uint8Array>>;
+    private providerRequest;
+    private buildChatRequest;
+    private normalizeChatResponse;
+}
+//# sourceMappingURL=ai.d.ts.map

package/dist/modules/ai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.d.ts","sourceRoot":"","sources":["../../src/modules/ai.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAI3E;;;;GAIG;AACH,qBAAa,QAAQ;IACP,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,mEAAmE;IAC7D,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3F,yEAAyE;IACnE,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAI9F,mEAAmE;IAC7D,MAAM,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAI3F,2EAA2E;IACrE,UAAU,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,CAAC,CAAC;IAI/F;;;OAGG;IACG,IAAI,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,YAAY,CAAC;IAOrD;;;OAGG;IACG,UAAU,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,cAAc,CAAC,UAAU,CAAC,CAAC;YAS3D,eAAe;IAU7B,OAAO,CAAC,gBAAgB;IA+CxB,OAAO,CAAC,qBAAqB;CA+C9B"}