@calculator-5329/cloud-proxy 0.1.0

package/dist/modules/ai.js

@@ -0,0 +1,140 @@
+/**
+ * AI provider proxy. Forwards requests to upstream providers
+ * (OpenAI, Anthropic, Gemini, OpenRouter) through the proxy,
+ * which injects its own API keys.
+ */
+export class AiModule {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Raw passthrough to OpenAI. Path is appended to `/ai/openai`. */
+    async openai(path, body, options) {
+        return this.providerRequest("openai", path, body, options);
+    }
+    /** Raw passthrough to Anthropic. Path is appended to `/ai/anthropic`. */
+    async anthropic(path, body, options) {
+        return this.providerRequest("anthropic", path, body, options);
+    }
+    /** Raw passthrough to Gemini. Path is appended to `/ai/gemini`. */
+    async gemini(path, body, options) {
+        return this.providerRequest("gemini", path, body, options);
+    }
+    /** Raw passthrough to OpenRouter. Path is appended to `/ai/openrouter`. */
+    async openrouter(path, body, options) {
+        return this.providerRequest("openrouter", path, body, options);
+    }
+    /**
+     * Convenience chat completion that normalizes the response across providers.
+     * The provider is auto-selected from `params.provider`.
+     */
+    async chat(params) {
+        const { provider, ...rest } = params;
+        const { path, body } = this.buildChatRequest(provider, rest);
+        const raw = await this.http.request("POST", `/ai/${provider}${path}`, { body });
+        return this.normalizeChatResponse(provider, raw);
+    }
+    /**
+     * Streaming chat completion. Sets `stream: true` and returns
+     * a `ReadableStream<Uint8Array>` suitable for `for await...of`.
+     */
+    async chatStream(params) {
+        const { provider, ...rest } = params;
+        const { path, body } = this.buildChatRequest(provider, rest);
+        body.stream = true;
+        return this.http.stream("POST", `/ai/${provider}${path}`, { body });
+    }
+    // ── Internal ──
+    async providerRequest(provider, path, body, options) {
+        const payload = options?.stream ? { ...body, stream: true } : body;
+        if (options?.stream) {
+            return this.http.stream("POST", `/ai/${provider}${path}`, { body: payload });
+        }
+        return this.http.request("POST", `/ai/${provider}${path}`, { body: payload });
+    }
+    buildChatRequest(provider, params) {
+        const { model, messages, temperature, maxTokens, ...extra } = params;
+        switch (provider) {
+            case "anthropic":
+                return {
+                    path: "/v1/messages",
+                    body: {
+                        model,
+                        messages,
+                        max_tokens: maxTokens ?? 1024,
+                        ...(temperature !== undefined && { temperature }),
+                        ...extra,
+                    },
+                };
+            case "gemini":
+                return {
+                    path: "/v1/chat/completions",
+                    body: {
+                        model,
+                        messages,
+                        ...(maxTokens !== undefined && { max_tokens: maxTokens }),
+                        ...(temperature !== undefined && { temperature }),
+                        ...extra,
+                    },
+                };
+            case "openai":
+            case "openrouter":
+            default:
+                return {
+                    path: "/v1/chat/completions",
+                    body: {
+                        model,
+                        messages,
+                        ...(maxTokens !== undefined && { max_tokens: maxTokens }),
+                        ...(temperature !== undefined && { temperature }),
+                        ...extra,
+                    },
+                };
+        }
+    }
+    normalizeChatResponse(provider, raw) {
+        switch (provider) {
+            case "anthropic": {
+                const content = Array.isArray(raw.content)
+                    ? raw.content.map((b) => b.text ?? "").join("")
+                    : String(raw.content ?? "");
+                const usage = raw.usage;
+                return {
+                    id: raw.id,
+                    content,
+                    model: raw.model ?? "",
+                    usage: usage
+                        ? {
+                            promptTokens: usage.input_tokens ?? 0,
+                            completionTokens: usage.output_tokens ?? 0,
+                            totalTokens: (usage.input_tokens ?? 0) + (usage.output_tokens ?? 0),
+                        }
+                        : undefined,
+                    raw,
+                };
+            }
+            case "openai":
+            case "gemini":
+            case "openrouter":
+            default: {
+                const choices = raw.choices;
+                const content = choices?.[0]?.message?.content ?? "";
+                const usage = raw.usage;
+                return {
+                    id: raw.id,
+                    content,
+                    model: raw.model ?? "",
+                    usage: usage
+                        ? {
+                            promptTokens: usage.prompt_tokens ?? 0,
+                            completionTokens: usage.completion_tokens ?? 0,
+                            totalTokens: usage.total_tokens ?? 0,
+                        }
+                        : undefined,
+                    raw,
+                };
+            }
+        }
+    }
+}
+//# sourceMappingURL=ai.js.map

