clefbase 1.1.6 → 1.2.0

package/dist/db/index.d.ts

@@ -6,51 +6,38 @@ export type { WhereClause, WhereValue } from "../types";
  *
  * @example
  * const ref = db.collection("users").doc("abc123");
- * const user = await ref.get();            // T | null
- * await ref.update({ name: "Alice" });     // merge patch
- * await ref.set({ name: "Alice", age: 30 }); // full overwrite
+ * const user = await ref.get();               // T | null
+ * await ref.update({ name: "Alice" });        // merge patch
+ * await ref.set({ name: "Alice", age: 30 });  // full overwrite
  * await ref.delete();
- *
- * // Subcollection
- * const comments = ref.subcollection("comments");
  */
 export declare class DocumentReference<T extends ClefbaseDocument = ClefbaseDocument> {
     private readonly http;
-    /** Full collection path, e.g. "users" or "users/uid/posts" */
     readonly collectionPath: string;
     readonly id: string;
-    constructor(http: HttpClient, 
-    /** Full collection path, e.g. "users" or "users/uid/posts" */
-    collectionPath: string, id: string);
+    constructor(http: HttpClient, collectionPath: string, id: string);
     /** Fetch this document. Returns null when it does not exist. */
     get(): Promise<T | null>;
     /**
-     * Patch this document.
-     * By default fields are merged; pass `{ merge: false }` to fully replace.
-     *
-     * @example
-     * await ref.update({ score: 42 });
-     * await ref.update({ score: 42 }, { merge: false }); // replaces whole doc
+     * Patch this document (merge by default).
+     * Pass `{ merge: false }` to fully replace the document.
      */
     update(data: Partial<Omit<T, "_id" | "_createdAt" | "_updatedAt">>, opts?: {
         merge?: boolean;
     }): Promise<T>;
-    /**
-     * Overwrite this document entirely (no merge).
-     *
-     * @example
-     * await ref.set({ name: "Bob", age: 25 });
-     */
+    /** Overwrite this document entirely (no merge). */
     set(data: Omit<T, "_id" | "_createdAt" | "_updatedAt">): Promise<T>;
-    /** Delete this document (and all its subcollections on the server). */
+    /** Delete this document. */
     delete(): Promise<void>;
     /**
      * Access a subcollection nested under this document.
      *
      * @example
-     * const comments = db.collection("posts").doc("p1").subcollection("comments");
+     * const comments = db.collection("posts").doc("p1").collection("comments");
      * await comments.add({ text: "Great!" });
      */
+    collection<S extends ClefbaseDocument = ClefbaseDocument>(name: string): CollectionReference<S>;
+    /** @deprecated Use .collection() — kept for backwards compat */
     subcollection<S extends ClefbaseDocument = ClefbaseDocument>(name: string): CollectionReference<S>;
 }
 /**
@@ -76,23 +63,24 @@ export declare class Query<T extends ClefbaseDocument = ClefbaseDocument> {
     protected _offset: number;
     constructor(http: HttpClient, path: string);
     /**
-     * Filter documents by field values or operators.
-     * Multiple calls are merged together (AND logic).
-     *
-     * @example
-     * .where({ published: true })
-     * .where({ views: { $gte: 100 } })
+     * Filter by field values or operators.
+     * Multiple calls are AND-merged.
      */
     where(clauses: WhereClause): this;
-    /** Sort by a field. Default direction is ascending. */
+    /** Sort by a field. */
     orderBy(field: string, dir?: "asc" | "desc"): this;
-    /** Cap results at n (server maximum: 500). */
+    /** Cap results (server max: 500). */
     limit(n: number): this;
-    /** Skip the first n results (for pagination). */
+    /** Skip the first n results (pagination). */
     offset(n: number): this;
-    /** Execute and return the full paginated result object. */
+    /** Execute — returns full paginated result object. */
     query(): Promise<QueryResult<T>>;
