clefbase 1.3.7 → 1.3.9

package/dist/index.js

@@ -3,7 +3,7 @@
  * clefbase — Firebase-style SDK for Clefbase / Cleforyx
  *
  * @example
- * import { initClefbase, getDatabase, getAuth, getStorage, getHosting } from "clefbase";
+ * import { initClefbase, getDatabase, getAuth, getStorage, getHosting, FieldValue } from "clefbase";
  *
  * const app = initClefbase({
  *   serverUrl:   "https://api.cleforyx.com",
@@ -12,13 +12,35 @@
  *   adminSecret: "...",  // only needed for hosting
  * });
  *
- * const db      = getDatabase(app);
- * const auth    = getAuth(app);
- * const storage = getStorage(app);
- * const hosting = getHosting(app);
+ * const db = getDatabase(app);
+ *
+ * // FieldValue sentinels
+ * await db.collection("posts").doc("p1").update({
+ *   views:      FieldValue.increment(1),
+ *   score:      FieldValue.decrement(0.5),
+ *   publishedAt: FieldValue.serverTimestamp(),
+ *   draft:      FieldValue.deleteField(),
+ *   tags:       FieldValue.arrayUnion("featured"),
+ *   oldTags:    FieldValue.arrayRemove("wip"),
+ * });
+ *
+ * // Batch writes
+ * const batch = db.batch();
+ * batch.update(db.collection("counters").doc("hits"), { n: FieldValue.increment(1) });
+ * batch.delete(db.collection("sessions").doc("expired"));
+ * await batch.commit();
+ *
+ * // Transactions
+ * await db.runTransaction(async (tx) => {
+ *   const wallet = await tx.get(db.collection("wallets").doc(uid));
+ *   tx.update(db.collection("wallets").doc(uid), { balance: (wallet?.balance as number ?? 0) + 10 });
+ * });
+ *
+ * // Collection-group queries
+ * const allComments = await db.collectionGroup("comments").where({ approved: true }).getDocs();
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ClefbaseError = exports.SiteReference = exports.ClefbaseHosting = exports.BucketReference = exports.StorageReference = exports.ClefbaseStorage = exports.Auth = exports.Query = exports.DocumentReference = exports.CollectionReference = exports.Database = exports.getHosting = exports.getStorage = exports.getAuth = exports.getDatabase = exports.getApp = exports.initClefbase = exports.ClefbaseApp = void 0;
+exports.ClefbaseError = exports.FieldValueSentinel = exports.FieldValue = exports.SiteReference = exports.ClefbaseHosting = exports.EmailVerificationCard = exports.BucketReference = exports.StorageReference = exports.ClefbaseStorage = exports.Auth = exports.runTransaction = exports.Transaction = exports.WriteBatch = exports.Query = exports.DocumentReference = exports.CollectionGroup = exports.CollectionReference = exports.Database = exports.getHosting = exports.getStorage = exports.getAuth = exports.getDatabase = exports.getApp = exports.initClefbase = exports.ClefbaseApp = void 0;
 // ─── App ──────────────────────────────────────────────────────────────────────
 var app_1 = require("./app");
 Object.defineProperty(exports, "ClefbaseApp", { enumerable: true, get: function () { return app_1.ClefbaseApp; } });