package/dist/modules/ai.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai.js","sourceRoot":"","sources":["../../src/modules/ai.ts"],"names":[],"mappings":"AAKA;;;;GAIG;AACH,MAAM,OAAO,QAAQ;IACU;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,mEAAmE;IACnE,KAAK,CAAC,MAAM,CAAc,IAAY,EAAE,IAAa,EAAE,OAAuB;QAC5E,OAAO,IAAI,CAAC,eAAe,CAAI,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,yEAAyE;IACzE,KAAK,CAAC,SAAS,CAAc,IAAY,EAAE,IAAa,EAAE,OAAuB;QAC/E,OAAO,IAAI,CAAC,eAAe,CAAI,WAAW,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,MAAM,CAAc,IAAY,EAAE,IAAa,EAAE,OAAuB;QAC5E,OAAO,IAAI,CAAC,eAAe,CAAI,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IAChE,CAAC;IAED,2EAA2E;IAC3E,KAAK,CAAC,UAAU,CAAc,IAAY,EAAE,IAAa,EAAE,OAAuB;QAChF,OAAO,IAAI,CAAC,eAAe,CAAI,YAAY,EAAE,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC,CAAC;IACpE,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,IAAI,CAAC,MAAkB;QAC3B,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,CAA0B,MAAM,EAAE,OAAO,QAAQ,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QACzG,OAAO,IAAI,CAAC,qBAAqB,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,UAAU,CAAC,MAAkB;QACjC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,EAAE,GAAG,MAAM,CAAC;QACrC,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,gBAAgB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;QAC5D,IAAgC,CAAC,MAAM,GAAG,IAAI,CAAC;QAChD,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,QAAQ,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,CAAC;IAED,iBAAiB;IAET,KAAK,CAAC,eAAe,CAAI,QAAkB,EAAE,IAAY,EAAE,IAAa,EAAE,OAAuB;QACvG,MAAM,OAAO,GAAG,OAAO,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAI,IAAgC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAEhG,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YACpB,OAAO,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,QAAQ,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAiB,CAAC;QAC/F,CAAC;QAED,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAI,MAAM,EAAE,OAAO,QAAQ,GAAG,IAAI,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;IACnF,CAAC;IAEO,gBAAgB,CACtB,QAAkB,EAClB,MAAoC;QAEpC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,WAAW,EAAE,SAAS,EAAE,GAAG,KAAK,EAAE,GAAG,MAAM,CAAC;QAErE,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW;gBACd,OAAO;oBACL,IAAI,EAAE,cAAc;oBACpB,IAAI,EAAE;wBACJ,KAAK;wBACL,QAAQ;wBACR,UAAU,EAAE,SAAS,IAAI,IAAI;wBAC7B,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;wBACjD,GAAG,KAAK;qBACT;iBACF,CAAC;YAEJ,KAAK,QAAQ;gBACX,OAAO;oBACL,IAAI,EAAE,sBAAsB;oBAC5B,IAAI,EAAE;wBACJ,KAAK;wBACL,QAAQ;wBACR,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;wBACzD,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;wBACjD,GAAG,KAAK;qBACT;iBACF,CAAC;YAEJ,KAAK,QAAQ,CAAC;YACd,KAAK,YAAY,CAAC;YAClB;gBACE,OAAO;oBACL,IAAI,EAAE,sBAAsB;oBAC5B,IAAI,EAAE;wBACJ,KAAK;wBACL,QAAQ;wBACR,GAAG,CAAC,SAAS,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;wBACzD,GAAG,CAAC,WAAW,KAAK,SAAS,IAAI,EAAE,WAAW,EAAE,CAAC;wBACjD,GAAG,KAAK;qBACT;iBACF,CAAC;QACN,CAAC;IACH,CAAC;IAEO,qBAAqB,CAAC,QAAkB,EAAE,GAA4B;QAC5E,QAAQ,QAAQ,EAAE,CAAC;YACjB,KAAK,WAAW,CAAC,CAAC,CAAC;gBACjB,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC;oBACxC,CAAC,CAAE,GAAG,CAAC,OAAoC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;oBAC7E,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;gBAC9B,MAAM,KAAK,GAAG,GAAG,CAAC,KAAsE,CAAC;gBACzF,OAAO;oBACL,EAAE,EAAE,GAAG,CAAC,EAAwB;oBAChC,OAAO;oBACP,KAAK,EAAG,GAAG,CAAC,KAAgB,IAAI,EAAE;oBAClC,KAAK,EAAE,KAAK;wBACV,CAAC,CAAC;4BACE,YAAY,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;4BACrC,gBAAgB,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;4BAC1C,WAAW,EAAE,CAAC,KAAK,CAAC,YAAY,IAAI,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,aAAa,IAAI,CAAC,CAAC;yBACpE;wBACH,CAAC,CAAC,SAAS;oBACb,GAAG;iBACJ,CAAC;YACJ,CAAC;YAED,KAAK,QAAQ,CAAC;YACd,KAAK,QAAQ,CAAC;YACd,KAAK,YAAY,CAAC;YAClB,OAAO,CAAC,CAAC,CAAC;gBACR,MAAM,OAAO,GAAG,GAAG,CAAC,OAAgE,CAAC;gBACrF,MAAM,OAAO,GAAG,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,IAAI,EAAE,CAAC;gBACrD,MAAM,KAAK,GAAG,GAAG,CAAC,KAEL,CAAC;gBACd,OAAO;oBACL,EAAE,EAAE,GAAG,CAAC,EAAwB;oBAChC,OAAO;oBACP,KAAK,EAAG,GAAG,CAAC,KAAgB,IAAI,EAAE;oBAClC,KAAK,EAAE,KAAK;wBACV,CAAC,CAAC;4BACE,YAAY,EAAE,KAAK,CAAC,aAAa,IAAI,CAAC;4BACtC,gBAAgB,EAAE,KAAK,CAAC,iBAAiB,IAAI,CAAC;4BAC9C,WAAW,EAAE,KAAK,CAAC,YAAY,IAAI,CAAC;yBACrC;wBACH,CAAC,CAAC,SAAS;oBACb,GAAG;iBACJ,CAAC;YACJ,CAAC;QACH,CAAC;IACH,CAAC;CACF"}

