npm package discovery and stats viewer.

Discover Tips

  • General search

    [free text search, go nuts!]

  • Package details

    pkg:[package-name]

  • User packages

    @[username]

Sponsor

Optimize Toolset

I’ve always been into building performant and accessible sites, but lately I’ve been taking it extremely seriously. So much so that I’ve been building a tool to help me optimize and monitor the sites that I build to make sure that I’m making an attempt to offer the best experience to those who visit them. If you’re into performant, accessible and SEO friendly sites, you might like it too! You can check it out at Optimize Toolset.

About

Hi, 👋, I’m Ryan Hefner  and I built this site for me, and you! The goal of this site was to provide an easy way for me to check the stats on my npm packages, both for prioritizing issues and updates, and to give me a little kick in the pants to keep up on stuff.

As I was building it, I realized that I was actually using the tool to build the tool, and figured I might as well put this out there and hopefully others will find it to be a fast and useful way to search and browse npm packages as I have.

If you’re interested in other things I’m working on, follow me on Twitter or check out the open source projects I’ve been publishing on GitHub.

I am also working on a Twitter bot for this site to tweet the most popular, newest, random packages from npm. Please follow that account now and it will start sending out packages soon–ish.

Open Software & Tools

This site wouldn’t be possible without the immense generosity and tireless efforts from the people who make contributions to the world and share their work via open source initiatives. Thank you 🙏

© 2024 – Pkg Stats / Ryan Hefner

decor-res

v1.0.0

Published

DecorRes is an innovative TypeScript framework designed to empower developers with a fully decorator-based architecture for resource management. By blending the concepts of decorators and resource-oriented design, DecorRes enables the creation of modular,

Downloads

15

Readme

DecorRes

DecorRes is an innovative TypeScript framework that empowers developers to build applications with a fully decorator-based architecture for efficient resource management. By combining the power of decorators with a resource-oriented design, DecorRes enhances code clarity, modularity, and maintainability, making it the ideal choice for modern application development.

Table of Contents

🚀 Key Features

  • Decorator-Driven Resource Management: Use decorators to intuitively define and manage resources, resulting in cleaner, more expressive code.
  • Modular Architecture: Treat every component as a resource, promoting reusability and better organization of application logic.
  • Extensible Framework: Effortlessly extend core functionalities by adding custom field types, decorators, and plugins tailored to specific project needs.
  • Customizable Field Types: Support for various built-in field types (such as number, dropdown, selectResource) that can be customized with specific properties for flexible data handling.
  • Type Safety: Developed with TypeScript, ensuring robust type-checking for a reliable foundation for scalable applications.
  • Intuitive API: Enjoy a developer-friendly API that leverages TypeScript features for smooth auto-completion and type hints.
  • Dynamic Ecosystem: Easily adapt to evolving project requirements by integrating external decorators and features, allowing for a responsive and flexible development environment.

⚙️ Getting Started

To begin using DecorRes, follow these steps:

1. Prerequisites

Make sure you have the following installed on your machine:

  • Node.js (version 14 or higher)
  • npm (Node Package Manager)

2. 🛠️ Install Required Packages

To set up DecorRes, you'll need to install the necessary packages. Run the following command:

npm install decor-res reflect-metadata
# or
yarn add decor-res reflect-metadata

Also, install the necessary TypeScript dev dependencies:

npm install --save-dev typescript @types/node # or yarn add -D typescript @types/node

3. TypeScript Configuration

Create a tsconfig.json file in your project root with the following configuration:

{
    "compilerOptions": {
      "esModuleInterop": true,
      "forceConsistentCasingInFileNames": true,
      "target": "es6",                          // Use ES6 or higher
      "module": "commonjs",                     // Use commonjs module system
      "experimentalDecorators": true,           // Enable experimental support for decorators
      "emitDecoratorMetadata": true,             // Enable emitting design:type metadata
      "strict": true,                            // Enable all strict type checking options
      "skipLibCheck": true                       // Skip type checking of declaration files
    },
    "include": ["src/**/*"],
    "exclude": ["node_modules"]
}

4. Import reflect-metadata

In your entry file (usually index.ts or app.ts), ensure that you import reflect-metadata at the very top of the file. This is required to enable metadata reflection for decorators.

import 'reflect-metadata';

📚 Documentation

