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

seneca-entity

v28.1.0

Published

Entity plugin for seneca

Downloads

21,003

Readme

Seneca Entity

Seneca Entity is a plugin for Seneca

Provides a simple Object-Relation Mapping over Seneca messages as a convenience API for manipulating data.

Any data store can then be accessed using the full power of Seneca messages.

npm version build Coverage Status Known Vulnerabilities DeepScan grade Maintainability

seneca-entity

| Voxgig | This open source module is sponsored and supported by Voxgig. | | ---------------------------------------------------- | --------------------------------------------------------------------------------------- |

Install

With npm:

$ npm install seneca-entity

With yarn:

$ yarn add seneca-entity

TypeScript

Implemented using TypeScript. Minimal types are provided by the package.

Quick Example

Please visit senecajs.org for a more complete overview and documentation of the Seneca framework.

Read the Understanding Data Entities tutorial for a step-by-step introduction to Seneca data entities.

const Seneca = require('seneca')

const seneca = Seneca() // Create a new instance of Seneca.
  .use('entity')        // Use the seneca-entity plugin (Seneca will require it).
  
// Create an reusable instance of the `person` entity.
const Person = seneca.entity('person')

// Create a specific person instance.
let alice = Person.make$()

// Set some fields (assumes a NoSQL database, or a predefined table).
// Properties with a final `$` are reserved for the Entity API methods.
alice.name = 'Alice'
alice.location = 'Wonderland'

// Save your data. Seneca entity provides a default in-memory store,
// which is very useful for fast unit tests.
alice = await alice.save$()

// The `alice` entity now has an `id` field.
let alsoAlice = await Person.load$(alice.id)
alsoAlice.location = 'Looking Glass'

// The `alsoAlice` entity will be updated, not created, because
// it has an `id` field. The save$ method both creates and updates.
await alsoAlice.save$()

// Entity methods can be chained (until they return a Promise).
let lily = await Person
    .make$({
      name: 'Lily',
      location: 'Looking Glass'
    })
    .save$()

// The data$ method exports a JSON serializable verson of the entity
// as a plain object.
console.log(lily.data$())

// The data$ method can alternatively set multiple fields.
await lily
  .data$({
    game: 'chess'
  })
  .save$()

// List all the person entities.
let people = await Person.list$()

// List only those person entities with field `game` equal to the string "chess".
let players = await Person.list$({game: 'chess'})

Seneca Entity is inspired in part by the ActiveRecord pattern as implemented by Ruby on Rails.

Seneca Entity is not a full Object Relation Mapping. It is a convenience API over the Seneca action patterns:

  • role:entity,cmd:load - .load$()
  • role:entity,cmd:save - .save$()
  • role:entity,cmd:list - .list$()
  • role:entity,cmd:remove - .remove$()

This means that you can extend the "ORM" using the same message manipulation as with all Seneca messages, including sending them over the network to other microservices.

In particular, you can:

  • Support pretty much any kind of database for a standard set of basic operations, extending the query syntax if necessary - @seneca/s3-store
  • Easily define reusable business logic that assumes standard entities, but is still extensible - @seneca/user
  • Add cross-cutting concerns without polluting your business logic - @seneca/allow
  • Customize specific operations for specific entities by adding your own action patterns - seneca.message('role:entity,cmd:save,name:person', async function(msg) { ... })
  • Expose most REST or GraphQL APIs as "databases" - @seneca/trello-provider
  • Use different databases for different entities, see Mapping Entities to Data Stores
  • Namespace and isolate entities as desired; entities have not just a name, but also an optional base (table namespace) and zone (good for strict multi-tenancy), to use as you see fit.

BUT, Seneca entity does not natively implement relations, and loads only the top level entity. Since relation mapping often leads to inefficient queries, this is not such a bad thing. When relations are needed, you can implement them manually by customizing the appropriate action patterns. Or you may find that denormalizing your data is more fun than you think.

More Examples

API

Contributing

Background

License

Copyright (c) 2012-2022, Richard Rodger and other contributors. Licensed under MIT.