package/dist/modules/auth.d.ts

@@ -0,0 +1,49 @@
+import type { HttpClient } from "../http.js";
+import type { CreateUserParams, UpdateUserParams, UserRecord, UserListResult, DecodedToken } from "../types.js";
+/**
+ * Firebase Auth operations — user management, token verification,
+ * email action links, and session cookies.
+ */
+export declare class AuthModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Create a new Firebase user. */
+    createUser(params: CreateUserParams): Promise<UserRecord>;
+    /** Get a user by UID. */
+    getUser(uid: string): Promise<UserRecord>;
+    /** Look up a user by email address. */
+    getUserByEmail(email: string): Promise<UserRecord>;
+    /** List users with optional pagination. */
+    listUsers(options?: {
+        limit?: number;
+        pageToken?: string;
+    }): Promise<UserListResult>;
+    /** Update user properties. */
+    updateUser(uid: string, params: UpdateUserParams): Promise<UserRecord>;
+    /** Delete a user by UID. */
+    deleteUser(uid: string): Promise<void>;
+    /** Set custom claims on a user. */
+    setClaims(uid: string, claims: Record<string, unknown>): Promise<void>;
+    /** Verify a Firebase ID token. */
+    verifyToken(idToken: string): Promise<DecodedToken>;
+    /** Generate a password-reset email link. */
+    generatePasswordResetLink(email: string, redirectUrl?: string): Promise<{
+        link: string;
+    }>;
+    /** Generate an email-verification link. */
+    generateEmailVerificationLink(email: string, redirectUrl?: string): Promise<{
+        link: string;
+    }>;
+    /** Generate a sign-in-with-email link. */
+    generateSignInLink(email: string, redirectUrl: string): Promise<{
+        link: string;
+    }>;
+    /** Create a session cookie from an ID token. */
+    createSessionCookie(idToken: string, expiresInMs?: number): Promise<{
+        cookie: string;
+        expiresIn: number;
+    }>;
+    /** Verify a session cookie, optionally checking for revocation. */
+    verifySessionCookie(cookie: string, checkRevoked?: boolean): Promise<DecodedToken>;
+}
+//# sourceMappingURL=auth.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/modules/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,gBAAgB,EAChB,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,YAAY,EACb,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,UAAU;IACT,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,kCAAkC;IAC5B,UAAU,CAAC,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/D,yBAAyB;IACnB,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAI/C,uCAAuC;IACjC,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;IAMxD,2CAA2C;IACrC,SAAS,CAAC,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,cAAc,CAAC;IAO1F,8BAA8B;IACxB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,gBAAgB,GAAG,OAAO,CAAC,UAAU,CAAC;IAI5E,4BAA4B;IACtB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5C,mCAAmC;IAC7B,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAI5E,kCAAkC;IAC5B,WAAW,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAMzD,4CAA4C;IACtC,yBAAyB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAM/F,2CAA2C;IACrC,6BAA6B,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAMnG,0CAA0C;IACpC,kBAAkB,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAMvF,gDAAgD;IAC1C,mBAAmB,CACvB,OAAO,EAAE,MAAM,EACf,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;IAQjD,mEAAmE;IAC7D,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,YAAY,CAAC;CAKzF"}

