@fullstackunicorn/initialize

A lightweight, zero-dependency utility library for JavaScript/Node.js. It extends global objects with handy helpers: String prototype methods for quick transformations and a F3 namespace for type checks, safe accessors, logging, templating, and error handling. Designed as a side-effect module—just import once at the top of your project to make everything globally available.

Ideal for scripts, apps, or teams wanting concise, crash-proof utilities without imports everywhere.

Features

• Global Extensions: One import unlocks String.prototype.cap(), F3.isArr(value), etc.—no destructuring needed.
• Safe & Concise: Guards against nil/empty values (e.g., F3.arr.safe(arr) returns [] if invalid).
• Type Guards: Fast checks for arrays, objects, strings, etc., with F3.typeOf(value).
• Logging Utils: Flexible console helpers like F3.logs(...args), F3.log.obj(obj, ...rest), and catch-specific loggers.
• String & Object Helpers: URL fabrication, templating, JSON-safe stringifying (handles circular refs).
• Error Handling: Quick catch wrappers like F3.catch.res(first, ...logs) for graceful returns.
• No Dependencies: Pure JS (Node 14+; works in browsers via globalThis).

Installation

npm install @fullstackunicorn/initialize

yarn add @fullstackunicorn/initialize

Quick Start

Add at the top of your entry file (side-effect import—runs once):

import '@fullstackunicorn/initialize';  // Now globals are extended!

// String prototypes
console.log('hello'.cap());  // "Hello"
console.log('world!'.cut(1));  // "world"

// F3 type checks
console.log(F3.isArr([]));  // true
console.log(F3.isNil(null));  // true

// Safe accessors
const safeObj = F3.obj.safe({});  // {}
console.log(F3.arr.safe('not an array'));  // []

// Logging
F3.logs('Quick log:', 42);
F3.log.obj({ user: 'Alice', age: 30 }, 'Optional prefix');  // Verbose with separator

// Catch helper
try {
  // ... risky code ...
} catch (err) {
  return F3.catch.res(null, 'Handled error:', err.message);  // Logs extras, returns null
}

API Reference

String Prototype Extensions

These add methods directly to String.prototype for chainable ops.

F3 Basics (Core Type Guards)

Global F3 namespace for common checks.

F3.str (String Helpers)

F3.arr (Array Helpers)

F3.obj (Object Helpers)

F3.res (Result Validation)

F3 Utilities

F3.logs (Simple Logging)

F3.log (Structured Logging)

F3.err (Error Status Checks)

F3.catch (Error Handling)

Notes:

• All methods are pure functions (no side-effects except logging).
• Globals persist after import—use in any scope.
• Logging handles circular references gracefully (e.g., [Error serializing value] fallback).
• For strict mode, wrap in IIFE if needed.

Examples

Type-Safe Array Processing

import '@fullstackunicorn/initialize';

function processUsers(users) {
  const safeUsers = F3.arr.safe(users);
  if (!F3.arr.isGood(safeUsers)) return [];
  
  return safeUsers.map(user => ({
    name: F3.obj.safe(user).name.low(),
    isValid: F3.res.isGood(user)
  }));
}

Templated Logging

import '@fullstackunicorn/initialize';

const template = F3.replacer('Hello {{name}}! Age: {{age}}', { name: 'Alice', age: 30 });
F3.logs(template);  // "Hello Alice! Age: 30"

const apiUrl = F3.fabUrl('/users/:id', { id: 123 });
F3.log.arr('Fetching:', apiUrl);  // "/users/123"

Error Handling in Async

import '@fullstackunicorn/initialize';

async function fetchData() {
  try {
    // ... API call ...
    return data;
  } catch (err) {
    F3.log.obj({ error: err.message, status: err.status }, 'API Error');
    return F3.catch.res(null, 'Handled error details');
  }
}

Contributing

Fork the repo, add features/tests, and submit a PR. Focus on safe, concise utils!

License

MIT © fullstackunicorn.dev/author/lucanigido another little change