@synstack/enhance

@synstack/enhance

Type-safe object enhancement with proxy-based method extension

What is it for?

Sometimes you need to add functionality to existing objects without modifying their prototype or breaking equality checks. This package provides a safe way to enhance objects with new methods while maintaining type safety:

import { enhance } from "@synstack/enhance";

// Create an extension with new methods
const objExtensions = {
  stringify: function () {
    return JSON.stringify(this);
  },
  clone: function () {
    return { ...this };
  },
};

// Enhance an object with new methods
const obj = { name: "example", value: 42 };
const enhanced = enhance("object", obj, objExtensions);

// Use the enhanced object
console.log(enhanced.stringify()); // '{"name":"example","value":42}'
console.log(enhanced.clone()); // { name: "example", value: 42 }

// Access the original object
console.log(enhanced.$()); // { name: "example", value: 42 }

Installation

# Using npm
npm install @synstack/enhance

# Using yarn
yarn add @synstack/enhance

# Using pnpm
pnpm add @synstack/enhance

Features

Object Enhancement

The package provides two main functions for enhancing objects:

enhance()

The enhance() function combines an object with extension methods:

import { enhance } from "@synstack/enhance";

// Define extension methods
const loggerExtensions = {
  log: function () {
    console.log(JSON.stringify(this));
  },
  getTimestamp: function () {
    return { ...this, timestamp: Date.now() };
  },
};

// Enhance an object
const data = { id: 1, message: "Hello" };
const enhanced = enhance("logger", data, loggerExtensions);

// Use enhanced methods
enhanced.log(); // Logs: {"id":1,"message":"Hello"}
const timestamped = enhanced.getTimestamp(); // { id: 1, message: "Hello", timestamp: 1234567890 }

enhanceFactory()

Create reusable enhancers with enhanceFactory():

import { enhanceFactory } from "@synstack/enhance";

// Create a reusable enhancer
const withLogging = enhanceFactory("logger", {
  log: function () {
    console.log(JSON.stringify(this));
  },
  getTimestamp: function () {
    return { ...this, timestamp: Date.now() };
  },
});

// Enhance multiple objects
const obj1 = withLogging({ id: 1, name: "First" });
const obj2 = withLogging({ id: 2, name: "Second" });

obj1.log(); // Logs: {"id":1,"name":"First"}
obj2.log(); // Logs: {"id":2,"name":"Second"}