package/dist/modules/auth.js

@@ -0,0 +1,80 @@
+/**
+ * Firebase Auth operations — user management, token verification,
+ * email action links, and session cookies.
+ */
+export class AuthModule {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Create a new Firebase user. */
+    async createUser(params) {
+        return this.http.request("POST", "/auth/users", { body: params });
+    }
+    /** Get a user by UID. */
+    async getUser(uid) {
+        return this.http.request("GET", `/auth/users/${uid}`);
+    }
+    /** Look up a user by email address. */
+    async getUserByEmail(email) {
+        return this.http.request("GET", "/auth/users", {
+            query: { email },
+        });
+    }
+    /** List users with optional pagination. */
+    async listUsers(options) {
+        const query = {};
+        if (options?.limit !== undefined)
+            query.limit = String(options.limit);
+        if (options?.pageToken)
+            query.pageToken = options.pageToken;
+        return this.http.request("GET", "/auth/users/list", { query });
+    }
+    /** Update user properties. */
+    async updateUser(uid, params) {
+        return this.http.request("PUT", `/auth/users/${uid}`, { body: params });
+    }
+    /** Delete a user by UID. */
+    async deleteUser(uid) {
+        await this.http.request("DELETE", `/auth/users/${uid}`);
+    }
+    /** Set custom claims on a user. */
+    async setClaims(uid, claims) {
+        await this.http.request("POST", `/auth/users/${uid}/claims`, { body: claims });
+    }
+    /** Verify a Firebase ID token. */
+    async verifyToken(idToken) {
+        return this.http.request("POST", "/auth/verify-token", {
+            body: { idToken },
+        });
+    }
+    /** Generate a password-reset email link. */
+    async generatePasswordResetLink(email, redirectUrl) {
+        return this.http.request("POST", "/auth/email-link/password-reset", {
+            body: { email, ...(redirectUrl && { redirectUrl }) },
+        });
+    }
+    /** Generate an email-verification link. */
+    async generateEmailVerificationLink(email, redirectUrl) {
+        return this.http.request("POST", "/auth/email-link/verify-email", {
+            body: { email, ...(redirectUrl && { redirectUrl }) },
+        });
+    }
+    /** Generate a sign-in-with-email link. */
+    async generateSignInLink(email, redirectUrl) {
+        return this.http.request("POST", "/auth/email-link/sign-in", {
+            body: { email, redirectUrl },
+        });
+    }
+    /** Create a session cookie from an ID token. */
+    async createSessionCookie(idToken, expiresInMs) {
+        return this.http.request("POST", "/auth/session-cookie/create", { body: { idToken, ...(expiresInMs !== undefined && { expiresIn: expiresInMs }) } });
+    }
+    /** Verify a session cookie, optionally checking for revocation. */
+    async verifySessionCookie(cookie, checkRevoked) {
+        return this.http.request("POST", "/auth/session-cookie/verify", {
+            body: { cookie, ...(checkRevoked !== undefined && { checkRevoked }) },
+        });
+    }
+}
+//# sourceMappingURL=auth.js.map

package/dist/modules/auth.js.map

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

package/dist/modules/firestore.d.ts

