@geenius/jobs

Background jobs, scheduling, worker visibility, and queue dashboards for Geenius apps.

Overview

@geenius/jobs packages the shared jobs contract, React and SolidJS bindings, CSS variants, and Convex helpers behind one stable root contract.

Use it when you need:

• queued job dashboards and detail pages
• worker status and schedule visibility
• retry, cancellation, and progress helpers
• shared utilities for job stats, durations, and status metadata

Installation

pnpm add @geenius/jobs

Imports

import { calcJobStats, DEFAULT_JOB_TYPES } from '@geenius/jobs'
import { calcJobStats, DEFAULT_JOB_TYPES } from '@geenius/jobs/shared'
import { jobTables, schema } from '@geenius/jobs/convex'
import { JobsDashboardPage } from '@geenius/jobs/react'
import { JobsDashboardPage } from '@geenius/jobs/react-css'
import { JobsDashboardPage } from '@geenius/jobs/solidjs'
import { JobsDashboardPage } from '@geenius/jobs/solidjs-css'

Usage

import { JobsDashboardPage } from '@geenius/jobs/react'

export function JobsRoute() {
  return (
    <JobsDashboardPage
      jobs={jobs}
      workers={workers}
      jobTypes={['send-email', 'sync-data']}
      onCreate={async (type, name, payload, priority) => {
        await createJob({ type, name, payload, priority })
      }}
    />
  )
}

Storybook

The package includes React and SolidJS Storybook apps built on the shared @geenius/storybook shell. Each app compares the Tailwind and vanilla CSS variants side by side across queue, operations, and dashboard stories.

• React storybook app
• SolidJS storybook app

pnpm dev:storybook-react
pnpm dev:storybook-solidjs

Use those commands from the package root to open the local review apps for the React and SolidJS variants.

Package Contract

• Root imports map to the shared jobs contract.
• Framework variants are consumed through stable subpath exports.
• Development-only storybook apps are isolated from package build, test, and release flows.

This package follows the Geenius package golden standard and exposes one published root contract plus stable framework and backend subpaths.

License

Commercial package. See LICENSE for the Geenius commercial terms.