Security News
RubyGems.org Adds New Maintainer Role
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
All modern frameworks has some concept of an action. The purpose of an action is to perform side effects, this being changing the state of the application or talking to the server. How you express this action is different in the different frameworks and tools, but they typically have one thing in common... they are expressed as one function with imperative code.
There is nothing wrong with imperative code, we need it, but it has some limitations:
When a single function with imperative code grows it quickly becomes difficult to reason about what it does
There is no way to track what the function does, because it is low level and we typically point directly to other libraries and functions
It requires a lot of dicipline to make your code reusable and composable
action-chain moves you into a functional world by exposing a chaining API, much like RxJS. But instead of being focused on value transformation, action-chain is focused on side effects. With its "developer experience" driven implementation it allows for building developer tools that can visual all execution.
import { Action, NoValueAction, actionChainFactory, actionFactory } from 'action-chain'
// The context holds all side effects you want to access in
// your chain. Expressed as simple objects with methods. You would
// use this to wrap existing libraries, exposing a domain specific
// api for your action chain
const context = {
say: {
hello: () => 'hello',
goodbye: () => 'goodbye'
}
}
type Context = typeof context
// The action chain manages execution of the actions and
// provides the context to them
const actionChain = actionChainFactory<Context>(context)
// You define your own factory for creating actions. It
// can define an initial value type and returns an
// action factory with the chain defined. You type out
// conditional "Action" or "NoValueAction" to allow
// typed actions to require a value and untyped actions
// to not require a value
const action = function <InitialValue>(): InitialValue extends undefined
? NoValueAction<Context, InitialValue>
: Action<Context, InitialValue> {
return actionFactory<Context, InitialValue>(actionChain)
}
const test = action<string>()
.map((name, { say }) => `${say.hello()} ${name}`)
test('Bob') // "hello Bob"
actionChain.on('action:start', (details) => {
/*
{
actionId: 0,
executionId: 0,
}
*/
})
actionChain.on('operator:start', (details) => {
/*
{
actionId: 0,
executionId: 0,
operatorId: 0,
name: '',
type: 'map',
path: []
}
*/
})
actionChain.on('operator:end', (details) => {
/*
{
actionId: 0,
executionId: 0,
operatorId: 0,
name: '',
type: 'map',
path: [],
isAsync: false,
result: 'hello Bob'
}
*/
})
actionChain.on('action:end', (details) => {
/*
{
actionId: 0,
executionId: 0,
}
*/
})
Allows you to run effects and passes the current value a long to the next operator.
const test = action()
.do((_, { localStorage }) => {
localStorage.set('foo', 'bar')
})
Maps to a new value, passed to the next operator.
const test = action<string>()
.map((value) => value.toUpperCase())
If returning a promise, run paths based on resolved or rejected.
const test = action<string>()
.try((_, { api }) => api.getUser(), {
success: action(),
error: action()
})
Executes true or false path based on boolean value.
const test = action<string>()
.when((value) => value.length > 3, {
true: action(),
false: action()
})
Stops execution when false.
const test = action<string>()
.filter(() => false)
// does not run
.map(() => 'foo')
Debounces execution.
const test = action<string>()
.debounce(100)
// Runs when 100 milliseconds has passed since
// last time the "test" action was called
.map(() => 'foo')
import { Action, NoValueAction, actionChainFactory, actionFactory, Execution } from 'action-chain'
// There are two types of actions. Actions that takes an initial value
interface MyAction<Context, InitialValue, Value = InitialValue>
extends MyOperators<Context, InitialValue, Value>,
Action<Context, InitialValue, Value> {}
// And those who do not
interface NoValueMyAction<Context, InitialValue, Value = InitialValue>
extends MyOperators<Context, InitialValue, Value>,
NoValueAction<Context, InitialValue, Value> {}
// You type out your operators and all of them will return either
// an action with an initial value or not, based on the "InitialValue"
// typing
interface MyOperators<Context, InitialValue, Value> {
log(): InitialValue extends undefined
? NoValueMyAction<Context, InitialValue, Value>
: MyAction<Context, InitialValue, Value>
}
// Create a new actionFactory which composes the default one and implements
// the new operators
function myActionFactory<Context, InitialValue, Value = InitialValue>(
actionChain: ActionChain<Context>,
initialActionId?: number,
runOperators?: (
value: any,
execution: Execution,
path: string[]
) => any | Promise<any>
): InitialValue extends undefined
? NoValueMyAction<Context, InitialValue, Value>
: MyAction<Context, InitialValue, Value> {
return Object.assign(
actionFactory<Context, InitialValue, Value>(
actionChain,
initialActionId,
runOperators
) as any,
{
log() {
const operator = (value) => {
console.log(value)
return value
}
const [
chain,
initialActionId,
runOperators,
] = this.createOperatorResult('log', '', operator)
return myActionFactory<Context, InitialValue, Value>(
chain,
initialActionId,
runOperators
)
},
}
)
}
const myAction = function<
InitialValue = undefined
>(): InitialValue extends undefined
? NoValueMyAction<Context, InitialValue>
: MyAction<Context, InitialValue> {
return myActionFactory<Context, InitialValue>(actionChain)
}
FAQs
Typed events
The npm package betsy receives a total of 1,613 weekly downloads. As such, betsy popularity was classified as popular.
We found that betsy demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 2 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
RubyGems.org has added a new "maintainer" role that allows for publishing new versions of gems. This new permission type is aimed at improving security for gem owners and the service overall.
Security News
Node.js will be enforcing stricter semver-major PR policies a month before major releases to enhance stability and ensure reliable release candidates.
Security News
Research
Socket's threat research team has detected five malicious npm packages targeting Roblox developers, deploying malware to steal credentials and personal data.