@@ -0,0 +1,56 @@
+import type { HttpClient } from "../http.js";
+import type { ListOptions, QueryParams, ListResult, BatchOperation, AggregateParams } from "../types.js";
+/**
+ * Firestore CRUD, queries, batch writes, aggregations, and subcollection support.
+ *
+ * Path conventions:
+ *  - Collection: `"posts"` or `"users/uid/posts"`
+ *  - Document:   `"posts/docId"` or `"users/uid/posts/docId"`
+ */
+export declare class FirestoreModule {
+    private readonly http;
+    private readonly prefix;
+    constructor(http: HttpClient, prefix?: string);
+    /**
+     * Returns a new FirestoreModule scoped to a parent document path.
+     * Useful for chaining subcollection operations.
+     *
+     * @example
+     * ```ts
+     * const userPosts = proxy.firestore.sub("users/uid123");
+     * await userPosts.list("posts");
+     * ```
+     */
+    sub(parentPath: string): FirestoreModule;
+    /** Create a document. If `docId` is provided, uses that ID; otherwise auto-generates. */
+    create<T extends Record<string, unknown>>(collection: string, data: T, docId?: string): Promise<T & {
+        id: string;
+    }>;
+    /** Get a single document by path (e.g. `"posts/abc123"`). */
+    get<T = Record<string, unknown>>(path: string): Promise<T & {
+        id: string;
+    }>;
+    /** Full update (PUT) of a document. */
+    update<T extends Record<string, unknown>>(path: string, data: T): Promise<T & {
+        id: string;
+    }>;
+    /** Partial update (PATCH) of a document. Supports FieldOp sentinels. */
+    patch<T extends Record<string, unknown>>(path: string, data: T): Promise<T & {
+        id: string;
+    }>;
+    /** Delete a document by path. */
+    delete(path: string): Promise<void>;
+    /** List documents in a collection with optional ordering and limit. */
+    list<T = Record<string, unknown>>(collection: string, options?: ListOptions): Promise<ListResult<T>>;
+    /** Run a structured query with filters, ordering, pagination. */
+    query<T = Record<string, unknown>>(collection: string, params: QueryParams): Promise<ListResult<T>>;
+    /** Execute a batch of create/update/delete operations atomically. */
+    batch(operations: BatchOperation[]): Promise<{
+        count: number;
+    }>;
+    /** Run aggregate queries (count, sum, average) without downloading documents. */
+    aggregate(collection: string, params: AggregateParams): Promise<Record<string, number | null>>;
+    private basePath;
+    private path;
+}
+//# sourceMappingURL=firestore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"firestore.d.ts","sourceRoot":"","sources":["../../src/modules/firestore.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,WAAW,EACX,WAAW,EACX,UAAU,EACV,cAAc,EACd,eAAe,EAChB,MAAM,aAAa,CAAC;AAErB;;;;;;GAMG;AACH,qBAAa,eAAe;IAIxB,OAAO,CAAC,QAAQ,CAAC,IAAI;IAHvB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;gBAGb,IAAI,EAAE,UAAU,EACjC,MAAM,SAAK;IAKb;;;;;;;;;OASG;IACH,GAAG,CAAC,UAAU,EAAE,MAAM,GAAG,eAAe;IAKxC,yFAAyF;IACnF,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC5C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,CAAC,EACP,KAAK,CAAC,EAAE,MAAM,GACb,OAAO,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAK9B,6DAA6D;IACvD,GAAG,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAIjF,uCAAuC;IACjC,MAAM,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAInG,wEAAwE;IAClE,KAAK,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,GAAG;QAAE,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IAIlG,iCAAiC;IAC3B,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIzC,uEAAuE;IACjE,IAAI,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACpC,UAAU,EAAE,MAAM,EAClB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAQzB,iEAAiE;IAC3D,KAAK,CAAC,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACrC,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,WAAW,GAClB,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;IAMzB,qEAAqE;IAC/D,KAAK,CAAC,UAAU,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAMrE,iFAAiF;IAC3E,SAAS,CACb,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,eAAe,GACtB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAUzC,OAAO,CAAC,QAAQ;IAIhB,OAAO,CAAC,IAAI;CAOb"}

package/dist/modules/firestore.js

