Dapr State Store

When running with the Dapr sidecar, @purista/dapr-sdk routes state store operations through Dapr’s state management API. The backing store — Redis, Azure Cosmos DB, AWS DynamoDB, PostgreSQL, Cassandra, and many more — is defined as a Dapr component outside your application code.

Capabilities

Feature	Support
Read (`getState`)	✅
Write (`setState`)	✅ (opt-in)
Delete (`removeState`)	✅ (opt-in)
Backing store	Any Dapr state component
Transactions	✅ (Dapr-native, where supported by backend)
Optimistic concurrency (ETag)	✅ (Dapr-native)
Infrastructure portability	✅ (swap component, not code)

Install

npm install @purista/dapr-sdk

Setup

State store access is configured on the DaprEventBridge — no separate constructor needed.

import { DaprEventBridge } from '@purista/dapr-sdk'

const eventBridge = new DaprEventBridge({
  daprApiToken: process.env.DAPR_API_TOKEN,
  stateStoreName: 'my-state-store',
  secretStoreName: 'my-secret-store',
  configStoreName: 'my-config-store',
})

const myService = await myV1Service.getInstance(eventBridge)

Dapr component definition

Example using Redis as the backing state store:

# components/state-store.yaml
apiVersion: dapr.io/v1alpha1
kind: Component
metadata:
  name: my-state-store
spec:
  type: state.redis
  version: v1
  metadata:
    - name: redisHost
      value: localhost:6379
    - name: redisPassword
      value: ""
    - name: actorStateStore
      value: "true"

Swap spec.type to state.azure.cosmosdb, state.dynamodb, state.postgresql, etc. without changing a single line of PURISTA service code.

Usage inside a handler

.setCommandFunction(async function (context, payload) {
  await context.states.setState('lastProcessedAt', new Date().toISOString())
  const { lastProcessedAt } = await context.states.getState('lastProcessedAt')
})

Operational tips

Use Dapr component scopes to control which services can access which state stores
Dapr supports optimistic concurrency with ETags — useful for preventing write conflicts in concurrent workflows
Dapr handles connection retries to the sidecar; implement graceful startup delays if the sidecar needs extra time to initialize
Run dapr dashboard during development to inspect state store operations and debug state values