
Security News
Bun 1.2.19 Adds Isolated Installs for Better Monorepo Support
Bun 1.2.19 introduces isolated installs for smoother monorepo workflows, along with performance boosts, new tooling, and key compatibility fixes.
Domain-Centric TypeScript — a functional, event-driven approach to core domain logic in TypeScript.
dc-ts
?dc-ts is a lightweight library and architecture style for implementing core domain logic using:
CoreWf
constrain → decide → evolve
📦 Core/
├─ domain.ts # your types and workflows
└─ _implementation/
├─ _schema.ts # generated TypeBox schemas
├─ constructors.ts # smart type-safe constructors
├─ constrain.ts # constraint logic
├─ decide.ts # decision logic (commands → events)
├─ evolve.ts # state transitions (events → state)
└─ tests/ # BDD-style tests
At the heart of dc-ts is the CoreWf
type:
export type CoreWf<C, iA, E, oA, F> = {
cmd: C // domain command
inputAg: iA // aggregate before
outputAg: oA // aggregate after
aggregate: iA | oA
evt: E // emitted event
fails: F // failure messages
validateAggregate: SafeParse<iA | oA>
}
export type CreateToDoWf = CoreWf<
CMD<'create-todo', { title: string }>,
AGG<'initial', { title?: string }>,
EVT<'todo-created', { id: string; title: string }>,
AGG<'created', { id: string; title: string; status: 'pending' }>,
'title_required'
>
Used to enforce business rules before deciding.
export const constrainToDo: Constrain<CreateToDoWf['cmd'], CreateToDoWf['inputAg'], 'title_required'> =
(cmd) => (state) => {
if (!cmd.data.title?.trim()) {
return fail('title_required')
}
return succeed(state)
}
Takes a command and a validated state and returns event(s).
export const decideToDo = (cmd: CreateToDoWf['cmd']) => (state: CreateToDoWf['inputAg']) => {
const evtRes = newToDoEVT<CreateToDoWf['evt']>()('todo-created')(dtFromMsg(cmd))({
id: crypto.randomUUID(),
title: cmd.data.title
})
return isFailure(evtRes) ? evtRes : succeed([evtRes.data])
}
Transitions the aggregate to its next state.
export const evolveToDo = (evt: CreateToDoWf['evt']) => (state: CreateToDoWf['inputAg']): CreateToDoWf['outputAg'] => {
return {
_tag: 'created',
data: {
id: evt.data.id,
title: evt.data.title,
status: 'pending'
}
}
}
All inputs and state transitions are validated using TypeBox:
export const newToDoCMD = <C extends CreateToDoWf['cmd']>() =>
newCmd<C['type'], C['data']>(safeParseTBox(ToDoCmdSchema))
Tests can be generated and follow a Given/When/Then format:
Deno.test("Given a valid command, When constraints run, Then succeed", () => {
const cmd = { ... }
const state = { ... }
const result = constrainToDo(cmd)(state)
assertEquals(result.outcome, "success")
})
Use the dcts
CLI to generate:
MIT — Giovanni & Contributors
FAQs
Utilities for domain-centric typescript
The npm package dc-ts receives a total of 8 weekly downloads. As such, dc-ts popularity was classified as not popular.
We found that dc-ts demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer 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
Bun 1.2.19 introduces isolated installs for smoother monorepo workflows, along with performance boosts, new tooling, and key compatibility fixes.
Security News
Popular npm packages like eslint-config-prettier were compromised after a phishing attack stole a maintainer’s token, spreading malicious updates.
Security News
/Research
A phishing attack targeted developers using a typosquatted npm domain (npnjs.com) to steal credentials via fake login pages - watch out for similar scams.