@@ -0,0 +1,89 @@
+/**
+ * Firestore CRUD, queries, batch writes, aggregations, and subcollection support.
+ *
+ * Path conventions:
+ *  - Collection: `"posts"` or `"users/uid/posts"`
+ *  - Document:   `"posts/docId"` or `"users/uid/posts/docId"`
+ */
+export class FirestoreModule {
+    http;
+    prefix;
+    constructor(http, prefix = "") {
+        this.http = http;
+        this.prefix = prefix ? prefix.replace(/\/+$/, "") : "";
+    }
+    /**
+     * Returns a new FirestoreModule scoped to a parent document path.
+     * Useful for chaining subcollection operations.
+     *
+     * @example
+     * ```ts
+     * const userPosts = proxy.firestore.sub("users/uid123");
+     * await userPosts.list("posts");
+     * ```
+     */
+    sub(parentPath) {
+        const combined = this.prefix ? `${this.prefix}/${parentPath}` : parentPath;
+        return new FirestoreModule(this.http, combined);
+    }
+    /** Create a document. If `docId` is provided, uses that ID; otherwise auto-generates. */
+    async create(collection, data, docId) {
+        const body = docId ? { data, docId } : { data };
+        return this.http.request("POST", this.path(collection), { body });
+    }
+    /** Get a single document by path (e.g. `"posts/abc123"`). */
+    async get(path) {
+        return this.http.request("GET", this.path(path));
+    }
+    /** Full update (PUT) of a document. */
+    async update(path, data) {
+        return this.http.request("PUT", this.path(path), { body: { data } });
+    }
+    /** Partial update (PATCH) of a document. Supports FieldOp sentinels. */
+    async patch(path, data) {
+        return this.http.request("PATCH", this.path(path), { body: { data } });
+    }
+    /** Delete a document by path. */
+    async delete(path) {
+        await this.http.request("DELETE", this.path(path));
+    }
+    /** List documents in a collection with optional ordering and limit. */
+    async list(collection, options) {
+        const query = {};
+        if (options?.limit !== undefined)
+            query.limit = String(options.limit);
+        if (options?.orderBy)
+            query.orderBy = options.orderBy;
+        if (options?.direction)
+            query.direction = options.direction;
+        return this.http.request("GET", this.path(collection), { query });
+    }
+    /** Run a structured query with filters, ordering, pagination. */
+    async query(collection, params) {
+        return this.http.request("POST", `${this.path(collection)}/query`, {
+            body: params,
+        });
+    }
+    /** Execute a batch of create/update/delete operations atomically. */
+    async batch(operations) {
+        return this.http.request("POST", `${this.basePath()}/batch`, {
+            body: { operations },
+        });
+    }
+    /** Run aggregate queries (count, sum, average) without downloading documents. */
+    async aggregate(collection, params) {
+        return this.http.request("POST", `${this.path(collection)}/aggregate`, { body: params });
+    }
+    // ── Internal ──
+    basePath() {
+        return this.prefix ? `/firestore/${this.prefix}` : "/firestore";
+    }
+    path(relativePath) {
+        const base = "/firestore";
+        if (this.prefix) {
+            return `${base}/${this.prefix}/${relativePath}`;
+        }
+        return `${base}/${relativePath}`;
+    }
+}
+//# sourceMappingURL=firestore.js.map

package/dist/modules/firestore.js.map

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

package/dist/modules/setup.d.ts

@@ -0,0 +1,26 @@
+import type { HttpClient } from "../http.js";
+import type { CollectionSetup, SetupBucketParams, ProjectSetup, DatabaseStatus, CollectionsStatus, BucketSetupResult, AuthStatus, ProjectStatus, ProvisioningStatus } from "../types.js";
+/**
+ * Provisioning and project bootstrap — verify/create databases,
+ * collections, buckets, and auth configuration.
+ */
+export declare class SetupModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Verify that a Firestore database exists and is reachable. */
+    verifyDatabase(options?: {
+        databaseId?: string;
+        locationId?: string;
+    }): Promise<DatabaseStatus>;
+    /** Create or verify collections (with optional vector indexes). */
+    setupCollections(collections: CollectionSetup[]): Promise<CollectionsStatus>;
+    /** Create a GCS bucket with optional CORS and public access. */
+    createBucket(params: SetupBucketParams): Promise<BucketSetupResult>;
+    /** Verify Firebase Auth is enabled and configured. */
+    verifyAuth(): Promise<AuthStatus>;
+    /** Bootstrap an entire project backend in one call. */
+    bootstrapProject(params: ProjectSetup): Promise<ProjectStatus>;
+    /** Get the current provisioning status of all services. */
+    getStatus(): Promise<ProvisioningStatus>;
+}
+//# sourceMappingURL=setup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"setup.d.ts","sourceRoot":"","sources":["../../src/modules/setup.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,eAAe,EACf,iBAAiB,EACjB,YAAY,EACZ,cAAc,EACd,iBAAiB,EACjB,iBAAiB,EACjB,UAAU,EACV,aAAa,EACb,kBAAkB,EACnB,MAAM,aAAa,CAAC;AAErB;;;GAGG;AACH,qBAAa,WAAW;IACV,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,gEAAgE;IAC1D,cAAc,CAAC,OAAO,CAAC,EAAE;QAC7B,UAAU,CAAC,EAAE,MAAM,CAAC;QACpB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB,GAAG,OAAO,CAAC,cAAc,CAAC;IAM3B,mEAAmE;IAC7D,gBAAgB,CAAC,WAAW,EAAE,eAAe,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMlF,gEAAgE;IAC1D,YAAY,CAAC,MAAM,EAAE,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAMzE,sDAAsD;IAChD,UAAU,IAAI,OAAO,CAAC,UAAU,CAAC;IAIvC,uDAAuD;IACjD,gBAAgB,CAAC,MAAM,EAAE,YAAY,GAAG,OAAO,CAAC,aAAa,CAAC;IAMpE,2DAA2D;IACrD,SAAS,IAAI,OAAO,CAAC,kBAAkB,CAAC;CAG/C"}

