@a2zb/lib 1.0.0

package/dist/fmt/hex.d.ts

@@ -0,0 +1,3 @@
+export type Hex = `0x${string}`;
+export declare const truncateHex: (hex: Hex) => string;
+export declare const addrShort: (hex: Hex) => string;

package/dist/fmt/hex.js

@@ -0,0 +1,2 @@
+export const truncateHex = (hex) => `${hex.slice(0, 4)}…${hex.slice(-4)}`;
+export const addrShort = truncateHex;

package/dist/fmt/image.d.ts

@@ -0,0 +1,2 @@
+export declare const resolveImage: (src: string) => Promise<string>;
+export declare const getImageFromTokenURI: (tokenUri: string) => string;

package/dist/fmt/image.js

@@ -0,0 +1,27 @@
+const isSvg = (src) => {
+    return !!src && src.startsWith('data:image/svg');
+};
+const inlineSvgToBlobUrl = (src) => {
+    // removes prefix so we only have raw  <svg ...>
+    const svg = src.replace('data:image/svg+xml;utf8,', '');
+    const blob = new Blob([svg], { type: 'image/svg+xml' });
+    return URL.createObjectURL(blob);
+};
+export const resolveImage = async (src) => {
+    if (!src)
+        return '';
+    // ONLY convert inline SVGs
+    if (isSvg(src))
+        return inlineSvgToBlobUrl(src);
+    // EVERYTHING ELSE: DO NOT FETCH
+    return src;
+};
+export const getImageFromTokenURI = (tokenUri) => {
+    // remove: data:application/json;base64,
+    const base64 = tokenUri.split(',')[1];
+    // decode base64 → json string
+    const json = atob(base64);
+    // parse json
+    const metadata = JSON.parse(json);
+    return metadata.image;
+};

package/dist/fmt/string.d.ts

@@ -0,0 +1,2 @@
+export declare const capitalize: (s: string) => string;
+export declare const capitalizeWords: (s: string) => string;

package/dist/fmt/string.js

@@ -0,0 +1,5 @@
+export const capitalize = (s) => s.charAt(0).toUpperCase() + s.slice(1);
+export const capitalizeWords = (s) => s
+    .split(' ')
+    .map(w => capitalize(w))
+    .join(' ');

package/dist/fmt/time.d.ts

@@ -0,0 +1,9 @@
+export declare const months: string[];
+export type TimeUnit = "hour" | "day" | "month" | "week";
+export declare const tsShort: (ts: number) => string;
+export declare const tsSuperShort: (ts: number) => string;
+export declare const tsLong: (ts: number) => string;
+export declare const tsMonthNameUTC: (ts: number) => string;
+export declare const hhmm: (ts: number) => string;
+export declare const timeAgo: (ts: number) => string;
+export declare const timeKey: (ts: number, unit: "hour" | "day" | "month" | "week") => string | undefined;

package/dist/fmt/time.js

@@ -0,0 +1,72 @@
+export const months = [
+    "January",
+    "February",
+    "March",
+    "April",
+    "May",
+    "June",
+    "July",
+    "August",
+    "September",
+    "October",
+    "November",
+    "December",
+];
+export const tsShort = (ts) => {
+    const p = parts(ts);
+    return `${p.month} ${p.day} ${p.time}`;
+};
+export const tsSuperShort = (ts) => {
+    const p = parts(ts);
+    return `${p.month} ${p.day}`;
+};
+export const tsLong = (ts) => {
+    const p = parts(ts);
+    return `${p.yy}.${p.mm}.${p.dd} ${p.hh}:${p.min}`;
+};
+export const tsMonthNameUTC = (ts) => months[new Date(ts).getUTCMonth()];
+export const hhmm = (ts) => {
+    return new Date(ts).toLocaleTimeString([], {
+        hour: "2-digit",
+        minute: "2-digit",
+        hour12: false,
+    });
+};
+const parts = (ts) => {
+    const d = new Date(ts);
+    return {
+        month: d.toLocaleString("en-US", { month: "short" }),
+        day: String(d.getDate()).padStart(2, "0"),
+        yy: String(d.getUTCFullYear()).slice(-2),
+        mm: String(d.getUTCMonth() + 1).padStart(2, "0"),
+        dd: String(d.getUTCDate()).padStart(2, "0"),
+        hh: String(d.getUTCHours()).padStart(2, "0"),
+        min: String(d.getUTCMinutes()).padStart(2, "0"),
+        time: d.toTimeString().slice(0, 5),
+    };
+};
+export const timeAgo = (ts) => {
+    const secs = Math.floor((Date.now() - ts) / 1000);
+    if (secs < 60)
+        return "just now";
+    const mins = Math.floor(secs / 60);
+    if (mins < 60)
+        return `${mins} min ago`;
+    const hours = Math.floor(mins / 60);
+    if (hours < 24)
+        return `${hours} hr ago`;
+    const days = Math.floor(hours / 24);
+    return `${days} day${days === 1 ? "" : "s"} ago`;
+};
+// never used for UI display only for charts => always UTC
+export const timeKey = (ts, unit) => {
+    const d = new Date(ts);
+    switch (unit) {
+        case "hour":
+            return d.toISOString().slice(0, 13); // 2026-01-16T05
+        case "day":
+            return d.toISOString().slice(0, 10); // 2026-01-16
+        case "month":
+            return `${d.getUTCFullYear()}-${d.getUTCMonth()}`;
+    }
+};

package/dist/http/page.d.ts

@@ -0,0 +1,4 @@
+export type Page<T> = {
+    items: T[];
+    cursor: string | null;
+};

package/dist/http/page.js

@@ -0,0 +1 @@
+export {};

package/dist/http/result.d.ts

@@ -0,0 +1,8 @@
+export type Result<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: string;
+};
+export declare const unwrap: <T>(r: Result<T>) => T;

package/dist/http/result.js

@@ -0,0 +1,5 @@
+export const unwrap = (r) => {
+    if (!r.ok)
+        throw new Error(r.error);
+    return r.data;
+};

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from './fmt/hex';
+export * from './fmt/image';
+export * from './fmt/string';
+export * from './fmt/time';
+export * from './http/page';
+export * from './http/result';

package/dist/index.js

@@ -0,0 +1,6 @@
+export * from './fmt/hex';
+export * from './fmt/image';
+export * from './fmt/string';
+export * from './fmt/time';
+export * from './http/page';
+export * from './http/result';

package/package.json

@@ -0,0 +1,13 @@
+{
+  "name": "@a2zb/lib",
+  "version": "1.0.0",
+  "type": "module",
+  "files": [
+    "dist"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "scripts": {
+    "build": "tsc"
+  }
+}