Helpers#

import { hashPassword, verifyPassword } from "@buntok/core/helpers";

// Hash
const hash = await hashPassword("my-password");

// Verify
const isValid = await verifyPassword("my-password", hash);

import {
  parseTime, formatInTimezone, toTimezoneParts,
  nowInTimezone, getTimezoneOffset, getTimezoneOffsetString, isValidTimezone,
  groupByTimezone, getGroupLabels, formatGroupLabel, toISOWithTimezone,
} from "@buntok/core/helpers";

const date = parseTime("14:30", "Asia/Jakarta");
const formatted = formatInTimezone(new Date(), "Asia/Jakarta", "short"); // "short"|"default"|"full"
const offset = getTimezoneOffset("Asia/Jakarta"); // -420 (UTC+7, negative = ahead)
const offsetStr = getTimezoneOffsetString("Asia/Jakarta"); // "+07:00"
isValidTimezone("Asia/Jakarta"); // true
// Group: groupByTimezone(items, "createdAt", "Asia/Jakarta", "day") // GroupByKey "hour"|"day"|"month"|"year"
toISOWithTimezone(new Date(), "Asia/Jakarta"); // "2024-01-15T17:30:00+07:00"

import { delay, retry } from "@buntok/core/helpers";

// Promise-based sleep
await delay(1000); // 1 second

// Retry with exponential backoff
const data = await retry(
  () => fetch("https://api.example.com/data").then(r => r.json()),
  { retries: 3, delay: 1000, backoff: "exponential" }
);

// Retry with custom error filter
await retry(
  () => db.query("SELECT ..."),
  {
    retries: 5,
    delay: 500,
    backoff: "fixed",
    onError: (err, attempt) => {
      // Only retry on connection errors
      return err instanceof ConnectionError;
    },
  }
);

import { asyncHandler, NotFoundError } from "@buntok/core/helpers";

app.get("/users/:id", asyncHandler(async (ctx) => {
  const user = await findUser(ctx.params.id);
  if (!user) throw new NotFoundError("User not found");
  return ctx.json(user);
}));

import { handleUploads, LocalDiskStorage } from "@buntok/core/upload";

const result = await handleUploads(ctx, {
  storage: new LocalDiskStorage("./uploads"),
  maxFileSize: 5 * 1024 * 1024,
  fields: {
    avatar: { required: true, allowedMimeTypes: ["image/png"] },
  },
});

result.fields.avatar // UploadedFile | ImageUploadedFile (if outputFormat set)
result.files         // (UploadedFile | ImageUploadedFile)[]

import { hash, sha256, md5, randomHex, randomToken, encrypt, decrypt } from "@buntok/core/helpers";

// hash/sha256/sha512 are SYNC (Bun.CryptoHasher)
const h = hash("hello world"); // default SHA-256, or hash("data", "SHA-512")
const h2 = sha256("hello world"); // sync
const md5Hash = await md5("hello world"); // async pure JS
const hex = randomHex(16); // "a1b2c3..."
const token = randomToken(); // "dGhpcyBpcyBh..."
const { ciphertext, iv } = await encrypt("secret", key); // AES-256-GCM, iv is hex
const decrypted = await decrypt(ciphertext, key, iv);

import { timeAgo, addDays, formatDuration, startOfDay } from "@buntok/core/helpers";

timeAgo(new Date("2024-01-01")); // "3 months ago"
const tomorrow = addDays(new Date(), 1);
formatDuration(3661); // "1h 1m 1s"
startOfDay(new Date()); // 00:00:00 today

import { slugify, truncate, camelCase, kebabCase } from "@buntok/core/helpers";

slugify("Hello World!"); // "hello-world"
truncate("Long text here", 10); // "Long te..."
camelCase("hello_world"); // "helloWorld"
kebabCase("helloWorld"); // "hello-world"

import { clamp, formatBytes, formatCurrency } from "@buntok/core/helpers";

clamp(15, 0, 10); // 10
formatBytes(1536); // "1.5 KB"
formatCurrency(25000, "IDR"); // "Rp 25.000"

import { pick, omit, groupBy, uniq, deepMerge } from "@buntok/core/helpers";

pick({ a: 1, b: 2, c: 3 }, ["a", "c"]); // { a: 1, c: 3 }
omit({ a: 1, b: 2 }, ["b"]); // { a: 1 }
groupBy([{ type: "a" }, { type: "b" }, { type: "a" }], "type");
// { a: [...], b: [...] }
uniq([1, 2, 2, 3]); // [1, 2, 3]
deepMerge({ a: 1 }, { b: 2 }); // { a: 1, b: 2 }

import { getClientIP, isPrivateIP, parseUserAgent } from "@buntok/core/helpers";

const ip = getClientIP(request);
isPrivateIP("192.168.1.1"); // true
const ua = parseUserAgent(request);
// { browser: "Chrome", os: "Windows", device: "desktop" }

import { setCookie, deleteCookie, getCookie } from "@buntok/core/helpers";

// Set cookie on response
const response = ctx.json({ ok: true });
return setCookie(response, "token", "abc123", {
  httpOnly: true,
  secure: true,
  sameSite: "lax",
  path: "/",
  maxAge: 86400,
});

// Delete cookie
return deleteCookie(response, "token", { path: "/" });

import { nanoid, ulid } from "@buntok/core/helpers";

nanoid(); // "V1StGXR8_Z5jdHi6B-myT"
ulid(); // "01ARZ3NDEKTSV4RRFFQ69G5FAV"
generateCode("ORD"); // "ORD-001"
generateCode("ORD"); // "ORD-002"