hazo_core 1.0.0

package/dist/utils/index.js

@@ -0,0 +1,174 @@
+// uuid v11+ exports v7; uuid v8 does not. At build time uuid@^11.0.0 will be installed.
+// The type assertion avoids the TS2305 error when checked against the wrong installed version.
+import * as uuidPkg from 'uuid';
+const uuidv7 = uuidPkg['v7'];
+export { getCurrentEnv } from './env.js';
+// ---------------------------------------------------------------------------
+// Request ID generation
+// ---------------------------------------------------------------------------
+/**
+ * Generate a new request/correlation ID.
+ * Format: 'req_' + UUID v7 (time-ordered, sortable in logs and DB indexes).
+ * Per D-001 and D-006.
+ */
+export function generateRequestId() {
+    return `req_${uuidv7()}`;
+}
+// ---------------------------------------------------------------------------
+// Dynamic import helper
+// ---------------------------------------------------------------------------
+/**
+ * Attempt a dynamic import of `pkg`. Returns null if the package is not
+ * installed or fails to load for any reason.
+ *
+ * Useful for optional peer dependencies that provide enhanced behavior when
+ * present but are not required.
+ */
+export async function optional_import(pkg) {
+    try {
+        return (await import(pkg));
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// JSON helpers
+// ---------------------------------------------------------------------------
+/**
+ * JSON.parse that returns null instead of throwing on malformed input.
+ */
+export function safeJsonParse(json) {
+    try {
+        return JSON.parse(json);
+    }
+    catch {
+        return null;
+    }
+}
+// ---------------------------------------------------------------------------
+// Async helpers
+// ---------------------------------------------------------------------------
+/**
+ * Promise-based delay. Useful in tests and retry loops.
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+// ---------------------------------------------------------------------------
+// Byte formatting
+// ---------------------------------------------------------------------------
+/**
+ * Format a byte count into a human-readable string.
+ * @example formatBytes(1536) → "1.5 KB"
+ * @example formatBytes(1073741824) → "1 GB"
+ */
+export function formatBytes(bytes, decimals = 2) {
+    if (bytes === 0)
+        return '0 Bytes';
+    const k = 1024;
+    const dm = decimals < 0 ? 0 : decimals;
+    const sizes = ['Bytes', 'KB', 'MB', 'GB', 'TB', 'PB', 'EB', 'ZB', 'YB'];
+    const i = Math.floor(Math.log(bytes) / Math.log(k));
+    const value = parseFloat((bytes / Math.pow(k, i)).toFixed(dm));
+    return `${value} ${sizes[i]}`;
+}
+// ---------------------------------------------------------------------------
+// Multi-format date utilities (format_date, format_date_range, DateFormat)
+// ---------------------------------------------------------------------------
+export { format_date, format_date_range, DEFAULT_DATE_FORMAT, } from './dates.js';
+// ---------------------------------------------------------------------------
+// Date formatters
+// ---------------------------------------------------------------------------
+function toDate(date) {
+    return typeof date === 'string' ? new Date(date) : date;
+}
+/**
+ * Format a date as "28 May 2026"
+ */
+export function formatDateShort(date) {
+    const d = toDate(date);
+    return d.toLocaleDateString('en-AU', {
+        day: 'numeric',
+        month: 'short',
+        year: 'numeric',
+    });
+}
+/**
+ * Format a date as "Wednesday, 28 May 2026"
+ */
+export function formatDateLong(date) {
+    const d = toDate(date);
+    return d.toLocaleDateString('en-AU', {
+        weekday: 'long',
+        day: 'numeric',
+        month: 'long',
+        year: 'numeric',
+    });
+}
+/**
+ * Format a date as "28/05/2026"
+ */
+export function formatDateSlash(date) {
+    const d = toDate(date);
+    const day = String(d.getDate()).padStart(2, '0');
+    const month = String(d.getMonth() + 1).padStart(2, '0');
+    const year = d.getFullYear();
+    return `${day}/${month}/${year}`;
+}
+// ---------------------------------------------------------------------------
+// Number / currency formatters
+// ---------------------------------------------------------------------------
+/**
+ * Format a number as currency.
+ * @example formatCurrency(1234.56) → "$1,234.56"
+ * @example formatCurrency(1234.56, 'GBP') → "£1,234.56"
+ */
+export function formatCurrency(amount, currency = 'AUD') {
+    return new Intl.NumberFormat('en-AU', {
+        style: 'currency',
+        currency,
+        minimumFractionDigits: 2,
+        maximumFractionDigits: 2,
+    }).format(amount);
+}
+/**
+ * Format a number with optional decimal places.
+ * @example formatNumber(1234567.89) → "1,234,567.89"
+ * @example formatNumber(1234567.89, 0) → "1,234,568"
+ */
+export function formatNumber(n, decimals) {
+    return new Intl.NumberFormat('en-AU', {
+        minimumFractionDigits: decimals,
+        maximumFractionDigits: decimals,
+    }).format(n);
+}
+// ---------------------------------------------------------------------------
+// Boolean formatter
+// ---------------------------------------------------------------------------
+/**
+ * Format a boolean as a human-readable string.
+ * @example formatBoolean(true) → "Yes"
+ * @example formatBoolean(false) → "No"
+ */
+export function formatBoolean(val) {
+    return val ? 'Yes' : 'No';
+}
+// ---------------------------------------------------------------------------
+// Name initials
+// ---------------------------------------------------------------------------
+/**
+ * Extract initials from a name.
+ * @example getInitials('John Doe') → 'JD'
+ * @example getInitials('Alice') → 'A'
+ * @example getInitials('Mary Jane Watson') → 'MJW'
+ */
+export function getInitials(name) {
+    return name
+        .trim()
+        .split(/\s+/)
+        .filter((part) => part.length > 0)
+        .map((part) => part[0].toUpperCase())
+        .join('');
+}
+//# sourceMappingURL=index.js.map

package/dist/utils/index.js.map

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

package/package.json

@@ -0,0 +1,82 @@
+{
+  "name": "hazo_core",
+  "version": "1.0.0",
+  "description": "Foundation package for all hazo_* packages — errors, correlation ID, config, logger, debug, singletons, utils",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "node": "./dist/index.js",
+      "default": "./dist/index.client.js"
+    },
+    "./client": {
+      "types": "./dist/index.client.d.ts",
+      "import": "./dist/index.client.js"
+    },
+    "./errors": {
+      "types": "./dist/errors/index.d.ts",
+      "import": "./dist/errors/index.js"
+    },
+    "./context": {
+      "types": "./dist/context/index.d.ts",
+      "import": "./dist/context/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "config",
+    "README.md",
+    "SETUP_CHECKLIST.md"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/pub12/hazo.git"
+  },
+  "keywords": [
+    "hazo",
+    "core",
+    "errors",
+    "correlation-id",
+    "config",
+    "logger"
+  ],
+  "author": "Pubs Abayasiri",
+  "license": "MIT",
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "bugs": {
+    "url": "https://github.com/pub12/hazo/issues"
+  },
+  "homepage": "https://github.com/pub12/hazo/tree/main/hazo_core#readme",
+  "dependencies": {
+    "ini": "^4.1.0",
+    "uuid": "^11.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.2",
+    "vitest": "^4.0.15"
+  },
+  "peerDependencies": {
+    "hazo_debug": "^3.1.0",
+    "hazo_logs": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "hazo_logs": {
+      "optional": true
+    },
+    "hazo_debug": {
+      "optional": true
+    }
+  }
+}