Breacher API Documentation

// Direct fetch() API (No client class needed)
const BASE = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db";

// 1. User Registration: POST /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/register
const regRes = await fetch(`${BASE}/auth/register`, {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    email: "user@example.com",
    password: "SecurePassword123!",
    name: "Alex Doe"
  })
});
const regData = await regRes.json();
console.log("Registered:", regData);

// 2. User Login: POST /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/login
const loginRes = await fetch(`${BASE}/auth/login`, {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    email: "user@example.com",
    password: "SecurePassword123!"
  })
});
const loginData = await loginRes.json();
console.log("Logged in session:", loginData);

// POST /U6op8Nr462Z46tBgxa2COUnja5z1/mail -> Direct fetch to Sockets Gmail SMTP
const res = await fetch("https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/mail", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    to: "customer@example.com",
    subject: "Order Confirmation #4092",
    from: "orders@myapp.com",
    aliasName: "Acme Store",
    preview: "Thank you for your purchase!",
    html: "<div style='font-family:sans-serif;'><h1>Thank you!</h1><p>Your order is confirmed.</p></div>"
  })
});
const data = await res.json();
console.log(data);

// Run once when setting up a new database (POST /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/init)
const res = await fetch("https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/init", {
  method: "POST"
});
const data = await res.json();
console.log(data);

const BASE = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db";

// 1. Create Document (PUT /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/:path)
await fetch(`${BASE}/products/item_99`, {
  method: "PUT",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ title: "Mechanical Keyboard", price: 149.99 })
});

// 2. Read Document (GET /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/:path)
const readRes = await fetch(`${BASE}/products/item_99`);
const product = await readRes.json();
console.log("Product:", product);

// 3. Partial Update (PATCH /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/:path)
await fetch(`${BASE}/products/item_99`, {
  method: "PATCH",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ price: 129.99 })
});

const BASE = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db";

// 1. Delete a single document / file (DELETE /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/:path)
const fileRes = await fetch(`${BASE}/users/usr_101`, { method: "DELETE" });
const fileData = await fileRes.json();
console.log(fileData);

// 2. Delete an entire folder recursively (DELETE /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/:folder?type=folder)
const folderRes = await fetch(`${BASE}/logs/archive?type=folder`, { method: "DELETE" });
const folderData = await folderRes.json();
console.log(`Deleted ${folderData.deletedCount} items:`, folderData.deletedPaths);

// 3. Delete a media asset (DELETE /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/media/:path)
await fetch(`${BASE}/media/uploads/photo.jpg`, { method: "DELETE" });

// Query Collection (GET /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/:collection?sort=field:dir&limit=N)
const res = await fetch("https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/messages?sort=createdAt:desc&limit=25");
const data = await res.json();
console.log(`Found ${data.count} documents:`, data.documents);

// 1. READ: Listen to a Collection (Folder) stream
const streamUrl = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/stream/messages";
const eventSource = new EventSource(streamUrl, { withCredentials: true });

eventSource.onmessage = (event) => {
  // When listening to a folder, the payload is an array of documents
  const data = JSON.parse(event.data);
  console.log("Live collection update. Total docs:", data.length);
  // Example data: [{ _id: "msg_1", text: "Hello", ... }, ...]
};

// 2. WRITE: Trigger a stream update by writing to the folder
// Just use standard HTTP POST/PUT/PATCH to the regular path (without /stream/)
async function sendMessage(text) {
  const docId = "msg_" + Date.now();
  await fetch(`https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/messages/${docId}`, {
    method: "PUT",
    headers: { "Content-Type": "application/json" },
    body: JSON.stringify({ 
      text: text,           // "text" is a field
      sender: "Alice",      // "sender" is a field
      createdAt: new Date().toISOString() 
    })
  });
  // The SSE eventSource above will instantly receive the updated array!
}

// Send a test message
sendMessage("Hello from Realtime Stream!");

// To stop listening:
// eventSource.close();

// 1. Upload File (POST /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/media/:path)
const fileInput = document.querySelector('input[type="file"]');
const file = fileInput.files[0];

const uploadPath = "uploads/" + Date.now() + "_" + file.name;
await fetch(`https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/media/${uploadPath}`, {
  method: "POST",
  headers: { "Content-Type": file.type || "application/octet-stream" },
  body: file
});

// 2. Direct Public Embed URL (GET /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/media/:path)
const mediaUrl = `https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/media/${uploadPath}`;
console.log("Media URL:", mediaUrl);

// 3. Delete Media Asset (DELETE /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/media/:path)
await fetch(mediaUrl, { method: "DELETE" });

// Direct fetch calls sending actual HTTP requests to the worker endpoints
const BASE_AUTH = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth";

// 1. REGISTER -> POST https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth/register
const regRes = await fetch(`${BASE_AUTH}/register`, {
  method: "POST",
  credentials: "include", // CRITICAL for receiving session cookie
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    email: "alice@example.com",
    password: "SecurePassword123!",
    name: "Alice Developer"
  })
});
const regData = await regRes.json();
console.log("Registered user:", regData.user);

// 2. LOGIN -> POST https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth/login
const loginRes = await fetch(`${BASE_AUTH}/login`, {
  method: "POST",
  credentials: "include", // Saves the HttpOnly session cookie in the browser
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    email: "alice@example.com",
    password: "SecurePassword123!"
  })
});
const loginData = await loginRes.json();
console.log("Logged in user:", loginData.user);

// 3. LOGOUT -> POST https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth/logout
await fetch(`${BASE_AUTH}/logout`, {
  method: "POST",
  credentials: "include"
});

const BASE_AUTH = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth";

// 1. Get Current User Profile (GET /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/me)
const meRes = await fetch(`${BASE_AUTH}/me`, { credentials: "include" });
if (meRes.ok) {
  const { user } = await meRes.json();
  console.log("Logged in as:", user);
}

// 2. Update Profile Name (PATCH /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/me)
await fetch(`${BASE_AUTH}/me`, {
  method: "PATCH",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ name: "Alice Wonderland" })
});

// 3. Delete Account Permanently (DELETE /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/me)
await fetch(`${BASE_AUTH}/me`, { method: "DELETE", credentials: "include" });

const BASE_AUTH = "https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth";

// 1. Change Password (POST /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/password)
await fetch(`${BASE_AUTH}/password`, {
  method: "POST",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    oldPassword: "OldPassword123!",
    newPassword: "NewStrongPassword456!"
  })
});

// 2. Change Email Address (PATCH /U6op8Nr462Z46tBgxa2COUnja5z1/app-db/auth/email)
await fetch(`${BASE_AUTH}/email`, {
  method: "PATCH",
  credentials: "include",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({
    newEmail: "new.email@example.com",
    password: "CurrentPassword123!"
  })
});

const res = await fetch("https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth/forgot-password", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ email: "user@example.com" })
});
const data = await res.json();
console.log(data.message);

// 1. Fetch GitHub Authorization URL
const resUrl = await fetch("https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth/github/url");
const { url } = await resUrl.json();

// 2. Redirect user to GitHub consent screen
window.location.href = url;

// 3. In your callback handler after redirect with ?code=XYZ:
const code = new URLSearchParams(window.location.search).get('code');
const loginRes = await fetch("https://storage.breacher.name.ng/U6op8Nr462Z46tBgxa2COUnja5z1/my-app-db/auth/github/callback", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ code })
});
const { user, isNew } = await loginRes.json();
console.log(isNew ? "Signed up!" : "Logged in!", user);