@harlan-zw/nuxt-jev

Nuxt Jev

Run Jev judgements from Nuxt server code, with journal reuse and per-seat rollout.

Why Nuxt Jev?

A model call inside a server route runs on every request. When it fails, the route still needs an answer.

• 💸 Repeat calls: The same question about the same state goes to the network again on every request.
• 🚧 Failures break the route: A timeout or a bad answer turns into an error for the user.
• 🎛️ All or nothing rollout: A new judgement acts on production traffic before you know it agrees with reality.
• 🔓 Missing credentials: A site with no Cloudflare token still tries the call and fails.

Nuxt Jev is the Nuxt layer for Jev typed judgements. It adds module config, a decision runner with journal reuse, and the drizzle schema. Jev is a System One judge. It answers typed questions about one state with probabilities. It never generates text. The client, question builders, ask tags, and eval math live in @harlan-zw/jev, the Nuxt-free base package.

Features

• ♻️ Journal reuse: The same seat, subject, state, and question version reads the stored row, with no network call.
• 🧯 Tagged decisions: decideJev resolves Answer, Unavailable, or Unconfigured, so the caller keeps its safe direction.
• 🎛️ Seat modes: Set each seat to off, shadow, or live, and act only on live seats.
• 🔓 Unconfigured by default: With no apiToken and accountId, no rows are written and no network call is made.
• 🗄️ Drizzle table factory: createJevDecisionsTable() gives a sqlite table for D1 or better-sqlite, with room for extra columns.
• 🧪 In-memory journal: createInMemoryJevJournal() runs the same runner in tests without a database.

Installation

npx nuxi@latest module add @harlan-zw/nuxt-jev

If you import question builders such as noul in your own code, add @harlan-zw/jev too:

pnpm add @harlan-zw/jev

[!TIP] Generate an Agent Skill for this package using skilld:

npx skilld add @harlan-zw/nuxt-jev

Exports

Safety rules

Environment keys

Consumption sketch

Register the module and merge the table into your schema.

// nuxt.config.ts
export default defineNuxtConfig({
  modules: ['@harlan-zw/nuxt-jev'],
  runtimeConfig: {
    jev: { seatModes: 'brand-query=live,ctr-outlier=shadow' },
  },
})

// server/database/schema.ts (drizzle, D1 or better-sqlite)
import { createJevDecisionsTable } from '@harlan-zw/nuxt-jev/schema'

export const jevDecisions = createJevDecisionsTable()

// any server code
import { noul } from '@harlan-zw/jev'
import { createInMemoryJevJournal, decideJev, resolveJevConfig, resolveJevSeatMode } from '@harlan-zw/nuxt-jev/server'

const config = resolveJevConfig(useRuntimeConfig().jev)
const decision = await decideJev({
  journal: myDrizzleJournal, // find / insert / isUniqueViolation over jevDecisions
  config,
  seat: 'brand-query',
  questionVersion: 'v1',
  subject: 'q:nuxtseo',
  state: { query, brandTerms },
  questions: { brand: noul('Is `query` a search for the site brand?') },
  siteId: site.id,
})
if (decision._tag === 'Answer' && resolveJevSeatMode('brand-query', config) === 'live') {
  // act on decision.answers.brand.noul
}

For tests, or if you have no database, use createInMemoryJevJournal().

Sponsors

License

Licensed under the MIT license.