package/dist/modules/setup.js

@@ -0,0 +1,43 @@
+/**
+ * Provisioning and project bootstrap — verify/create databases,
+ * collections, buckets, and auth configuration.
+ */
+export class SetupModule {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Verify that a Firestore database exists and is reachable. */
+    async verifyDatabase(options) {
+        return this.http.request("POST", "/setup/firestore/database", {
+            body: options ?? {},
+        });
+    }
+    /** Create or verify collections (with optional vector indexes). */
+    async setupCollections(collections) {
+        return this.http.request("POST", "/setup/firestore/collections", {
+            body: { collections },
+        });
+    }
+    /** Create a GCS bucket with optional CORS and public access. */
+    async createBucket(params) {
+        return this.http.request("POST", "/setup/storage/bucket", {
+            body: params,
+        });
+    }
+    /** Verify Firebase Auth is enabled and configured. */
+    async verifyAuth() {
+        return this.http.request("POST", "/setup/auth/config");
+    }
+    /** Bootstrap an entire project backend in one call. */
+    async bootstrapProject(params) {
+        return this.http.request("POST", "/setup/project", {
+            body: params,
+        });
+    }
+    /** Get the current provisioning status of all services. */
+    async getStatus() {
+        return this.http.request("GET", "/setup/status");
+    }
+}
+//# sourceMappingURL=setup.js.map

package/dist/modules/setup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup.js","sourceRoot":"","sources":["../../src/modules/setup.ts"],"names":[],"mappings":"AAaA;;;GAGG;AACH,MAAM,OAAO,WAAW;IACO;IAA7B,YAA6B,IAAgB;QAAhB,SAAI,GAAJ,IAAI,CAAY;IAAG,CAAC;IAEjD,gEAAgE;IAChE,KAAK,CAAC,cAAc,CAAC,OAGpB;QACC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAiB,MAAM,EAAE,2BAA2B,EAAE;YAC5E,IAAI,EAAE,OAAO,IAAI,EAAE;SACpB,CAAC,CAAC;IACL,CAAC;IAED,mEAAmE;IACnE,KAAK,CAAC,gBAAgB,CAAC,WAA8B;QACnD,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoB,MAAM,EAAE,8BAA8B,EAAE;YAClF,IAAI,EAAE,EAAE,WAAW,EAAE;SACtB,CAAC,CAAC;IACL,CAAC;IAED,gEAAgE;IAChE,KAAK,CAAC,YAAY,CAAC,MAAyB;QAC1C,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAoB,MAAM,EAAE,uBAAuB,EAAE;YAC3E,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,sDAAsD;IACtD,KAAK,CAAC,UAAU;QACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAa,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACrE,CAAC;IAED,uDAAuD;IACvD,KAAK,CAAC,gBAAgB,CAAC,MAAoB;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAgB,MAAM,EAAE,gBAAgB,EAAE;YAChE,IAAI,EAAE,MAAM;SACb,CAAC,CAAC;IACL,CAAC;IAED,2DAA2D;IAC3D,KAAK,CAAC,SAAS;QACb,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAqB,KAAK,EAAE,eAAe,CAAC,CAAC;IACvE,CAAC;CACF"}

package/dist/modules/storage.d.ts