-    /** Execute and return just the document array. */
+    /**
+     * Execute — returns just the document array.
+     * @alias getDocs
+     */
+    get(): Promise<T[]>;
+    /** @alias get() */
     getDocs(): Promise<T[]>;
 }
 /**
@@ -100,14 +88,8 @@ export declare class Query<T extends ClefbaseDocument = ClefbaseDocument> {
  *
  * @example
  * const col = db.collection("users");
- *
- * // Add
  * const user = await col.add({ name: "Alice", age: 30 });
- *
- * // List (no filter)
  * const { data, total } = await col.list({ limit: 20 });
- *
- * // Query (with filter / sort)
  * const adults = await col.where({ age: { $gte: 18 } }).orderBy("name").getDocs();
  */
 export declare class CollectionReference<T extends ClefbaseDocument = ClefbaseDocument> extends Query<T> {
@@ -117,11 +99,8 @@ export declare class CollectionReference<T extends ClefbaseDocument = ClefbaseDo
     /** Add a new document with a server-generated ID. */
     add(data: Omit<T, "_id" | "_createdAt" | "_updatedAt">): Promise<T>;
     /**
-     * Fetch documents without any query filter — useful for simple pagination.
-     * For filtering/sorting use the inherited `.where()` / `.orderBy()` chain.
-     *
-     * @example
-     * const { data, total } = await col.list({ limit: 10, offset: 20 });
+     * List documents without a filter — useful for simple pagination.
+     * For filtering/sorting, use the inherited `.where()` / `.orderBy()` chain.
      */
     list(opts?: {
         limit?: number;
@@ -129,37 +108,22 @@ export declare class CollectionReference<T extends ClefbaseDocument = ClefbaseDo
     }): Promise<QueryResult<T>>;
 }
 /**
- * Top-level database service.
- * Obtain via `getDatabase(app)`.
+ * Top-level database service. Obtain via `getDatabase(app)`.
  *
  * @example
- * import { initClefbase, getDatabase } from "clefbase";
- * const app = initClefbase({ serverUrl, projectId, apiKey });
  * const db = getDatabase(app);
- *
- * // Reference-based API
  * const post = await db.collection("posts").doc("p1").get();
- *
- * // Convenience helpers
  * const user = await db.getDoc("users", "uid-123");
- * const newDoc = await db.addDoc("logs", { action: "login" });
- * await db.updateDoc("users", "uid-123", { lastSeen: new Date().toISOString() });
- * await db.deleteDoc("users", "uid-123");
  */
 export declare class Database {
     private readonly http;
     constructor(http: HttpClient);
-    /** Return a CollectionReference for a top-level collection. */
     collection<T extends ClefbaseDocument = ClefbaseDocument>(name: string): CollectionReference<T>;
-    /** Fetch a single document by collection name and ID. Returns null if not found. */
     getDoc<T extends ClefbaseDocument = ClefbaseDocument>(collectionName: string, id: string): Promise<T | null>;
-    /** Add a document to a collection and return it with server-set fields. */
     addDoc<T extends ClefbaseDocument = ClefbaseDocument>(collectionName: string, data: Omit<T, "_id" | "_createdAt" | "_updatedAt">): Promise<T>;
-    /** Patch a document. Merges by default; pass `{ merge: false }` to overwrite. */
     updateDoc<T extends ClefbaseDocument = ClefbaseDocument>(collectionName: string, id: string, data: Partial<Omit<T, "_id" | "_createdAt" | "_updatedAt">>, opts?: {
         merge?: boolean;
     }): Promise<T>;
-    /** Delete a document. */
     deleteDoc(collectionName: string, id: string): Promise<void>;
 }
 //# sourceMappingURL=index.d.ts.map

package/dist/db/index.d.ts.map

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

package/dist/db/index.js

@@ -7,18 +7,13 @@ exports.Database = exports.CollectionReference = exports.Query = exports.Documen
  *
  * @example
  * const ref = db.collection("users").doc("abc123");
