clefbase 1.1.6 → 1.2.0

package/README.md

@@ -1,6 +1,6 @@
 # clefbase
 
-Firebase-style SDK for your Clefbase server. Drop-in for Node.js and browser apps.
+Firebase-style SDK and CLI for Clefbase / [Cleforyx](https://cleforyx.com). Database, auth, storage, and hosting in one package.
 
 ## Install
 
@@ -12,18 +12,26 @@ npm install clefbase
 
 ## Quick Start
 
+### 1 — Initialise your project
+
+```bash
+npx clefbase init
+```
+
+The CLI will ask for your Project ID, API Key, and Admin Secret, let you pick which services you need, and optionally set up hosting. It writes a `clefbase.json` config file (automatically added to `.gitignore`) and a `.env.example`.
+
+### 2 — Use the SDK
+
 ```ts
-import { initClefbase, getDatabase, getAuth, getStorage } from "clefbase";
+import { initClefbase, getDatabase, getAuth, getStorage, getHosting } from "clefbase";
+import config from "./clefbase.json";
 
-const app = initClefbase({
-  serverUrl: "https://your-clefbase-server.com",
-  projectId: "my_project_1abc",          // from your dashboard
-  apiKey: "cfx_abc123...",               // generated API key
-});
+const app = initClefbase(config);
 
 const db      = getDatabase(app);
 const auth    = getAuth(app);
 const storage = getStorage(app);
+const hosting = getHosting(app);  // requires adminSecret in config
 ```
 
 ---
@@ -38,7 +46,7 @@ const post = await db.collection("posts").add({
   published: true,
   views: 0,
 });
-// post._id, post._createdAt, post._updatedAt are auto-set
+// post._id, post._createdAt, post._updatedAt are set by the server
 ```
 
 ### Get a document
@@ -71,27 +79,23 @@ const results = await db.collection("posts")
   .where({ published: true, views: { $gt: 100 } })
   .orderBy("_createdAt", "desc")
   .limit(10)
-  .get();
-
-// results.data  — array of documents
-// results.total — total matching count
-// results.limit, results.offset
+  .query();  // returns { data, total, limit, offset }
 
-// Or just get the array:
+// Or just the array:
 const posts = await db.collection("posts")
   .where({ published: true })
-  .getDocs();
+  .getDocs();   // alias: .get()
 ```
 
-### Available filter operators
+### Filter operators
 
-| Operator       | Meaning              |
-|----------------|----------------------|
-| `{ $gt: n }`   | greater than         |
-| `{ $gte: n }`  | greater than or equal|
-| `{ $lt: n }`   | less than            |
-| `{ $lte: n }`  | less than or equal   |
-| `{ $ne: val }` | not equal            |
+| Operator | Meaning |
+|---|---|
+| `{ $gt: n }` | greater than |
+| `{ $gte: n }` | greater than or equal |
+| `{ $lt: n }` | less than |
+| `{ $lte: n }` | less than or equal |
+| `{ $ne: val }` | not equal |
 | `{ $contains: "str" }` | string contains (case-insensitive) |
 
 ### Subcollections
@@ -99,12 +103,11 @@ const posts = await db.collection("posts")
 ```ts
 // posts → [postId] → comments
 const comments = db.collection("posts").doc("post-abc").collection("comments");
-
 await comments.add({ text: "Great post!", author: "Bob" });
 const all = await comments.getDocs();
 ```
 
-### Convenience top-level helpers
+### Convenience helpers
 
 ```ts
 await db.getDoc("users", "uid-123");
@@ -117,139 +120,202 @@ await db.deleteDoc("users", "uid-123");
 
 ## Auth
 
-### Sign up
-
 ```ts
+// Sign up
 const { user, token } = await auth.signUp("alice@example.com", "password123", {
   displayName: "Alice",
   metadata: { role: "member" },
 });
-```
 
-### Sign in / Sign out
-
-```ts
+// Sign in / out
 const { user } = await auth.signIn("alice@example.com", "password123");
-
 await auth.signOut();
-```
-
-### Current user
 
-```ts
+// Current user
 const me = auth.currentUser; // AuthUser | null
-```
-
-### Listen for auth state changes
 
-```ts
+// Listen for auth state changes
 const unsubscribe = auth.onAuthStateChanged((user) => {
-  if (user) {
-    console.log("Signed in as", user.email);
-  } else {
-    console.log("Signed out");
-  }
+  if (user) console.log("Signed in as", user.email);
+  else      console.log("Signed out");
 });
-
-// Stop listening
 unsubscribe();
-```
-
-### Update profile
 
-```ts
+// Update profile
 await auth.updateProfile({ displayName: "Bob", metadata: { theme: "dark" } });
-```
 
-### Password management
-
-```ts
-// Change password (must be signed in)
+// Password management
 await auth.changePassword("oldPass", "newPass");
-
-// Request reset email
 await auth.sendPasswordResetEmail("alice@example.com");
-
-// Confirm reset with token from email
 await auth.confirmPasswordReset(resetToken, "newPassword");
-```
 
-### Email verification
-
-```ts
+// Email verification
 await auth.sendEmailVerification();
-await auth.verifyEmail("ABC123");  // code from email
+await auth.verifyEmail("ABC123");
 ```
 
 ---
 
 ## Storage
 
-### Upload a file
-
 ```ts
-// Node.js
+// Upload (Node.js)
 import fs from "fs";
-const buffer = fs.readFileSync("./photo.jpg");
-const meta = await storage.ref("avatars/user-123.jpg").upload(buffer, {
-  contentType: "image/jpeg",
-});
+const meta = await storage.ref("avatars/user-123.jpg").upload(
+  fs.readFileSync("./photo.jpg"),
+  { contentType: "image/jpeg" }
+);
 
-// Browser
-const file = fileInput.files[0];
+// Upload (browser)
 const meta = await storage.ref(`uploads/${file.name}`).upload(file);
-```
 
-### Get download URL
-
-```ts
+// Download URL
 const url = await storage.ref("avatars/user-123.jpg").getDownloadURL();
-```
 
-### Get metadata
-
-```ts
+// Metadata
 const meta = await storage.ref("avatars/user-123.jpg").getMetadata();
-// meta.size, meta.mimeType, meta.url, meta.createdAt
+
+// Delete
+await storage.ref("avatars/user-123.jpg").delete();
+
+// List files
+const files = await storage.ref("avatars/").list({ limit: 20 });
+
+// Named bucket
+const ref = storage.bucket("user-uploads").ref("doc.pdf");
+await ref.upload(buffer, { contentType: "application/pdf" });
 ```
 
-### Delete a file
+---
+
+## Hosting
+
+### SDK
 
 ```ts
-await storage.ref("avatars/user-123.jpg").delete();
+import fs from "fs";
+const hosting = getHosting(app);
+
+// List sites
+const sites = await hosting.listSites();
+
+// Create a site
+const site = await hosting.createSite("my-app", "My awesome app");
+
+// Deploy files
+const result = await hosting.site(site.id).deployFiles({
+  "index.html": fs.readFileSync("dist/index.html"),
+  "app.js":     fs.readFileSync("dist/app.js"),
+  "styles.css": fs.readFileSync("dist/styles.css"),
+}, {
+  entrypoint: "index.html",
+  message:    "v1.2.0 release",
+  onProgress: (done, total) => console.log(`${done}/${total} files`),
+});
+
+console.log(`Live at: ${result.url}`);
+
+// Get active deploy
+const active = await hosting.site(site.id).getActiveDeploy();
 ```
 
-### List files
+### CLI
 
-```ts
-const files = await storage.ref("avatars/").list({ limit: 20 });
+```bash
+# First-time setup (interactive)
+clefbase init
+
+# Build then deploy in one step
+npm run build && clefbase deploy
+
+# Deploy with options
+clefbase deploy --dir ./build --message "v2 release"
+clefbase deploy --site <siteId>     # override the linked site
+
+# Manage hosting
+clefbase hosting:init               # link/create a site
+clefbase hosting:status             # show current live deploy
+clefbase hosting:sites              # list all sites
+
+# Project info
+clefbase info                       # config + connectivity check
 ```
 
-### Use a specific bucket
+---
 
-```ts
-const ref = storage.bucket("user-uploads").ref("doc.pdf");
-await ref.upload(buffer, { contentType: "application/pdf" });
+## CLI Reference
+
+| Command | Description |
+|---|---|
+| `clefbase init` | Interactive project setup |
+| `clefbase deploy` | Deploy your built site |
+| `clefbase deploy -d <dir>` | Deploy from a specific directory |
+| `clefbase deploy -m <msg>` | Deploy with a release note |
+| `clefbase deploy -s <siteId>` | Deploy to a specific site |
+| `clefbase hosting:init` | Link or create a hosted site |
+| `clefbase hosting:status` | Show current live deploy |
+| `clefbase hosting:sites` | List all sites |
+| `clefbase info` | Show config and connectivity |
+
+---
+
+## clefbase.json
+
+Written by `clefbase init`. Never commit this file — it contains your secrets. The CLI adds it to `.gitignore` automatically.
+
+```json
+{
+  "serverUrl":   "https://api.cleforyx.com",
+  "projectId":   "my_project_abc123",
+  "apiKey":      "cfx_...",
+  "adminSecret": "...",
+  "services": {
+    "database": true,
+    "auth":     true,
+    "storage":  false,
+    "hosting":  true
+  },
+  "hosting": {
+    "siteId":     "355f3976-89dc-...",
+    "siteName":   "my-app",
+    "distDir":    "dist",
+    "entrypoint": "index.html"
+  }
+}
 ```
 
 ---
 
 ## TypeScript
 
-The SDK is fully typed. Pass your own document shape as a generic:
+Full types with generics:
 
 ```ts
-interface Post {
-  _id: string;
-  _createdAt: string;
-  _updatedAt: string;
-  title: string;
+interface Post extends ClefbaseDocument {
+  title:     string;
   published: boolean;
-  views: number;
+  views:     number;
 }
 
 const posts = db.collection<Post>("posts");
-const post = await posts.doc("abc").get(); // typed as Post | null
+const post  = await posts.doc("abc").get();  // Post | null
+```
+
+---
+
+## Error handling
+
+```ts
+import { ClefbaseError } from "clefbase";
+
+try {
+  await auth.signIn("bad@example.com", "wrong");
+} catch (err) {
+  if (err instanceof ClefbaseError) {
+    console.log(err.message); // "Invalid credentials"
+    console.log(err.status);  // 401
+  }
+}
 ```
 
 ---
@@ -257,9 +323,9 @@ const post = await posts.doc("abc").get(); // typed as Post | null
 ## Multiple apps
 
 ```ts
-const defaultApp = initClefbase({ ... });
-const adminApp   = initClefbase({ ..., apiKey: "admin-key" }, "admin");
+const defaultApp = initClefbase({ serverUrl, projectId, apiKey });
+const adminApp   = initClefbase({ serverUrl, projectId, apiKey: adminKey, adminSecret }, "admin");
 
 const db      = getDatabase(defaultApp);
-const adminDb = getDatabase(adminApp);
+const hosting = getHosting(adminApp);
 ```

package/bin/clefbase.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+
+// Gracefully tell the user if the package hasn't been built yet
+try {
+  require("../dist/cli.js");
+} catch (e) {
+  if (e.code === "MODULE_NOT_FOUND") {
+    console.error(
+      "\nclefbase CLI not built yet. Run:\n\n  npm run build\n\nthen try again.\n"
+    );
+    process.exit(1);
+  }
+  throw e;
+}

package/dist/app.d.ts

@@ -2,19 +2,22 @@ import { HttpClient } from "./http";
 import { Database } from "./db";
 import { Auth } from "./auth";
 import { ClefbaseStorage } from "./storage";
+import { ClefbaseHosting } from "./hosting";
 import type { ClefbaseConfig } from "./types";
 /**
  * A Clefbase application instance.
- * Created by `initClefbase()` and passed to `getDatabase()`, `getAuth()`, `getStorage()`.
+ * Created by `initClefbase()` — pass it to `getDatabase()`, `getAuth()`, etc.
  */
 export declare class ClefbaseApp {
     readonly config: ClefbaseConfig;
     /** @internal */ readonly _dbHttp: HttpClient;
     /** @internal */ readonly _authHttp: HttpClient;
     /** @internal */ readonly _storageHttp: HttpClient;
+    /** @internal */ readonly _hostingHttp: HttpClient;
     private _db;
     private _auth;
     private _storage;
+    private _hosting;
     constructor(config: ClefbaseConfig);
     /** @internal */
     _getDb(): Database;
@@ -22,6 +25,8 @@ export declare class ClefbaseApp {
     _getAuth(): Auth;
     /** @internal */
     _getStorage(): ClefbaseStorage;
+    /** @internal */
+    _getHosting(): ClefbaseHosting;
 }
 /**
  * Initialise a Clefbase app. Call once at startup.
@@ -29,42 +34,21 @@ export declare class ClefbaseApp {
  *
  * @example
  * const app = initClefbase({
- *   serverUrl: "https://your-server.com",
- *   projectId: "my_project_1abc",
- *   apiKey: "cfx_abc123...",
+ *   serverUrl:   "https://api.cleforyx.com",
+ *   projectId:   "my_project_abc",
+ *   apiKey:      "cfx_...",
+ *   adminSecret: "secret",  // only needed for hosting
  * });
- *
- * // Named app (multiple projects)
- * const admin = initClefbase({ ... }, "admin");
  */
 export declare function initClefbase(config: ClefbaseConfig, name?: string): ClefbaseApp;
-/**
- * Retrieve an already-initialised app by name.
- * Throws if `initClefbase()` has not been called for that name.
- */
+/** Retrieve an already-initialised app by name. Throws if not found. */
 export declare function getApp(name?: string): ClefbaseApp;
-/**
- * Get the Database service for an app.
- *
- * @example
- * const db = getDatabase(app);
- * const user = await db.collection("users").doc("123").get();
- */
+/** Get the Database service. */
 export declare function getDatabase(app?: ClefbaseApp): Database;
-/**
- * Get the Auth service for an app.
- *
- * @example
- * const auth = getAuth(app);
- * const { user } = await auth.signIn("user@example.com", "pass");
- */
+/** Get the Auth service. */
 export declare function getAuth(app?: ClefbaseApp): Auth;
-/**
- * Get the Storage service for an app.
- *
- * @example
- * const storage = getStorage(app);
- * const url = await storage.ref("files/doc.pdf").getDownloadURL();
- */
+/** Get the Storage service. */
 export declare function getStorage(app?: ClefbaseApp): ClefbaseStorage;
+/** Get the Hosting service. Requires `adminSecret` in config. */
+export declare function getHosting(app?: ClefbaseApp): ClefbaseHosting;
 //# sourceMappingURL=app.d.ts.map

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAGhC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC9C,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAChD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAuB;IAClC,OAAO,CAAC,KAAK,CAAmB;IAChC,OAAO,CAAC,QAAQ,CAA8B;gBAElC,MAAM,EAAE,cAAc;IAelC,gBAAgB;IAChB,MAAM,IAAI,QAAQ;IAKlB,gBAAgB;IAChB,QAAQ,IAAI,IAAI;IAKhB,gBAAgB;IAChB,WAAW,IAAI,eAAe;CAS/B;AAOD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,MAAgB,GACrB,WAAW,CAKb;AAED;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAgB,GAAG,WAAW,CAQ1D;AAID;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,QAAQ,CAEvD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/C;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,QAAQ,CAAC;AACpC,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAChC,OAAO,EAAE,IAAI,EAAE,MAAM,QAAQ,CAAC;AAC9B,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AAC5C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,SAAS,CAAC;AAI9C;;;GAGG;AACH,qBAAa,WAAW;IACtB,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAEhC,gBAAgB,CAAC,QAAQ,CAAC,OAAO,EAAO,UAAU,CAAC;IACnD,gBAAgB,CAAC,QAAQ,CAAC,SAAS,EAAK,UAAU,CAAC;IACnD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IACnD,gBAAgB,CAAC,QAAQ,CAAC,YAAY,EAAE,UAAU,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAoC;IAC/C,OAAO,CAAC,KAAK,CAAkC;IAC/C,OAAO,CAAC,QAAQ,CAA+B;IAC/C,OAAO,CAAC,QAAQ,CAA+B;gBAEnC,MAAM,EAAE,cAAc;IAYlC,gBAAgB;IAChB,MAAM,IAAI,QAAQ;IAKlB,gBAAgB;IAChB,QAAQ,IAAI,IAAI;IAKhB,gBAAgB;IAChB,WAAW,IAAI,eAAe;IAU9B,gBAAgB;IAChB,WAAW,IAAI,eAAe;CAS/B;AAOD;;;;;;;;;;;GAWG;AACH,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,EACtB,IAAI,GAAE,MAAgB,GACrB,WAAW,CAKb;AAED,wEAAwE;AACxE,wBAAgB,MAAM,CAAC,IAAI,GAAE,MAAgB,GAAG,WAAW,CAQ1D;AAID,gCAAgC;AAChC,wBAAgB,WAAW,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,QAAQ,CAEvD;AAED,4BAA4B;AAC5B,wBAAgB,OAAO,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,IAAI,CAE/C;AAED,+BAA+B;AAC/B,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D;AAED,iEAAiE;AACjE,wBAAgB,UAAU,CAAC,GAAG,CAAC,EAAE,WAAW,GAAG,eAAe,CAE7D"}

package/dist/app.js

@@ -6,28 +6,27 @@ exports.getApp = getApp;
 exports.getDatabase = getDatabase;
 exports.getAuth = getAuth;
 exports.getStorage = getStorage;
+exports.getHosting = getHosting;
 const http_1 = require("./http");
 const db_1 = require("./db");
 const auth_1 = require("./auth");
 const storage_1 = require("./storage");
+const hosting_1 = require("./hosting");
 // ─── App ──────────────────────────────────────────────────────────────────────
 /**
  * A Clefbase application instance.
- * Created by `initClefbase()` and passed to `getDatabase()`, `getAuth()`, `getStorage()`.
+ * Created by `initClefbase()` — pass it to `getDatabase()`, `getAuth()`, etc.
  */
 class ClefbaseApp {
     constructor(config) {
         this.config = config;
         const base = config.serverUrl.replace(/\/+$/, "");
-        const keyHeader = { "x-cfx-key": config.apiKey };
-        // Server mounts (from index.ts):
-        //   app.use("/db",      ..., dbApiKeyMiddleware, createExternalDbRouter())
-        //   app.use("/auth",    ..., dbApiKeyMiddleware, createExternalAuthRouter())
-        //   app.use("/storage", ..., createPublicStorageRouter())   ← public reads
-        //   app.use("/storage", ..., dbApiKeyMiddleware, createExternalStorageRouter()) ← writes
-        this._dbHttp = new http_1.HttpClient(`${base}/db`, keyHeader);
-        this._authHttp = new http_1.HttpClient(`${base}/auth`, keyHeader);
-        this._storageHttp = new http_1.HttpClient(`${base}/storage`, keyHeader);
+        const cfxKey = { "x-cfx-key": config.apiKey };
+        const admin = { "x-admin-secret": config.adminSecret ?? "" };
+        this._dbHttp = new http_1.HttpClient(`${base}/db`, cfxKey);
+        this._authHttp = new http_1.HttpClient(`${base}/auth`, cfxKey);
+        this._storageHttp = new http_1.HttpClient(`${base}/storage`, cfxKey);
+        this._hostingHttp = new http_1.HttpClient(`${base}/api/hosting`, admin);
     }
     /** @internal */
     _getDb() {
@@ -44,13 +43,18 @@ class ClefbaseApp {
     /** @internal */
     _getStorage() {
         if (!this._storage)
-            this._storage = new storage_1.ClefbaseStorage(this._storageHttp, this.config.projectId, // passed as ?projectId= on public storage reads
-            this._getAuth());
+            this._storage = new storage_1.ClefbaseStorage(this._storageHttp, this.config.projectId, this._getAuth());
         return this._storage;
     }
+    /** @internal */
+    _getHosting() {
+        if (!this._hosting)
+            this._hosting = new hosting_1.ClefbaseHosting(this._hostingHttp, this.config.projectId, this.config.serverUrl);
+        return this._hosting;
+    }
 }
 exports.ClefbaseApp = ClefbaseApp;
-// ─── App registry ─────────────────────────────────────────────────────────────
+// ─── Registry ─────────────────────────────────────────────────────────────────
 const DEFAULT = "[DEFAULT]";
 const registry = new Map();
 /**
@@ -59,13 +63,11 @@ const registry = new Map();
  *
  * @example
  * const app = initClefbase({
- *   serverUrl: "https://your-server.com",
- *   projectId: "my_project_1abc",
- *   apiKey: "cfx_abc123...",
+ *   serverUrl:   "https://api.cleforyx.com",
+ *   projectId:   "my_project_abc",
+ *   apiKey:      "cfx_...",
+ *   adminSecret: "secret",  // only needed for hosting
  * });
- *
- * // Named app (multiple projects)
- * const admin = initClefbase({ ... }, "admin");
  */
 function initClefbase(config, name = DEFAULT) {
     if (registry.has(name))
@@ -74,10 +76,7 @@ function initClefbase(config, name = DEFAULT) {
     registry.set(name, app);
     return app;
 }
-/**
- * Retrieve an already-initialised app by name.
- * Throws if `initClefbase()` has not been called for that name.
- */
+/** Retrieve an already-initialised app by name. Throws if not found. */
 function getApp(name = DEFAULT) {
     const app = registry.get(name);
     if (!app) {
@@ -86,34 +85,20 @@ function getApp(name = DEFAULT) {
     return app;
 }
 // ─── Service accessors ────────────────────────────────────────────────────────
-/**
- * Get the Database service for an app.
- *
- * @example
- * const db = getDatabase(app);
- * const user = await db.collection("users").doc("123").get();
- */
+/** Get the Database service. */
 function getDatabase(app) {
     return (app ?? getApp())._getDb();
 }
-/**
- * Get the Auth service for an app.
- *
- * @example
- * const auth = getAuth(app);
- * const { user } = await auth.signIn("user@example.com", "pass");
- */
+/** Get the Auth service. */
 function getAuth(app) {
     return (app ?? getApp())._getAuth();
 }
-/**
- * Get the Storage service for an app.
- *
- * @example
- * const storage = getStorage(app);
- * const url = await storage.ref("files/doc.pdf").getDownloadURL();
- */
+/** Get the Storage service. */
 function getStorage(app) {
     return (app ?? getApp())._getStorage();
 }
+/** Get the Hosting service. Requires `adminSecret` in config. */
+function getHosting(app) {
+    return (app ?? getApp())._getHosting();
+}
 //# sourceMappingURL=app.js.map

package/dist/app.js.map

@@ -1 +1 @@
-{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":";;;AAkFA,oCAQC;AAMD,wBAQC;AAWD,kCAEC;AASD,0BAEC;AASD,gCAEC;AA3ID,iCAAoC;AACpC,6BAAgC;AAChC,iCAA8B;AAC9B,uCAA4C;AAG5C,iFAAiF;AAEjF;;;GAGG;AACH,MAAa,WAAW;IAYtB,YAAY,MAAsB;QAChC,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,MAAM,IAAI,GAAG,MAAM,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClD,MAAM,SAAS,GAAG,EAAE,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAEjD,iCAAiC;QACjC,2EAA2E;QAC3E,6EAA6E;QAC7E,2EAA2E;QAC3E,yFAAyF;QACzF,IAAI,CAAC,OAAO,GAAQ,IAAI,iBAAU,CAAC,GAAG,IAAI,KAAK,EAAO,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,SAAS,GAAM,IAAI,iBAAU,CAAC,GAAG,IAAI,OAAO,EAAK,SAAS,CAAC,CAAC;QACjE,IAAI,CAAC,YAAY,GAAG,IAAI,iBAAU,CAAC,GAAG,IAAI,UAAU,EAAE,SAAS,CAAC,CAAC;IACnE,CAAC;IAED,gBAAgB;IAChB,MAAM;QACJ,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,IAAI,CAAC,GAAG,GAAG,IAAI,aAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACrD,OAAO,IAAI,CAAC,GAAG,CAAC;IAClB,CAAC;IAED,gBAAgB;IAChB,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,KAAK;YAAE,IAAI,CAAC,KAAK,GAAG,IAAI,WAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,gBAAgB;IAChB,WAAW;QACT,IAAI,CAAC,IAAI,CAAC,QAAQ;YAChB,IAAI,CAAC,QAAQ,GAAG,IAAI,yBAAe,CACjC,IAAI,CAAC,YAAY,EACjB,IAAI,CAAC,MAAM,CAAC,SAAS,EAAG,gDAAgD;YACxE,IAAI,CAAC,QAAQ,EAAE,CAChB,CAAC;QACJ,OAAO,IAAI,CAAC,QAAQ,CAAC;IACvB,CAAC;CACF;AAjDD,kCAiDC;AAED,iFAAiF;AAEjF,MAAM,OAAO,GAAG,WAAW,CAAC;AAC5B,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEhD;;;;;;;;;;;;;GAaG;AACH,SAAgB,YAAY,CAC1B,MAAsB,EACtB,OAAe,OAAO;IAEtB,IAAI,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAE,CAAC;IACnD,MAAM,GAAG,GAAG,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;IACpC,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IACxB,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;GAGG;AACH,SAAgB,MAAM,CAAC,OAAe,OAAO;IAC3C,MAAM,GAAG,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC/B,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,IAAI,KAAK,CACb,iBAAiB,IAAI,wDAAwD,CAC9E,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC;AAED,iFAAiF;AAEjF;;;;;;GAMG;AACH,SAAgB,WAAW,CAAC,GAAiB;IAC3C,OAAO,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AACpC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,OAAO,CAAC,GAAiB;IACvC,OAAO,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC;AACtC,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,UAAU,CAAC,GAAiB;IAC1C,OAAO,CAAC,GAAG,IAAI,MAAM,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;AACzC,CAAC"}
+{"version":3,"file":"app.js","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"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"}