@@ -0,0 +1,28 @@
+import type { HttpClient } from "../http.js";
+import type { UploadOptions, UploadResult, UploadUrlParams, SignedUploadUrl, SignedDownloadUrl, ListFilesOptions, FileListResult, CreateBucketParams, BucketInfo } from "../types.js";
+/**
+ * Google Cloud Storage operations — upload, download, signed URLs, and bucket management.
+ */
+export declare class StorageModule {
+    private readonly http;
+    constructor(http: HttpClient);
+    /** Upload a file directly through the proxy (best for files < 10 MB). */
+    upload(bucket: string, file: File | Blob, options?: UploadOptions): Promise<UploadResult>;
+    /** Get a signed upload URL for direct-to-GCS uploads (large files). */
+    getUploadUrl(bucket: string, params: UploadUrlParams): Promise<SignedUploadUrl>;
+    /** Get a signed download URL for a file. */
+    getDownloadUrl(bucket: string, filePath: string, expiresInMinutes?: number): Promise<SignedDownloadUrl>;
+    /** Stream-download a file through the proxy. Returns the raw Response. */
+    download(bucket: string, filePath: string): Promise<Response>;
+    /** Delete a file from a bucket. */
+    deleteFile(bucket: string, filePath: string): Promise<void>;
+    /** List files in a bucket with optional prefix filtering and pagination. */
+    listFiles(bucket: string, options?: ListFilesOptions): Promise<FileListResult>;
+    /** Create a new GCS bucket. */
+    createBucket(params: CreateBucketParams): Promise<BucketInfo>;
+    /** List all accessible buckets. */
+    listBuckets(): Promise<{
+        buckets: BucketInfo[];
+    }>;
+}
+//# sourceMappingURL=storage.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../../src/modules/storage.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,KAAK,EACV,aAAa,EACb,YAAY,EACZ,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,gBAAgB,EAChB,cAAc,EACd,kBAAkB,EAClB,UAAU,EACX,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,IAAI;gBAAJ,IAAI,EAAE,UAAU;IAE7C,yEAAyE;IACnE,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,YAAY,CAAC;IAQ/F,uEAAuE;IACjE,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,eAAe,GAAG,OAAO,CAAC,eAAe,CAAC;IAMrF,4CAA4C;IACtC,cAAc,CAClB,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,iBAAiB,CAAC;IAU7B,0EAA0E;IACpE,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAInE,mCAAmC;IAC7B,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE,4EAA4E;IACtE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,cAAc,CAAC;IASpF,+BAA+B;IACzB,YAAY,CAAC,MAAM,EAAE,kBAAkB,GAAG,OAAO,CAAC,UAAU,CAAC;IAInE,mCAAmC;IAC7B,WAAW,IAAI,OAAO,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;CAGxD"}

package/dist/modules/storage.js

@@ -0,0 +1,62 @@
+/**
+ * Google Cloud Storage operations — upload, download, signed URLs, and bucket management.
+ */
+export class StorageModule {
+    http;
+    constructor(http) {
+        this.http = http;
+    }
+    /** Upload a file directly through the proxy (best for files < 10 MB). */
+    async upload(bucket, file, options) {
+        const formData = new FormData();
+        formData.append("file", file);
+        if (options?.path)
+            formData.append("path", options.path);
+        if (options?.public)
+            formData.append("public", "true");
+        return this.http.upload(`/storage/${bucket}/upload`, formData);
+    }
+    /** Get a signed upload URL for direct-to-GCS uploads (large files). */
+    async getUploadUrl(bucket, params) {
+        return this.http.request("POST", `/storage/${bucket}/upload-url`, {
+            body: params,
+        });
+    }
+    /** Get a signed download URL for a file. */
+    async getDownloadUrl(bucket, filePath, expiresInMinutes) {
+        const query = {};
+        if (expiresInMinutes !== undefined)
+            query.expiresInMinutes = String(expiresInMinutes);
+        return this.http.request("GET", `/storage/${bucket}/download-url/${filePath}`, { query });
+    }
+    /** Stream-download a file through the proxy. Returns the raw Response. */
+    async download(bucket, filePath) {
+        return this.http.raw("GET", `/storage/${bucket}/file/${filePath}`);
+    }
+    /** Delete a file from a bucket. */
+    async deleteFile(bucket, filePath) {
+        await this.http.request("DELETE", `/storage/${bucket}/file/${filePath}`);
+    }
+    /** List files in a bucket with optional prefix filtering and pagination. */
+    async listFiles(bucket, options) {
+        const query = {};
+        if (options?.prefix)
+            query.prefix = options.prefix;
+        if (options?.delimiter)
+            query.delimiter = options.delimiter;
+        if (options?.maxResults !== undefined)
+            query.maxResults = String(options.maxResults);
+        if (options?.pageToken)
+            query.pageToken = options.pageToken;
+        return this.http.request("GET", `/storage/${bucket}/list`, { query });
+    }
+    /** Create a new GCS bucket. */
+    async createBucket(params) {
+        return this.http.request("POST", "/storage/buckets", { body: params });
+    }
+    /** List all accessible buckets. */
+    async listBuckets() {
+        return this.http.request("GET", "/storage/buckets");
+    }
+}
+//# sourceMappingURL=storage.js.map

package/dist/modules/storage.js.map

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