- * const user = await ref.get();            // T | null
- * await ref.update({ name: "Alice" });     // merge patch
- * await ref.set({ name: "Alice", age: 30 }); // full overwrite
+ * const user = await ref.get();               // T | null
+ * await ref.update({ name: "Alice" });        // merge patch
+ * await ref.set({ name: "Alice", age: 30 });  // full overwrite
  * await ref.delete();
- *
- * // Subcollection
- * const comments = ref.subcollection("comments");
  */
 class DocumentReference {
-    constructor(http, 
-    /** Full collection path, e.g. "users" or "users/uid/posts" */
-    collectionPath, id) {
+    constructor(http, collectionPath, id) {
         this.http = http;
         this.collectionPath = collectionPath;
         this.id = id;
@@ -29,34 +24,24 @@ class DocumentReference {
             return await this.http.get(`/${this.collectionPath}/${this.id}`);
         }
         catch (err) {
-            const status = err.status;
-            if (status === 404)
+            if (err.status === 404)
                 return null;
             throw err;
         }
     }
     /**
-     * Patch this document.
-     * By default fields are merged; pass `{ merge: false }` to fully replace.
-     *
-     * @example
-     * await ref.update({ score: 42 });
-     * await ref.update({ score: 42 }, { merge: false }); // replaces whole doc
+     * Patch this document (merge by default).
+     * Pass `{ merge: false }` to fully replace the document.
      */
     async update(data, opts) {
         const merge = opts?.merge ?? true;
         return this.http.put(`/${this.collectionPath}/${this.id}?merge=${String(merge)}`, data);
     }
-    /**
-     * Overwrite this document entirely (no merge).
-     *
-     * @example
-     * await ref.set({ name: "Bob", age: 25 });
-     */
+    /** Overwrite this document entirely (no merge). */
     async set(data) {
         return this.http.put(`/${this.collectionPath}/${this.id}?merge=false`, data);
     }
-    /** Delete this document (and all its subcollections on the server). */
+    /** Delete this document. */
     async delete() {
         await this.http.delete(`/${this.collectionPath}/${this.id}`);
     }
@@ -64,12 +49,16 @@ class DocumentReference {
      * Access a subcollection nested under this document.
      *
      * @example
-     * const comments = db.collection("posts").doc("p1").subcollection("comments");
+     * const comments = db.collection("posts").doc("p1").collection("comments");
      * await comments.add({ text: "Great!" });
      */
-    subcollection(name) {
+    collection(name) {
         return new CollectionReference(this.http, `${this.collectionPath}/${this.id}/${name}`);
     }
+    /** @deprecated Use .collection() — kept for backwards compat */
+    subcollection(name) {
+        return this.collection(name);
+    }
 }
 exports.DocumentReference = DocumentReference;
 // ─── Query ────────────────────────────────────────────────────────────────────
@@ -93,33 +82,29 @@ class Query {
         this._offset = 0;
     }
     /**
-     * Filter documents by field values or operators.
-     * Multiple calls are merged together (AND logic).
-     *
-     * @example
-     * .where({ published: true })
-     * .where({ views: { $gte: 100 } })
+     * Filter by field values or operators.
+     * Multiple calls are AND-merged.
      */
     where(clauses) {
         this._filter = { ...this._filter, ...clauses };
         return this;
     }
-    /** Sort by a field. Default direction is ascending. */
+    /** Sort by a field. */
     orderBy(field, dir = "asc") {
         this._sort = { field, dir };
         return this;
     }
-    /** Cap results at n (server maximum: 500). */
+    /** Cap results (server max: 500). */
     limit(n) {
         this._limit = Math.min(n, 500);
         return this;
     }
-    /** Skip the first n results (for pagination). */
+    /** Skip the first n results (pagination). */
     offset(n) {
         this._offset = n;
         return this;
     }
-    /** Execute and return the full paginated result object. */
+    /** Execute — returns full paginated result object. */
     async query() {
         const body = {
             filter: Object.keys(this._filter).length > 0 ? this._filter : undefined,
@@ -129,10 +114,16 @@ class Query {
         };
         return this.http.post(`/${this.path}/query`, body);
     }
-    /** Execute and return just the document array. */
+    /**
+     * Execute — returns just the document array.
+     * @alias getDocs
+     */
+    async get() {
+        return (await this.query()).data;
+    }
+    /** @alias get() */
     async getDocs() {
-        const result = await this.query();
-        return result.data;
+        return this.get();
     }
 }
 exports.Query = Query;
@@ -142,14 +133,8 @@ exports.Query = Query;
  *
  * @example
  * const col = db.collection("users");
- *
- * // Add
  * const user = await col.add({ name: "Alice", age: 30 });
- *
- * // List (no filter)
  * const { data, total } = await col.list({ limit: 20 });
- *
- * // Query (with filter / sort)
  * const adults = await col.where({ age: { $gte: 18 } }).orderBy("name").getDocs();
  */
 class CollectionReference extends Query {
@@ -165,63 +150,42 @@ class CollectionReference extends Query {
         return this.http.post(`/${this.path}`, data);
     }
     /**
-     * Fetch documents without any query filter — useful for simple pagination.
-     * For filtering/sorting use the inherited `.where()` / `.orderBy()` chain.
-     *
-     * @example
-     * const { data, total } = await col.list({ limit: 10, offset: 20 });
+     * List documents without a filter — useful for simple pagination.
+     * For filtering/sorting, use the inherited `.where()` / `.orderBy()` chain.
      */
     async list(opts) {
         const limit = Math.min(opts?.limit ?? 50, 500);
         const offset = opts?.offset ?? 0;
-        const qs = new URLSearchParams({
-            limit: String(limit),
-            offset: String(offset),
-        });
+        const qs = new URLSearchParams({ limit: String(limit), offset: String(offset) });
         return this.http.get(`/${this.path}?${qs}`);
     }
 }
 exports.CollectionReference = CollectionReference;
 // ─── Database ─────────────────────────────────────────────────────────────────
 /**
- * Top-level database service.
- * Obtain via `getDatabase(app)`.
+ * Top-level database service. Obtain via `getDatabase(app)`.
  *
  * @example
- * import { initClefbase, getDatabase } from "clefbase";
- * const app = initClefbase({ serverUrl, projectId, apiKey });
  * const db = getDatabase(app);
- *
- * // Reference-based API
  * const post = await db.collection("posts").doc("p1").get();
- *
- * // Convenience helpers
  * const user = await db.getDoc("users", "uid-123");
- * const newDoc = await db.addDoc("logs", { action: "login" });
- * await db.updateDoc("users", "uid-123", { lastSeen: new Date().toISOString() });
- * await db.deleteDoc("users", "uid-123");
  */
 class Database {
     constructor(http) {
         this.http = http;
     }
-    /** Return a CollectionReference for a top-level collection. */
     collection(name) {
         return new CollectionReference(this.http, name);
     }
-    /** Fetch a single document by collection name and ID. Returns null if not found. */
     async getDoc(collectionName, id) {
         return this.collection(collectionName).doc(id).get();
     }
-    /** Add a document to a collection and return it with server-set fields. */
     async addDoc(collectionName, data) {
         return this.collection(collectionName).add(data);
     }
-    /** Patch a document. Merges by default; pass `{ merge: false }` to overwrite. */
     async updateDoc(collectionName, id, data, opts) {
         return this.collection(collectionName).doc(id).update(data, opts);
     }
-    /** Delete a document. */
     async deleteDoc(collectionName, id) {
         return this.collection(collectionName).doc(id).delete();
     }

package/dist/db/index.js.map

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

package/dist/hosting/index.d.ts

@@ -0,0 +1,123 @@
+import { HttpClient } from "../http";
+export type HostingStatus = "enabled" | "disabled";
+export type DeployStatus = "pending" | "building" | "live" | "failed";
+export interface HostingSite {
+    id: string;
+    dbId: string;
+    name: string;
+    description?: string;
+    status: HostingStatus;
+    customDomain?: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface HostingDeploy {
+    id: string;
+    siteId: string;
+    dbId: string;
+    status: DeployStatus;
+    message?: string;
+    deployedBy?: string;
+    fileCount: number;
+    totalBytes: number;
+    entrypoint: string;
+    createdAt: string;
+    finishedAt?: string;
+}
+export interface HostingFile {
+    id: string;
+    deployId: string;
+    siteId: string;
+    dbId: string;
+    filePath: string;
+    mimeType: string;
+    sizeBytes: number;
+    md5: string;
+    uploadedAt: string;
+}
+export interface DeployResult {
+    deploy: HostingDeploy;
+    filesUploaded: number;
+    errors: string[];
+    url: string;
+}
+export interface DeployOptions {
+    entrypoint?: string;
+    deployedBy?: string;
+    message?: string;
+    /** Batch size for parallel uploads. Default: 20. */
+    batchSize?: number;
+    /** Called after each batch with progress info. */
+    onProgress?: (uploaded: number, total: number) => void;
+}
+/**
+ * A reference to a hosted site.
+ *
+ * @example
+ * const site = hosting.site("my-site-id");
+ * const result = await site.deployFiles({ "index.html": htmlBuffer, "app.js": jsBuffer });
+ * console.log(`Live at ${result.url}`);
+ */
+export declare class SiteReference {
+    private readonly hosting;
+    readonly siteId: string;
+    constructor(hosting: ClefbaseHosting, siteId: string);
+    /** Get site metadata. */
+    get(): Promise<HostingSite | null>;
+    /** Get the currently live deploy, or null if none. */
+    getActiveDeploy(): Promise<HostingDeploy | null>;
+    /** List all deploys for this site (newest first). */
+    listDeploys(): Promise<HostingDeploy[]>;
+    /**
+     * Deploy a map of { "filePath": Buffer } to this site.
+     * Creates a deploy, uploads all files in batches, then goes live.
+     *
+     * @example
+     * import fs from "fs";
+     * import path from "path";
+     *
+     * const files = {};
+     * // Build your file map however you like, e.g.:
+     * files["index.html"] = fs.readFileSync("dist/index.html");
+     * files["app.js"]     = fs.readFileSync("dist/app.js");
+     *
+     * const result = await site.deployFiles(files, {
+     *   message: "v1.2.0",
+     *   onProgress: (done, total) => console.log(`${done}/${total}`),
+     * });
+     */
+    deployFiles(files: Record<string, Buffer>, opts?: DeployOptions): Promise<DeployResult>;
+    /** The public URL for this site. */
+    get url(): string;
+}
+/**
+ * Hosting service. Obtain via `getHosting(app)`.
+ *
+ * @example
+ * const hosting = getHosting(app);
+ * const site = await hosting.createSite("my-app");
+ * const result = await hosting.site(site.id).deployFiles(files);
+ * console.log(result.url);
+ */
+export declare class ClefbaseHosting {
+    private readonly http;
+    private readonly dbId;
+    private readonly serverUrl;
+    constructor(http: HttpClient, dbId: string, serverUrl: string);
+    /** List all sites for this project. */
+    listSites(): Promise<HostingSite[]>;
+    /** Create a new hosted site. */
+    createSite(name: string, description?: string): Promise<HostingSite>;
+    /** Update site metadata. */
+    updateSite(siteId: string, patch: Partial<Pick<HostingSite, "name" | "description" | "status" | "customDomain">>): Promise<HostingSite>;
+    /** Delete a site and all its deploys permanently. */
+    deleteSite(siteId: string): Promise<void>;
+    /** Return a SiteReference for a specific site ID. */
+    site(siteId: string): SiteReference;
+    _siteUrl(siteId: string): string;
+    _getSite(siteId: string): Promise<HostingSite | null>;
+    _getActiveDeploy(siteId: string): Promise<HostingDeploy | null>;
+    _listDeploys(siteId: string): Promise<HostingDeploy[]>;
+    _deployFiles(siteId: string, files: Record<string, Buffer>, opts?: DeployOptions): Promise<DeployResult>;
+}
+//# sourceMappingURL=index.d.ts.map

package/dist/hosting/index.d.ts.map

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