bedazzlejs

📦 BedazzleJS

A tiny functional way to decorate objects with composable behaviors.

TL;DR

BedazzleJS lets you progressively add methods and properties to objects using pure functions — no classes, no heavy frameworks.

What is BedazzleJS?

BedazzleJS is a tiny library (less than 1KB) that helps you compose objects from multiple behaviors without needing class hierarchies, mutation, or complexity.

Instead of rigid blueprints (like classes), you add behaviors one step at a time with small, reusable functions.

Why BedazzleJS?

• ✅ No class inheritance mess
• ✅ No framework lock-in
• ✅ Predictable, pure functions
• ✅ Easy to extend, compose, and test
• ✅ Perfect for plugins, middleware, or micro-frameworks

Installation

npm install bedazzlejs

or

pnpm add bedazzlejs

Usage

import { bedazzle } from 'bedazzlejs';

const withWheels = obj => ({
  roll: () => console.log(`Rolling with ${obj.wheels} wheels!`)
});

const withHorn = obj => ({
  honk: () => console.log('Beep beep!')
});

const vehicle = bedazzle({ wheels: 4 }, withWheels, withHorn);

vehicle.roll(); // Rolling with 4 wheels!
vehicle.honk(); // Beep beep!

You can easily add more decorators without changing the original object structure.

API

bedazzle(state, ...fns)

Parameter	Type	Description
state	Object	The base object to decorate
...fns	Function[]	Functions that receive the object and return partial objects to merge

Each function gets the current object and can return new properties, methods, or even call next() to continue decorating recursively.

Real-World Ideas

• Add "plugins" dynamically to a system
• Compose UI components without classes
• Create flexible middleware chains
• Design small, testable interfaces
• Create evolving APIs or objects at runtime

How is this Different?

	Classes	Factory Functions	BedazzleJS
Extendability	Medium (inheritance)	Medium (closures)	High (pure functions)
Testability	Medium	High	Very High
Complexity	Higher over time	Moderate	Very Low

BedazzleJS gives you the freedom of factories with the simplicity of pure functions.

License

MIT © Brad Mehder

Contributing

Pull requests, issues, and ideas are welcome!

• Fork the repo
• Create a feature branch
• Submit a pull request 🚀