@@ -32,8 +54,12 @@ Object.defineProperty(exports, "getHosting", { enumerable: true, get: function (
 var db_1 = require("./db");
 Object.defineProperty(exports, "Database", { enumerable: true, get: function () { return db_1.Database; } });
 Object.defineProperty(exports, "CollectionReference", { enumerable: true, get: function () { return db_1.CollectionReference; } });
+Object.defineProperty(exports, "CollectionGroup", { enumerable: true, get: function () { return db_1.CollectionGroup; } });
 Object.defineProperty(exports, "DocumentReference", { enumerable: true, get: function () { return db_1.DocumentReference; } });
 Object.defineProperty(exports, "Query", { enumerable: true, get: function () { return db_1.Query; } });
+Object.defineProperty(exports, "WriteBatch", { enumerable: true, get: function () { return db_1.WriteBatch; } });
+Object.defineProperty(exports, "Transaction", { enumerable: true, get: function () { return db_1.Transaction; } });
+Object.defineProperty(exports, "runTransaction", { enumerable: true, get: function () { return db_1.runTransaction; } });
 // ─── Auth ─────────────────────────────────────────────────────────────────────
 var auth_1 = require("./auth");
 Object.defineProperty(exports, "Auth", { enumerable: true, get: function () { return auth_1.Auth; } });
@@ -42,10 +68,17 @@ var storage_1 = require("./storage");
 Object.defineProperty(exports, "ClefbaseStorage", { enumerable: true, get: function () { return storage_1.ClefbaseStorage; } });
 Object.defineProperty(exports, "StorageReference", { enumerable: true, get: function () { return storage_1.StorageReference; } });
 Object.defineProperty(exports, "BucketReference", { enumerable: true, get: function () { return storage_1.BucketReference; } });
+// ─── Auth UI components (React) ───────────────────────────────────────────────
+var EmailVerificationCard_1 = require("./react/EmailVerificationCard");
+Object.defineProperty(exports, "EmailVerificationCard", { enumerable: true, get: function () { return EmailVerificationCard_1.EmailVerificationCard; } });
 // ─── Hosting ──────────────────────────────────────────────────────────────────
 var hosting_1 = require("./hosting");
 Object.defineProperty(exports, "ClefbaseHosting", { enumerable: true, get: function () { return hosting_1.ClefbaseHosting; } });
 Object.defineProperty(exports, "SiteReference", { enumerable: true, get: function () { return hosting_1.SiteReference; } });
+// ─── FieldValue ───────────────────────────────────────────────────────────────
+var field_value_1 = require("./field_value");
+Object.defineProperty(exports, "FieldValue", { enumerable: true, get: function () { return field_value_1.FieldValue; } });
+Object.defineProperty(exports, "FieldValueSentinel", { enumerable: true, get: function () { return field_value_1.FieldValueSentinel; } });
 var types_1 = require("./types");
 Object.defineProperty(exports, "ClefbaseError", { enumerable: true, get: function () { return types_1.ClefbaseError; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;GAiBG;;;AAEH,iFAAiF;AACjF,6BAQe;AAPb,kGAAA,WAAW,OAAA;AACX,mGAAA,YAAY,OAAA;AACZ,6FAAA,MAAM,OAAA;AACN,kGAAA,WAAW,OAAA;AACX,8FAAA,OAAO,OAAA;AACP,iGAAA,UAAU,OAAA;AACV,iGAAA,UAAU,OAAA;AAGZ,iFAAiF;AACjF,2BAA+E;AAAtE,8FAAA,QAAQ,OAAA;AAAE,yGAAA,mBAAmB,OAAA;AAAE,uGAAA,iBAAiB,OAAA;AAAE,2FAAA,KAAK,OAAA;AAEhE,iFAAiF;AACjF,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAGb,iFAAiF;AACjF,qCAA+E;AAAtE,0GAAA,eAAe,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAW3D,iFAAiF;AACjF,qCAA2D;AAAlD,0GAAA,eAAe,OAAA;AAAE,wGAAA,aAAa,OAAA;AAyBvC,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;;;AAEH,iFAAiF;AACjF,6BAQe;AAPb,kGAAA,WAAW,OAAA;AACX,mGAAA,YAAY,OAAA;AACZ,6FAAA,MAAM,OAAA;AACN,kGAAA,WAAW,OAAA;AACX,8FAAA,OAAO,OAAA;AACP,iGAAA,UAAU,OAAA;AACV,iGAAA,UAAU,OAAA;AAGZ,iFAAiF;AACjF,2BASc;AARZ,8FAAA,QAAQ,OAAA;AACR,yGAAA,mBAAmB,OAAA;AACnB,qGAAA,eAAe,OAAA;AACf,uGAAA,iBAAiB,OAAA;AACjB,2FAAA,KAAK,OAAA;AACL,gGAAA,UAAU,OAAA;AACV,iGAAA,WAAW,OAAA;AACX,oGAAA,cAAc,OAAA;AAGhB,iFAAiF;AACjF,+BAA8B;AAArB,4FAAA,IAAI,OAAA;AAGb,iFAAiF;AACjF,qCAA+E;AAAtE,0GAAA,eAAe,OAAA;AAAE,2GAAA,gBAAgB,OAAA;AAAE,0GAAA,eAAe,OAAA;AAU3D,iFAAiF;AACjF,uEAAsE;AAA7D,8HAAA,qBAAqB,OAAA;AAC9B,iFAAiF;AACjF,qCAA2D;AAAlD,0GAAA,eAAe,OAAA;AAAE,wGAAA,aAAa,OAAA;AAWvC,iFAAiF;AACjF,6CAA+D;AAAtD,yGAAA,UAAU,OAAA;AAAE,iHAAA,kBAAkB,OAAA;AAiBvC,iCAAwC;AAA/B,sGAAA,aAAa,OAAA"}

package/dist/react/EmailVerificationCard.d.ts

@@ -0,0 +1,18 @@
+import type { Auth } from "../auth";
+export interface EmailVerificationCardProps {
+    /** Instance of the Clefbase Auth service. */
+    auth: Auth;
+    /** Optional callback after a successful verification check. */
+    onVerified?: () => void;
+    /** Optional callback when the verification email is successfully sent. */
+    onSent?: () => void;
+    /** Optional callback when an error occurs. */
+    onError?: (err: Error) => void;
+    /** Allows customizing the wording shown on the card. */
+    title?: string;
+    description?: string;
+    buttonText?: string;
+    resendText?: string;
+}
+export declare function EmailVerificationCard({ auth, onVerified, onSent, onError, title, description, buttonText, resendText, }: EmailVerificationCardProps): import("react/jsx-runtime").JSX.Element | null;
+//# sourceMappingURL=EmailVerificationCard.d.ts.map

package/dist/react/EmailVerificationCard.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EmailVerificationCard.d.ts","sourceRoot":"","sources":["../../src/react/EmailVerificationCard.tsx"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAEpC,MAAM,WAAW,0BAA0B;IACzC,6CAA6C;IAC7C,IAAI,EAAE,IAAI,CAAC;IACX,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,IAAI,CAAC;IACxB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,MAAM,IAAI,CAAC;IACpB,8CAA8C;IAC9C,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,KAAK,KAAK,IAAI,CAAC;IAC/B,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,wBAAgB,qBAAqB,CAAC,EACpC,IAAI,EACJ,UAAU,EACV,MAAM,EACN,OAAO,EACP,KAA2B,EAC3B,WAA2E,EAC3E,UAAwC,EACxC,UAAsF,GACvF,EAAE,0BAA0B,kDAwE5B"}

package/dist/react/EmailVerificationCard.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailVerificationCard = EmailVerificationCard;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("react");
+function EmailVerificationCard({ auth, onVerified, onSent, onError, title = "Verify your email", description = "Please verify your email address to continue using the app.", buttonText = "Resend verification email", resendText = "If you already verified, click the button again to refresh your status.", }) {
+    const [user, setUser] = (0, react_1.useState)(auth.currentUser);
+    const [status, setStatus] = (0, react_1.useState)("idle");
+    const [error, setError] = (0, react_1.useState)(null);
+    (0, react_1.useEffect)(() => {
+        const unsub = auth.onAuthStateChanged((u) => {
+            setUser(u);
+            if (u && u.emailVerified) {
+                onVerified?.();
+            }
+        });
+        return unsub;
+    }, [auth, onVerified]);
+    const disabled = (0, react_1.useMemo)(() => status === "sending" || !user, [status, user]);
+    if (!user || user.emailVerified)
+        return null;
+    const handleSend = async () => {
+        setStatus("sending");
+        setError(null);
+        try {
+            await auth.sendEmailVerification();
+            setStatus("sent");
+            onSent?.();
+        }
+        catch (err) {
+            const message = err?.message ?? "Failed to send verification email.";
+            setError(message);
+            setStatus("error");
+            onError?.(err);
+        }
+    };
+    return ((0, jsx_runtime_1.jsx)("div", { style: { border: "1px solid rgba(148, 163, 184, 0.4)", borderRadius: 12, padding: 18, background: "rgba(255, 255, 255, 0.9)", boxShadow: "0 12px 28px rgba(15, 23, 42, 0.08)" }, children: (0, jsx_runtime_1.jsxs)("div", { style: { display: "flex", flexDirection: "column", gap: 8 }, children: [(0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("h3", { style: { margin: 0, fontSize: 18, fontWeight: 600, color: "#0f172a" }, children: title }), (0, jsx_runtime_1.jsx)("p", { style: { margin: "6px 0 0", fontSize: 13, color: "#334155" }, children: description })] }), (0, jsx_runtime_1.jsx)("button", { type: "button", onClick: handleSend, disabled: disabled, style: {
+                        appearance: "none",
+                        border: "none",
+                        borderRadius: 10,
+                        padding: "10px 14px",
+                        fontSize: 13,
+                        fontWeight: 600,
+                        color: "#fff",
+                        background: "linear-gradient(90deg, #2563eb, #14b8a6)",
+                        cursor: disabled ? "not-allowed" : "pointer",
+                        opacity: disabled ? 0.6 : 1,
+                    }, children: status === "sending" ? "Sending…" : buttonText }), status === "sent" && ((0, jsx_runtime_1.jsx)("p", { style: { margin: 0, fontSize: 12, color: "#16a34a" }, children: "Verification email sent. Please check your inbox." })), status === "error" && error && ((0, jsx_runtime_1.jsx)("p", { style: { margin: 0, fontSize: 12, color: "#b91c1c" }, children: error })), (0, jsx_runtime_1.jsx)("p", { style: { margin: 0, fontSize: 12, color: "#64748b" }, children: resendText })] }) }));
+}
+//# sourceMappingURL=EmailVerificationCard.js.map

package/dist/react/EmailVerificationCard.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "clefbase",
-  "version": "1.3.7",
+  "version": "1.3.9",
   "description": "Firebase-style SDK and CLI for Clefbase — database, auth, storage, and hosting",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -17,6 +17,11 @@
       "require": "./dist/react/StorageImage.js",
       "import": "./dist/react/StorageImage.js",
       "types": "./dist/react/StorageImage.d.ts"
+    },
+    "./react/EmailVerificationCard": {
+      "require": "./dist/react/EmailVerificationCard.js",
+      "import": "./dist/react/EmailVerificationCard.js",
+      "types": "./dist/react/EmailVerificationCard.d.ts"
     }
   },
   "files": [