Resources

  • Resources are the foundation of DecorRes. Use the @Resource decorator to define any logical entity (models, components, etc.).
  • Fields: Add fields to your resources using the @Field decorator, specifying field types and options.

Built-In Field Types

  • number: Simple number field.
  • string: Simple string field;
  • boolean: Simple boolean field;
  • symbol : Simple symbol field;
  • switch : Can be a number of a boolean;
  • checkbox: Can be a number of a boolean;

Once you have installed the necessary packages and set up TypeScript, you can start defining resources and fields using DecorRes decorators.

Basic Example

import 'reflect-metadata';
import { Resource, Field } from 'decor-res';

@Resource()
class User {
    @Field({ type: 'string' })
    name: string;

    @Field({ type: 'number' })
    age: number;

    @Field({ type: 'email' })
    email: string;
}

Examples

Defining Custom Field Types

@Field({ type: 'dropdown', options: ['Admin', 'User', 'Guest'] })
role: string;

@Field({ type: 'selectResource', resourceName: 'Product' })
favoriteProduct: string;

Creating Extensible Decorators

You can easily create and register new decorators to extend the functionality of your resources.

function CustomField(options: { customProp: string }) {
    return function (target: any, propertyKey: string) {
        // Custom decorator logic
        Reflect.defineMetadata('customProp', options.customProp, target, propertyKey);
    };
}

Advanced Examples

🔄 Extending the Framework

DecorRes is designed for flexibility. You can add your own custom field types or extend existing ones with full TypeScript support.

Extending Field Types

You can easily extend the field types available in DecorRes by creating custom decorators. To extend field types and register custom options (e.g., a rating field), use TypeScript's declaration merging.

function ExtendedField(type: string, options: any) {
    return function (target: any, propertyKey: string) {
        Reflect.defineMetadata('design:type', type, target, propertyKey);
        Reflect.defineMetadata('field:options', options, target, propertyKey);
    };
}

// Define a new field type for a color picker
@ExtendedField('colorPicker', { defaultColor: '#000000' })
color: string;

This allows DecorRes to recognize new custom field types, complete with IntelliSense support.

Adding New Resources

You can create new resources and leverage the existing decorators for rich resource definitions.

@Resource()
class Product {
    @Field({ type: 'string' })
    productName: string;

    @Field({ type: 'number' })
    price: number;

    @Field({ type: 'string', options: { enum: ['In Stock', 'Out of Stock'] } })
    availability: string;
}

Custom Decorator for Advanced Logic

You can also create custom decorators that implement advanced logic, such as validation or transformation.

function IsPositive(target: any, propertyKey: string) {
    const value = target[propertyKey];
    if (value < 0) {
        throw new Error(`${propertyKey} must be a positive number.`);
    }
}

@Resource()
class Order {
    @Field({ type: 'number' })
    @IsPositive
    totalAmount: number;

    @Field({ type: 'string' })
    customerName: string;
}

Using Extended Field Types

Here’s how you can use the newly defined field types in a resource:

@Resource()
class EnhancedUser {
    @Field({ type: 'string' })
    name: string;

    @ExtendedField('colorPicker', { defaultColor: '#FF0000' })
    favoriteColor: string;
}

🔌 Plugins & Extensions

DecorRes can be extended with plugins and custom modules. Define new decorators, extend resource behavior, and add complex validation logic as needed.

Example: Custom Decorator Plugin

import { Resource, Field, customDecorator } from 'decor-res';

function LogField() {
  return customDecorator((target, key) => {
    console.log(`Field '${key}' has been initialized.`);
  });
}

@Resource
class Product {
  @LogField()
  @Field({ type: "number" })
  price: number;
}

🧩 Contributing

We welcome contributions to DecorRes! If you'd like to submit a feature request, report a bug, or contribute code, please follow these steps:

  1. Fork the repository.
  2. Create a new branch (git checkout -b feature/YourFeature).
  3. Make your changes and commit them (git commit -m 'Add some feature').
  4. Push to the branch (git push origin feature/YourFeature).
  5. Open a Pull Request.

📜 License

DecorRes is licensed under the MIT License.

🛠 Built With

  • TypeScript: Type-safe, scalable development.
  • Reflect-metadata: For decorator metadata reflection.
  • Custom Decorators: A clean and declarative way to extend functionality.

👏 Acknowledgements

Thanks to the open-source community for contributions and inspiration.

📬 Contact

For support or inquiries: