@owlmeans/client-job 0.1.18-rc.9 → 0.1.18

package/README.md

@@ -1,21 +1,8 @@
 # @owlmeans/client-job
 
-The browser half of a job feed: a state store holding `JobRecord`s, hooks to read it, and one
-socket subscription that keeps it current. It addresses the entrypoints
-[`@owlmeans/server-job`](../server-job) declares.
-
-## Overview
-
-- `appendJobs(context, alias?)` — register the job store on the client context
-- `useJob(id)` / `useJobs(filter)` — live reads over that store
-- `useJobFeed(opts?)` — one socket plus one seeding list call; mount it ONCE per screen
-- `applyJobEvent(store, event)` — the fold, for a feed of your own
-
-## Installation
-
-```bash
-bun add @owlmeans/client-job@^0.1.18-rc.0
-```
+Browser state and hooks for the sanitized application-job contract from `@owlmeans/job`. This
+package has no queue dependency and never receives transport records, credentials, ownership
+fields, stack traces or internal payloads.
 
 ## Usage
 
@@ -30,39 +17,27 @@ export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T =
 ```
 
 ```tsx
+import { JobViewStatus } from '@owlmeans/job'
 import { useJobFeed, useJobs } from '@owlmeans/client-job'
-import { JobProgress, JobStatus, useJobToasts } from '@owlmeans/web-panel/jobs'
-import { JobState } from '@owlmeans/queue'
 
-export const Jobs: FC = () => {
-  const { seeded } = useJobFeed({ root: REPORTS })
-  const jobs = useJobs({ state: [JobState.Waiting, JobState.Active] })
-  useJobToasts(jobs.map(job => job.record))
+export const Operations = () => {
+  const { seeded, error } = useJobFeed({ root: REPORTS, query: { size: 50 } })
+  const running = useJobs({ status: JobViewStatus.Running })
 
-  return seeded
-    ? <ul>{jobs.map(job => <li key={job.id}>
-      <JobStatus job={job.record} /><JobProgress job={job.record} />
-    </li>)}</ul>
-    : <Spinner/>
+  if (error != null) return <p>Operations could not be loaded.</p>
+  if (!seeded) return <Spinner />
+  return <ul>{running.map(model => <li key={model.id}>{model.record.summary}</li>)}</ul>
 }
 ```
 
-## The one gotcha
-
-`useJobFeed` opens a socket per call. Mount it once, high enough that everything showing jobs sits
-under it, and read the store everywhere else — a second feed makes the server push every event
-twice and doubles what the screen reacts to.
-
-## Depends On
-
-- [`@owlmeans/state`](../state) — the store; [`@owlmeans/client`](../client) — `useStoreModel` / `useStoreList`
-- [`@owlmeans/client-auth`](../client-auth) — `useWs`, which puts the token on the socket query
-- [`@owlmeans/queue`](../queue) — `JobRecord`, `JobEvent`, `JobState`
-
-## Related
+- `appendJobs(context, alias?)` registers a dedicated `JobView` store.
+- `useJob(id)` and `useJobs(filter)` read safe public views.
+- `useJobFeed(opts?)` seeds from list and applies `JobViewEvent` socket frames.
+- `applyJobEvent(store, event)` is the public-view fold for a custom feed.
 
-- [`@owlmeans/server-job`](../server-job) — the entrypoints this addresses
-- [`@owlmeans/web-panel`](../web-panel) `./jobs` — the components to render what it collects
+Mount `useJobFeed` once per screen; every call owns a socket. Public filtering is limited to
+`status`, `kind`, `page` and `size`. A server must expose the matching routes through an explicit
+`@owlmeans/server-job` policy.
 
 <!-- owlmeans:agent-guidance:start -->
 ## Agent guidance
@@ -72,7 +47,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.20
+npx @owlmeans/agent-skills@^0.1.18
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
-  "schemaVersion": 2,
+  "schemaVersion": 3,
   "package": "@owlmeans/client-job",
-  "version": "0.1.18-rc.9",
-  "generatedAt": "2026-09-14T19:17:35.194Z",
+  "version": "0.1.18",
+  "generatedAt": "2026-10-28T00:31:34.751Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/client-job/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: client-job
-description: How to use @owlmeans/client-job — appendJobs() to register the job store, useJob/useJobs to read it, and useJobFeed() to mount the socket subscription and seed it from the list entrypoint. Auto-invoked when showing queue job progress in a browser client or importing job hooks.
+description: How to consume sanitized application JobView projections in a browser with appendJobs, useJob/useJobs and one useJobFeed subscription. Auto-invoked when rendering application job status or importing @owlmeans/client-job.
 user-invocable: false
 ---
 <!-- AUTO-GENERATED — do not edit. Regenerate via sync-agent-meta. -->
@@ -8,25 +8,11 @@ user-invocable: false
 # @owlmeans/client-job
 
 **Layer:** Client
-**Install:** `"@owlmeans/client-job": "^0.1.18-rc.9"` in `dependencies`
-
-The browser half of a job feed. It holds `JobRecord`s in a `@owlmeans/state` store, keeps that
-store current from the entrypoints `@owlmeans/server-job` declares, and hands screens the ordinary
-state hooks. Rendering is `@owlmeans/web-panel/jobs`.
-
-## Key Exports
-
-| Export | Description |
-|--------|-------------|
-| `appendJobs(context, alias?)` | Register the job store on the client context |
-| `useJob(id?, resource?)` | One job, live — an unknown or absent id yields an `empty` model, never a throw |
-| `useJobs(filter?, opts?)` | A live query over the store, newest first unless `opts.sort` says otherwise |
-| `useJobFeed(opts?)` | Mount the socket and seed the store. **Once per screen** |
-| `applyJobEvent(store, event)` | The fold one `JobEvent` performs, for a feed of your own |
-| `jobEntrypointAliases(root?)` | `{ base, list, get, cancel, watch }` — the same shape the server declares |
-| `JobFeed` / `JobFeedOptions` / `UseJobsOptions` / `JobFilter` | What the feed reports, and the option shapes |
-| `JOBS` | The store's alias (`job-state`), typed as `StateAlias<JobRecord>` |
-| Constants | `DEFAULT_JOB_ROOT` (`jobs`), `JOB_EVENT` (`job-event`) |
+**Install:** `"@owlmeans/client-job": "^0.1.18"` in `dependencies`
+
+This package stores and streams `JobView` from `@owlmeans/job`. It has no dependency on
+`@owlmeans/queue`; raw transport records, internal payloads, credentials, ownership fields and
+stack traces must never reach it.
 
 ## Wiring
 
@@ -40,62 +26,46 @@ export const makeContext = <C extends Config, T extends Context<C>>(cfg: C): T =
 }
 ```
 
-Jobs get a store of their own rather than the context's default one: a job id is the broker's, and
-sharing an id space with the app's records is how a completed job overwrites an unrelated row.
-`appendJobs` is idempotent like every `append*`.
+`appendJobs` registers a dedicated `StateAlias<JobView>` and is idempotent. The separate store
+prevents an opaque operation id from colliding with an application resource id.
 
 ## Reading
 
 ```tsx
-const { seeded, connected, error } = useJobFeed({ root: REPORTS, query: { size: 50 } })
-
-const running = useJobs({ state: [JobState.Waiting, JobState.Active] })
-const mine = useJobs({ 'data.target': projectId })
+import { JobViewStatus } from '@owlmeans/job'
+import { useJobFeed, useJobs } from '@owlmeans/client-job'
+
+const { seeded, connected, error } = useJobFeed({
+  root: REPORTS,
+  query: { status: JobViewStatus.Running, size: 50 },
+})
+const running = useJobs({ status: JobViewStatus.Running })
 const one = useJob(id)
 ```
 
-The criteria language is the resource one, so a filter written for the list entrypoint means the
-same thing applied locally, and a dotted key reaches into the payload. `seeded` is what tells "no
-jobs" apart from "not loaded yet" — `useJob` answers an `empty` model for an id the store has not
-seen, which is a loading state and not an error. `connected` says the socket is open and `error`
-carries whatever the seeding call threw, so a screen can distinguish a failed load from an empty
-one. `JobFeedOptions` also takes `resource` for a store other than `JOBS`, and a `query` narrowing
-the seeding call — compared by CONTENT, so a fresh object literal per render does not re-fetch
-while a changed filter does re-seed.
-
-## What `useJobFeed` does
-
-1. Opens the watch socket through `@owlmeans/client-auth`'s `useWs`, which puts the current token
-   on the connection query — the watch entrypoint is guarded, and the server derives ownership
-   from that token.
-2. Calls the list entrypoint once and writes the answer with **`store.replace`**, not a run of
-   saves: it is the server saying what exists, so a job cancelled from another tab has to LEAVE the
-   store, and one write wakes the subscribers once instead of once per record.
-3. Folds each `JobEvent` frame in with `applyJobEvent` — merged over the record the store holds,
-   because an event carries only what changed while `save` replaces. An event for an id the store
-   never saw still writes a row, so a job enqueued in another tab reports its progress here and the
-   next seeding call fills in the rest.
-
-Two details the fold gets right and a hand-written one usually does not: a progress frame never
-moves a settled job back to `Active` (the completion and the last progress ping race), and an empty
-`JobEvent.name` never overwrites a known one (the contract sends empty when the job is already
-gone).
-
-## The one gotcha
-
-**`useJobFeed` opens a socket per call.** Mount it once, high enough that everything showing jobs
-sits under it, and read the store everywhere else. Two feeds make the server push every event twice
-and re-seed over each other.
-
-## Depends On
-
-- `@owlmeans/state` — the store, `replace` and the `StateModel` commit rules
-- `@owlmeans/client` — `useStoreModel`, `useStoreList`, `useContext`
-- `@owlmeans/client-auth` — `useWs` (the token-carrying socket)
-- `@owlmeans/queue` — `JobRecord`, `JobEvent`, `JobState`, `isSettled`
+- Mount `useJobFeed` once per screen. Each call owns a socket.
+- `seeded` distinguishes an empty list from one not loaded yet.
+- `error` is the list failure; `connected` reports the watch connection.
+- Public query fields are `status`, `kind`, `page` and `size` only.
+- `useJob` yields an empty model for an unseen id rather than throwing.
+- `applyJobEvent` replaces a row with the complete sanitized view or removes its opaque id.
+
+The server must expose the same alias root through `@owlmeans/job` declarations and an explicit
+`@owlmeans/server-job` policy. Do not reconstruct queue names, raw ids or technical payload fields
+in browser code.
+
+## Key exports
+
+| Export | Purpose |
+|---|---|
+| `appendJobs` | Register the `JobView` state resource |
+| `useJob` / `useJobs` | Read public job views |
+| `useJobFeed` | Seed list plus sanitized event subscription |
+| `applyJobEvent` | Fold a `JobViewEvent` into a store |
+| `JOBS` | Default store alias |
 
 ## Related
 
-- `server-job` — the entrypoints this addresses, and the ownership rule that decides what arrives
-- `state` — the store contract; `client-socket` — how the connection is addressed
-- `web-panel` — `./jobs` (`JobProgress`, `JobStatus`, `useJobToasts`)
+- `job` — safe contracts, schemas and route declarations
+- `server-job` — policy-enforced technical-to-domain bridge
+- `state` and `client-socket` — local storage and authenticated socket transport

package/build/consts.d.ts

@@ -1,15 +1,5 @@
-import type { JobRecord } from '@owlmeans/queue';
-import type { StateAlias } from '@owlmeans/state';
+import { type StateAlias } from '@owlmeans/state';
+import type { JobView } from '@owlmeans/job';
 /** The store this package registers and every hook here reads. */
-export declare const JOBS: StateAlias<JobRecord>;
-/**
- * The alias root a group answers under when a caller names none — the same default
- * `@owlmeans/server-job` declares with.
- *
- * That package's `<root>` / `<root>:<verb>` alias shape and its `job-event` frame name are the
- * whole contract between the two halves. They are restated here rather than imported because the
- * server half pulls fastify in, and a browser bundle must not.
- */
-export declare const DEFAULT_JOB_ROOT = "jobs";
-export declare const JOB_EVENT = "job-event";
+export declare const JOBS: StateAlias<JobView>;
 //# sourceMappingURL=consts.d.ts.map

package/build/consts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,kEAAkE;AAClE,eAAO,MAAM,IAAI,EAAE,UAAU,CAAC,SAAS,CAAsC,CAAA;AAE7E;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,SAAS,CAAA;AAEtC,eAAO,MAAM,SAAS,cAAc,CAAA"}
+{"version":3,"file":"consts.d.ts","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,UAAU,EAAc,MAAM,iBAAiB,CAAA;AAC7D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,kEAAkE;AAClE,eAAO,MAAM,IAAI,EAAE,UAAU,CAAC,OAAO,CAAoC,CAAA"}

package/build/consts.js

@@ -1,14 +1,4 @@
 import { stateAlias } from '@owlmeans/state';
 /** The store this package registers and every hook here reads. */
 export const JOBS = stateAlias('job-state');
-/**
- * The alias root a group answers under when a caller names none — the same default
- * `@owlmeans/server-job` declares with.
- *
- * That package's `<root>` / `<root>:<verb>` alias shape and its `job-event` frame name are the
- * whole contract between the two halves. They are restated here rather than imported because the
- * server half pulls fastify in, and a browser bundle must not.
- */
-export const DEFAULT_JOB_ROOT = 'jobs';
-export const JOB_EVENT = 'job-event';
 //# sourceMappingURL=consts.js.map

package/build/consts.js.map

@@ -1 +1 @@
-{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG5C,kEAAkE;AAClE,MAAM,CAAC,MAAM,IAAI,GAA0B,UAAU,CAAY,WAAW,CAAC,CAAA;AAE7E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,MAAM,CAAA;AAEtC,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAA"}
+{"version":3,"file":"consts.js","sourceRoot":"","sources":["../src/consts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAG7D,kEAAkE;AAClE,MAAM,CAAC,MAAM,IAAI,GAAwB,UAAU,CAAU,WAAW,CAAC,CAAA"}

package/build/feed.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAG1E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,UAAW,cAAc,KAAG,OAkDlD,CAAA"}
+{"version":3,"file":"feed.d.ts","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAmB,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAK1E;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,UAAU,UAAW,cAAc,KAAG,OAkDlD,CAAA"}

package/build/feed.js

@@ -1,9 +1,11 @@
 import { useEffect, useMemo, useState } from 'react';
 import { useContext } from '@owlmeans/client';
 import { useWs } from '@owlmeans/client-auth';
-import { DEFAULT_JOB_ROOT, JOBS, JOB_EVENT } from './consts.js';
-import { jobEntrypointAliases } from './helper.js';
+import { DEFAULT_JOB_ROOT, JOB_EVENT, jobEntrypointAliases } from '@owlmeans/job';
+import { logger } from '@owlmeans/log';
+import { JOBS } from './consts.js';
 import { applyJobEvent } from './utils/index.js';
+const log = logger('client-job');
 /**
  * Mount the job feed: one socket, seeded once from the list entrypoint.
  *
@@ -55,7 +57,7 @@ export const useJobFeed = (opts) => {
                 await applyJobEvent(store, message.payload);
             }
             catch (e) {
-                console.error('Job feed apply error:', e);
+                log.warn('Job feed apply failed', e);
             }
         });
         return () => unsubscribe();

package/build/feed.js.map

@@ -1 +1 @@
-{"version":3,"file":"feed.js","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"feed.js","sourceRoot":"","sources":["../src/feed.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAA;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAC7C,OAAO,EAAE,KAAK,EAAE,MAAM,uBAAuB,CAAA;AAE7C,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,oBAAoB,EAAmC,MAAM,eAAe,CAAA;AAElH,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAA;AACtC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAElC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAEhD,MAAM,GAAG,GAAG,MAAM,CAAC,YAAY,CAAC,CAAA;AAEhC;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAqB,EAAW,EAAE;IAC3D,MAAM,OAAO,GAAG,UAAU,EAAmB,CAAA;IAC7C,MAAM,KAAK,GAAG,IAAI,EAAE,QAAQ,IAAI,IAAI,CAAA;IACpC,MAAM,OAAO,GAAG,OAAO,CACrB,GAAG,EAAE,CAAC,oBAAoB,CAAC,IAAI,EAAE,IAAI,IAAI,gBAAgB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,CACzE,CAAA;IACD,MAAM,UAAU,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACvC,MAAM,CAAC,IAAI,EAAE,OAAO,CAAC,GAAG,QAAQ,CAAoC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;IACnG,+FAA+F;IAC/F,wFAAwF;IACxF,MAAM,KAAK,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,CAAA;IAEjD,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,IAAI,GAAG,IAAI,CAAA;QACf,KAAK,CAAC,KAAK,IAAI,EAAE;YACf,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,MAAM,OAAO,CAAC,UAAU,CAAwC,OAAO,CAAC,IAAI,CAAC;qBACzF,IAAI,CAAsB,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAA;gBACpD,IAAI,CAAC,IAAI,EAAE,CAAC;oBACV,OAAM;gBACR,CAAC;gBACD,MAAM,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBAC3D,OAAO,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAA;YACxC,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,IAAI,IAAI,EAAE,CAAC;oBACT,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAU,EAAE,CAAC,CAAA;gBAC/C,CAAC;YACH,CAAC;QACH,CAAC,CAAC,EAAE,CAAA;QAEJ,OAAO,GAAG,EAAE,GAAG,IAAI,GAAG,KAAK,CAAA,CAAC,CAAC,CAAA;IAC/B,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAA;IAEzC,SAAS,CAAC,GAAG,EAAE;QACb,IAAI,UAAU,IAAI,IAAI,EAAE,CAAC;YACvB,OAAM;QACR,CAAC;QACD,MAAM,KAAK,GAAG,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAA;QAC7C,MAAM,WAAW,GAAG,UAAU,CAAC,OAAO,CAAe,SAAS,EAAE,KAAK,EAAC,OAAO,EAAC,EAAE;YAC9E,IAAI,CAAC;gBACH,MAAM,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,OAAO,CAAC,CAAA;YAC7C,CAAC;YAAC,OAAO,CAAC,EAAE,CAAC;gBACX,GAAG,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC,CAAA;YACtC,CAAC;QACH,CAAC,CAAC,CAAA;QAEF,OAAO,GAAG,EAAE,CAAC,WAAW,EAAE,CAAA;IAC5B,CAAC,EAAE,CAAC,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAA;IAEhC,OAAO,EAAE,SAAS,EAAE,UAAU,IAAI,IAAI,EAAE,GAAG,IAAI,EAAE,CAAA;AACnD,CAAC,CAAA"}

package/build/helper.d.ts

@@ -1,17 +1,13 @@
-import type { StateAlias } from '@owlmeans/state';
-import type { JobRecord } from '@owlmeans/queue';
-import type { Config, Context, JobEntrypointAliases } from './types.js';
+import { type StateAlias } from '@owlmeans/state';
+import type { JobView } from '@owlmeans/job';
+import type { Config, Context } from './types.js';
 /**
  * Register the store the job hooks read.
  *
- * Jobs get a store of their own rather than the context's default one because a job id is the
- * broker's, and sharing an id space with the app's own records is how a completed job overwrites
- * an unrelated row. Idempotent, like every `append*` — an app that calls it twice keeps whatever
- * the store already collected.
+ * Jobs get a store of their own rather than the context's default one because their opaque ids
+ * are a separate domain namespace. Sharing that id space with the app's own records is how a
+ * completed operation overwrites an unrelated row. Idempotent, like every `append*` — an app that
+ * calls it twice keeps whatever the store already collected.
  */
-export declare const appendJobs: <C extends Config, T extends Context<C>>(context: T, alias?: StateAlias<JobRecord>) => T;
-/**
- * The aliases one job group answers under — the same shape `@owlmeans/server-job` declares.
- */
-export declare const jobEntrypointAliases: (root?: string) => JobEntrypointAliases;
+export declare const appendJobs: <C extends Config, T extends Context<C>>(context: T, alias?: StateAlias<JobView>) => T;
 //# sourceMappingURL=helper.d.ts.map

package/build/helper.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAA;AAEvE;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,WACtD,CAAC,UAAS,UAAU,CAAC,SAAS,CAAC,KACvC,CAA8D,CAAA;AAEjE;;GAEG;AACH,eAAO,MAAM,oBAAoB,UACzB,MAAM,KACX,oBAMD,CAAA"}
+{"version":3,"file":"helper.d.ts","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAuB,KAAK,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACtE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAEjD;;;;;;;GAOG;AACH,eAAO,MAAM,UAAU,GAAI,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,OAAO,CAAC,CAAC,CAAC,WACtD,CAAC,UAAS,UAAU,CAAC,OAAO,CAAC,KACrC,CAA4D,CAAA"}

package/build/helper.js

@@ -1,22 +1,12 @@
 import { appendStateResource } from '@owlmeans/state';
-import { DEFAULT_JOB_ROOT, JOBS } from './consts.js';
+import { JOBS } from './consts.js';
 /**
  * Register the store the job hooks read.
  *
- * Jobs get a store of their own rather than the context's default one because a job id is the
- * broker's, and sharing an id space with the app's own records is how a completed job overwrites
- * an unrelated row. Idempotent, like every `append*` — an app that calls it twice keeps whatever
- * the store already collected.
+ * Jobs get a store of their own rather than the context's default one because their opaque ids
+ * are a separate domain namespace. Sharing that id space with the app's own records is how a
+ * completed operation overwrites an unrelated row. Idempotent, like every `append*` — an app that
+ * calls it twice keeps whatever the store already collected.
  */
 export const appendJobs = (context, alias = JOBS) => appendStateResource(context, alias);
-/**
- * The aliases one job group answers under — the same shape `@owlmeans/server-job` declares.
- */
-export const jobEntrypointAliases = (root = DEFAULT_JOB_ROOT) => ({
-    base: root,
-    list: `${root}:list`,
-    get: `${root}:get`,
-    cancel: `${root}:cancel`,
-    watch: `${root}:watch`,
-});
 //# sourceMappingURL=helper.js.map

package/build/helper.js.map

@@ -1 +1 @@
-{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAGrD,OAAO,EAAE,gBAAgB,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGpD;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAU,EAAE,KAAK,GAA0B,IAAI,EAC5C,EAAE,CAAC,mBAAmB,CAAkB,OAAO,EAAE,KAAK,CAAM,CAAA;AAEjE;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAClC,IAAI,GAAW,gBAAgB,EACT,EAAE,CAAC,CAAC;IAC1B,IAAI,EAAE,IAAI;IACV,IAAI,EAAE,GAAG,IAAI,OAAO;IACpB,GAAG,EAAE,GAAG,IAAI,MAAM;IAClB,MAAM,EAAE,GAAG,IAAI,SAAS;IACxB,KAAK,EAAE,GAAG,IAAI,QAAQ;CACvB,CAAC,CAAA"}
+{"version":3,"file":"helper.js","sourceRoot":"","sources":["../src/helper.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAmB,MAAM,iBAAiB,CAAA;AAEtE,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlC;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG,CACxB,OAAU,EAAE,KAAK,GAAwB,IAAI,EAC1C,EAAE,CAAC,mBAAmB,CAAgB,OAAO,EAAE,KAAK,CAAM,CAAA"}

package/build/hooks.d.ts

@@ -1,5 +1,5 @@
 import type { StateModel } from '@owlmeans/state';
-import type { JobRecord } from '@owlmeans/queue';
+import type { JobView } from '@owlmeans/job';
 import type { JobFilter, UseJobsOptions } from './types.js';
 /**
  * One job, live.
@@ -7,12 +7,13 @@ import type { JobFilter, UseJobsOptions } from './types.js';
  * Never throws for an id the store has not seen — the model comes back `empty`, which is what a
  * screen renders as "still loading" while {@link useJobFeed} seeds.
  */
-export declare const useJob: <D = unknown, R = unknown>(id?: string, resource?: string) => StateModel<JobRecord<D, R>>;
+export declare const useJob: (id?: string, resource?: string) => StateModel<JobView>;
 /**
  * A live query over the job store, newest first unless told otherwise.
  *
  * The criteria is the resource language, so a filter written for the list entrypoint means the
- * same thing here: `{ state: JobState.Active }`, `{ name: 'report:build' }`, `{ 'data.target': id }`.
+ * same thing here: `{ status: JobViewStatus.Running }`, `{ kind: 'report-build' }` or an
+ * allowlisted metadata field.
  */
-export declare const useJobs: <D = unknown, R = unknown>(filter?: JobFilter<D, R>, opts?: UseJobsOptions<D, R>) => StateModel<JobRecord<D, R>>[];
+export declare const useJobs: (filter?: JobFilter, opts?: UseJobsOptions) => StateModel<JobView>[];
 //# sourceMappingURL=hooks.d.ts.map

package/build/hooks.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAEhD,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,OACxC,MAAM,aAAY,MAAM,KAC5B,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAiD,CAAA;AAE9E;;;;;GAKG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,WACrC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,SAAS,cAAc,CAAC,CAAC,EAAE,CAAC,CAAC,KACpD,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAI5B,CAAA"}
+{"version":3,"file":"hooks.d.ts","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AACjD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAE5C,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,YAAY,CAAA;AAE3D;;;;;GAKG;AACH,eAAO,MAAM,MAAM,QACZ,MAAM,aAAY,MAAM,KAC5B,UAAU,CAAC,OAAO,CAAyC,CAAA;AAE9D;;;;;;GAMG;AACH,eAAO,MAAM,OAAO,YACT,SAAS,SAAS,cAAc,KACxC,UAAU,CAAC,OAAO,CAAC,EAIpB,CAAA"}

package/build/hooks.js

@@ -11,7 +11,8 @@ export const useJob = (id, resource = JOBS) => useStoreModel(id, resource);
  * A live query over the job store, newest first unless told otherwise.
  *
  * The criteria is the resource language, so a filter written for the list entrypoint means the
- * same thing here: `{ state: JobState.Active }`, `{ name: 'report:build' }`, `{ 'data.target': id }`.
+ * same thing here: `{ status: JobViewStatus.Running }`, `{ kind: 'report-build' }` or an
+ * allowlisted metadata field.
  */
 export const useJobs = (filter, opts) => useStoreList({
     query: filter,

package/build/hooks.js.map

@@ -1 +1 @@
-{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAG9D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,EAAW,EAAE,QAAQ,GAAW,IAAI,EACP,EAAE,CAAC,aAAa,CAAkB,EAAE,EAAE,QAAQ,CAAC,CAAA;AAE9E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,MAAwB,EAAE,IAA2B,EACtB,EAAE,CAAC,YAAY,CAAkB;IAChE,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3D,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;CACjC,CAAC,CAAA"}
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../src/hooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AAG9D,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAA;AAGlC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CACpB,EAAW,EAAE,QAAQ,GAAW,IAAI,EACf,EAAE,CAAC,aAAa,CAAU,EAAE,EAAE,QAAQ,CAAC,CAAA;AAE9D;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CACrB,MAAkB,EAAE,IAAqB,EAClB,EAAE,CAAC,YAAY,CAAU;IAChD,KAAK,EAAE,MAAM;IACb,IAAI,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;IAC3D,QAAQ,EAAE,IAAI,EAAE,QAAQ,IAAI,IAAI;CACjC,CAAC,CAAA"}

package/build/index.d.ts

@@ -1,4 +1,5 @@
 export type * from './types.js';
+export { DEFAULT_JOB_ROOT, JOB_EVENT, jobEntrypointAliases } from '@owlmeans/job';
 export * from './consts.js';
 export * from './helper.js';
 export * from './hooks.js';

package/build/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAE/B,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,mBAAmB,YAAY,CAAA;AAC/B,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEjF,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA"}

package/build/index.js

@@ -1,3 +1,4 @@
+export { DEFAULT_JOB_ROOT, JOB_EVENT, jobEntrypointAliases } from '@owlmeans/job';
 export * from './consts.js';
 export * from './helper.js';
 export * from './hooks.js';

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,SAAS,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAA;AAEjF,cAAc,aAAa,CAAA;AAC3B,cAAc,aAAa,CAAA;AAC3B,cAAc,YAAY,CAAA;AAC1B,cAAc,WAAW,CAAA;AACzB,cAAc,kBAAkB,CAAA"}

package/build/types.d.ts

@@ -1,31 +1,22 @@
 import type { ClientConfig } from '@owlmeans/client-context';
 import type { ClientContext } from '@owlmeans/client';
-import type { JobRecord } from '@owlmeans/queue';
+import type { JobListQuery, JobView } from '@owlmeans/job';
 import type { Criteria, Sort } from '@owlmeans/resource';
 import type { StateAlias } from '@owlmeans/state';
 export interface Config extends ClientConfig {
 }
 export interface Context<C extends Config = Config> extends ClientContext<C> {
 }
-/** The alias every entrypoint of one job group answers under. */
-export interface JobEntrypointAliases {
-    base: string;
-    list: string;
-    get: string;
-    cancel: string;
-    watch: string;
-}
-export interface UseJobsOptions<D = unknown, R = unknown> {
-    sort?: Sort<JobRecord<D, R>>[];
+export interface UseJobsOptions {
+    sort?: Sort<JobView>[];
     /** Which store to read; the package's own when omitted. */
-    resource?: StateAlias<JobRecord>;
+    resource?: StateAlias<JobView>;
 }
 export interface JobFeedOptions {
     /** The alias root the group was declared under. */
     root?: string;
-    resource?: StateAlias<JobRecord>;
-    /** What the seeding list call asks for — `state`, `name`, `page`, `size`. */
-    query?: Record<string, string | number | undefined>;
+    resource?: StateAlias<JobView>;
+    query?: JobListQuery;
 }
 /**
  * Whether the feed is carrying anything yet, so a screen can tell "no jobs" from "not loaded".
@@ -38,5 +29,5 @@ export interface JobFeed {
     /** What the seeding call threw, if it threw. */
     error: Error | null;
 }
-export type JobFilter<D = unknown, R = unknown> = Criteria<JobRecord<D, R>>;
+export type JobFilter = Criteria<JobView>;
 //# sourceMappingURL=types.d.ts.map

package/build/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAChD,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,MAAO,SAAQ,YAAY;CAAI;AAEhD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEhF,iEAAiE;AACjE,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,GAAG,EAAE,MAAM,CAAA;IACX,MAAM,EAAE,MAAM,CAAA;IACd,KAAK,EAAE,MAAM,CAAA;CACd;AAED,MAAM,WAAW,cAAc,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO;IACtD,IAAI,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAC9B,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;CACjC;AAED,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,UAAU,CAAC,SAAS,CAAC,CAAA;IAChC,6EAA6E;IAC7E,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC,CAAA;CACpD;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAA;IACf,gDAAgD;IAChD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,MAAM,SAAS,CAAC,CAAC,GAAG,OAAO,EAAE,CAAC,GAAG,OAAO,IAAI,QAAQ,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAA;AAC5D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAA;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,OAAO,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,oBAAoB,CAAA;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAA;AAEjD,MAAM,WAAW,MAAO,SAAQ,YAAY;CAAI;AAEhD,MAAM,WAAW,OAAO,CAAC,CAAC,SAAS,MAAM,GAAG,MAAM,CAAE,SAAQ,aAAa,CAAC,CAAC,CAAC;CAAI;AAEhF,MAAM,WAAW,cAAc;IAC7B,IAAI,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,EAAE,CAAA;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;CAC/B;AAED,MAAM,WAAW,cAAc;IAC7B,mDAAmD;IACnD,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,QAAQ,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAA;IAC9B,KAAK,CAAC,EAAE,YAAY,CAAA;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,OAAO;IACtB,0BAA0B;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,4EAA4E;IAC5E,MAAM,EAAE,OAAO,CAAA;IACf,gDAAgD;IAChD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB;AAED,MAAM,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA"}

package/build/utils/event.d.ts

@@ -1,15 +1,11 @@
-import type { JobEvent, JobRecord } from '@owlmeans/queue';
+import type { JobView, JobViewEvent } from '@owlmeans/job';
 import type { StateResource } from '@owlmeans/state';
 /**
  * Fold one lifecycle frame into the store.
  *
- * The frame is merged over whatever the store holds rather than saved as itself: an event carries
- * only what changed, and `save` replaces the record. An event for an id the store never saw still
- * writes a row — a job enqueued in another tab reports its progress here too, and the next seeding
- * call fills in the rest.
- *
- * A progress frame does NOT move a settled job back to active: the broker's completion and its
- * last progress ping race, and the losing order would leave a finished job spinning forever.
+ * An upsert carries the complete sanitized public view and replaces the stored row. An event for
+ * an id the store never saw still writes a row, so an operation started in another tab reports its
+ * progress here too. A remove carries only the opaque public id.
  */
-export declare const applyJobEvent: (store: StateResource<JobRecord>, event: JobEvent) => Promise<void>;
+export declare const applyJobEvent: (store: StateResource<JobView>, event: JobViewEvent) => Promise<void>;
 //# sourceMappingURL=event.d.ts.map

package/build/utils/event.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAA;AAE1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;;;;;GAUG;AACH,eAAO,MAAM,aAAa,UACjB,aAAa,CAAC,SAAS,CAAC,SAAS,QAAQ,KAC/C,OAAO,CAAC,IAAI,CAqBd,CAAA"}
+{"version":3,"file":"event.d.ts","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AAC1D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAEpD;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,UACjB,aAAa,CAAC,OAAO,CAAC,SAAS,YAAY,KACjD,OAAO,CAAC,IAAI,CAMd,CAAA"}

package/build/utils/event.js

@@ -1,33 +1,16 @@
-import { isSettled, JobEventType, JobState } from '@owlmeans/queue';
 /**
  * Fold one lifecycle frame into the store.
  *
- * The frame is merged over whatever the store holds rather than saved as itself: an event carries
- * only what changed, and `save` replaces the record. An event for an id the store never saw still
- * writes a row — a job enqueued in another tab reports its progress here too, and the next seeding
- * call fills in the rest.
- *
- * A progress frame does NOT move a settled job back to active: the broker's completion and its
- * last progress ping race, and the losing order would leave a finished job spinning forever.
+ * An upsert carries the complete sanitized public view and replaces the stored row. An event for
+ * an id the store never saw still writes a row, so an operation started in another tab reports its
+ * progress here too. A remove carries only the opaque public id.
  */
 export const applyJobEvent = async (store, event) => {
-    const known = await store.load(event.id);
-    const change = event.type === JobEventType.Completed
-        ? { state: JobState.Completed, result: event.result }
-        : event.type === JobEventType.Failed
-            ? { state: JobState.Failed, error: event.error }
-            : {
-                progress: event.progress,
-                ...(isSettled(known?.state) ? {} : { state: JobState.Active }),
-            };
-    await store.save({
-        ...(known ?? { data: undefined }),
-        id: event.id,
-        queue: event.queue,
-        // A queue that removed the job has no name left to report — never overwrite a known one
-        // with the empty string the contract sends in its place.
-        ...(event.name !== '' ? { name: event.name } : {}),
-        ...change,
-    });
+    if (event.type === 'remove') {
+        if (await store.load(event.id) != null)
+            await store.delete(event.id);
+        return;
+    }
+    await store.save(event.job);
 };
 //# sourceMappingURL=event.js.map

package/build/utils/event.js.map

@@ -1 +1 @@
-{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,YAAY,EAAE,QAAQ,EAAE,MAAM,iBAAiB,CAAA;AAGnE;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,KAA+B,EAAE,KAAe,EACjC,EAAE;IACjB,MAAM,KAAK,GAAG,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;IAExC,MAAM,MAAM,GAAuB,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,SAAS;QACtE,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,SAAS,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE;QACrD,CAAC,CAAC,KAAK,CAAC,IAAI,KAAK,YAAY,CAAC,MAAM;YAClC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE;YAChD,CAAC,CAAC;gBACA,QAAQ,EAAE,KAAK,CAAC,QAAQ;gBACxB,GAAG,CAAC,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC;aAC/D,CAAA;IAEL,MAAM,KAAK,CAAC,IAAI,CAAC;QACf,GAAG,CAAC,KAAK,IAAI,EAAE,IAAI,EAAE,SAAoB,EAAE,CAAC;QAC5C,EAAE,EAAE,KAAK,CAAC,EAAE;QACZ,KAAK,EAAE,KAAK,CAAC,KAAK;QAClB,wFAAwF;QACxF,yDAAyD;QACzD,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAClD,GAAG,MAAM;KACV,CAAC,CAAA;AACJ,CAAC,CAAA"}
+{"version":3,"file":"event.js","sourceRoot":"","sources":["../../src/utils/event.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,EAChC,KAA6B,EAAE,KAAmB,EACnC,EAAE;IACjB,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC5B,IAAI,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,IAAI;YAAE,MAAM,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAA;QACpE,OAAM;IACR,CAAC;IACD,MAAM,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAA;AAC7B,CAAC,CAAA"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/client-job",
-  "version": "0.1.18-rc.9",
+  "version": "0.1.18",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -24,21 +24,22 @@
     "react": "*"
   },
   "devDependencies": {
-    "@owlmeans/dep-config": "workspace:*",
-    "@types/react": "^19.2.17",
+    "@owlmeans/dep-config": "^0.1.18",
+    "@types/react": "^19.3.0",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },
   "dependencies": {
-    "@owlmeans/client": "^0.1.18-rc.24",
-    "@owlmeans/client-auth": "^0.1.18-rc.29",
-    "@owlmeans/client-context": "^0.1.18-rc.21",
-    "@owlmeans/client-entrypoint": "^0.1.18-rc.21",
-    "@owlmeans/context": "^0.1.18-rc.16",
-    "@owlmeans/queue": "^0.1.18-rc.17",
-    "@owlmeans/resource": "^0.1.18-rc.17",
-    "@owlmeans/socket": "^0.1.18-rc.17",
-    "@owlmeans/state": "^0.1.18-rc.18"
+    "@owlmeans/client": "^0.1.18",
+    "@owlmeans/client-auth": "^0.1.18",
+    "@owlmeans/client-context": "^0.1.18",
+    "@owlmeans/client-entrypoint": "^0.1.18",
+    "@owlmeans/context": "^0.1.18",
+    "@owlmeans/job": "^0.1.18",
+    "@owlmeans/log": "^0.1.18",
+    "@owlmeans/resource": "^0.1.18",
+    "@owlmeans/socket": "^0.1.18",
+    "@owlmeans/state": "^0.1.18"
   },
   "publishConfig": {
     "access": "public"

package/src/consts.ts

@@ -1,18 +1,5 @@
-import type { JobRecord } from '@owlmeans/queue'
-import { stateAlias } from '@owlmeans/state'
-import type { StateAlias } from '@owlmeans/state'
+import { type StateAlias, stateAlias } from '@owlmeans/state'
+import type { JobView } from '@owlmeans/job'
 
 /** The store this package registers and every hook here reads. */
-export const JOBS: StateAlias<JobRecord> = stateAlias<JobRecord>('job-state')
-
-/**
- * The alias root a group answers under when a caller names none — the same default
- * `@owlmeans/server-job` declares with.
- *
- * That package's `<root>` / `<root>:<verb>` alias shape and its `job-event` frame name are the
- * whole contract between the two halves. They are restated here rather than imported because the
- * server half pulls fastify in, and a browser bundle must not.
- */
-export const DEFAULT_JOB_ROOT = 'jobs'
-
-export const JOB_EVENT = 'job-event'
+export const JOBS: StateAlias<JobView> = stateAlias<JobView>('job-state')

package/src/feed.ts

@@ -2,13 +2,15 @@ import { useEffect, useMemo, useState } from 'react'
 import { useContext } from '@owlmeans/client'
 import { useWs } from '@owlmeans/client-auth'
 import type { ClientEntrypoint } from '@owlmeans/client-entrypoint'
-import type { JobEvent, JobRecord } from '@owlmeans/queue'
+import { DEFAULT_JOB_ROOT, JOB_EVENT, jobEntrypointAliases, type JobView, type JobViewEvent } from '@owlmeans/job'
 import type { ListResult } from '@owlmeans/resource'
-import { DEFAULT_JOB_ROOT, JOBS, JOB_EVENT } from './consts.js'
-import { jobEntrypointAliases } from './helper.js'
+import { logger } from '@owlmeans/log'
+import { JOBS } from './consts.js'
 import type { Config, Context, JobFeed, JobFeedOptions } from './types.js'
 import { applyJobEvent } from './utils/index.js'
 
+const log = logger('client-job')
+
 /**
  * Mount the job feed: one socket, seeded once from the list entrypoint.
  *
@@ -37,8 +39,8 @@ export const useJobFeed = (opts?: JobFeedOptions): JobFeed => {
     let live = true
     void (async () => {
       try {
-        const result = await context.entrypoint<ClientEntrypoint<ListResult<JobRecord>>>(aliases.list)
-          .call<ListResult<JobRecord>>({ query: opts?.query })
+        const result = await context.entrypoint<ClientEntrypoint<ListResult<JobView>>>(aliases.list)
+          .call<ListResult<JobView>>({ query: opts?.query })
         if (!live) {
           return
         }
@@ -59,11 +61,11 @@ export const useJobFeed = (opts?: JobFeedOptions): JobFeed => {
       return
     }
     const store = context.getStateResource(alias)
-    const unsubscribe = connection.observe<JobEvent>(JOB_EVENT, async message => {
+    const unsubscribe = connection.observe<JobViewEvent>(JOB_EVENT, async message => {
       try {
         await applyJobEvent(store, message.payload)
       } catch (e) {
-        console.error('Job feed apply error:', e)
+        log.warn('Job feed apply failed', e)
       }
     })
 

package/src/helper.ts

@@ -1,30 +1,16 @@
-import { appendStateResource } from '@owlmeans/state'
-import type { StateAlias } from '@owlmeans/state'
-import type { JobRecord } from '@owlmeans/queue'
-import { DEFAULT_JOB_ROOT, JOBS } from './consts.js'
-import type { Config, Context, JobEntrypointAliases } from './types.js'
+import { appendStateResource, type StateAlias } from '@owlmeans/state'
+import type { JobView } from '@owlmeans/job'
+import { JOBS } from './consts.js'
+import type { Config, Context } from './types.js'
 
 /**
  * Register the store the job hooks read.
  *
- * Jobs get a store of their own rather than the context's default one because a job id is the
- * broker's, and sharing an id space with the app's own records is how a completed job overwrites
- * an unrelated row. Idempotent, like every `append*` — an app that calls it twice keeps whatever
- * the store already collected.
+ * Jobs get a store of their own rather than the context's default one because their opaque ids
+ * are a separate domain namespace. Sharing that id space with the app's own records is how a
+ * completed operation overwrites an unrelated row. Idempotent, like every `append*` — an app that
+ * calls it twice keeps whatever the store already collected.
  */
 export const appendJobs = <C extends Config, T extends Context<C>>(
-  context: T, alias: StateAlias<JobRecord> = JOBS
-): T => appendStateResource<C, T, JobRecord>(context, alias) as T
-
-/**
- * The aliases one job group answers under — the same shape `@owlmeans/server-job` declares.
- */
-export const jobEntrypointAliases = (
-  root: string = DEFAULT_JOB_ROOT
-): JobEntrypointAliases => ({
-  base: root,
-  list: `${root}:list`,
-  get: `${root}:get`,
-  cancel: `${root}:cancel`,
-  watch: `${root}:watch`,
-})
+  context: T, alias: StateAlias<JobView> = JOBS
+): T => appendStateResource<C, T, JobView>(context, alias) as T

package/src/hooks.ts

@@ -1,6 +1,6 @@
 import { useStoreList, useStoreModel } from '@owlmeans/client'
 import type { StateModel } from '@owlmeans/state'
-import type { JobRecord } from '@owlmeans/queue'
+import type { JobView } from '@owlmeans/job'
 import { JOBS } from './consts.js'
 import type { JobFilter, UseJobsOptions } from './types.js'
 
@@ -10,19 +10,20 @@ import type { JobFilter, UseJobsOptions } from './types.js'
  * Never throws for an id the store has not seen — the model comes back `empty`, which is what a
  * screen renders as "still loading" while {@link useJobFeed} seeds.
  */
-export const useJob = <D = unknown, R = unknown>(
+export const useJob = (
   id?: string, resource: string = JOBS
-): StateModel<JobRecord<D, R>> => useStoreModel<JobRecord<D, R>>(id, resource)
+): StateModel<JobView> => useStoreModel<JobView>(id, resource)
 
 /**
  * A live query over the job store, newest first unless told otherwise.
  *
  * The criteria is the resource language, so a filter written for the list entrypoint means the
- * same thing here: `{ state: JobState.Active }`, `{ name: 'report:build' }`, `{ 'data.target': id }`.
+ * same thing here: `{ status: JobViewStatus.Running }`, `{ kind: 'report-build' }` or an
+ * allowlisted metadata field.
  */
-export const useJobs = <D = unknown, R = unknown>(
-  filter?: JobFilter<D, R>, opts?: UseJobsOptions<D, R>
-): StateModel<JobRecord<D, R>>[] => useStoreList<JobRecord<D, R>>({
+export const useJobs = (
+  filter?: JobFilter, opts?: UseJobsOptions
+): StateModel<JobView>[] => useStoreList<JobView>({
   query: filter,
   sort: opts?.sort ?? [{ field: 'createdAt', order: 'desc' }],
   resource: opts?.resource ?? JOBS,

package/src/index.ts

@@ -1,4 +1,5 @@
 export type * from './types.js'
+export { DEFAULT_JOB_ROOT, JOB_EVENT, jobEntrypointAliases } from '@owlmeans/job'
 
 export * from './consts.js'
 export * from './helper.js'

package/src/types.ts

@@ -1,6 +1,6 @@
 import type { ClientConfig } from '@owlmeans/client-context'
 import type { ClientContext } from '@owlmeans/client'
-import type { JobRecord } from '@owlmeans/queue'
+import type { JobListQuery, JobView } from '@owlmeans/job'
 import type { Criteria, Sort } from '@owlmeans/resource'
 import type { StateAlias } from '@owlmeans/state'
 
@@ -8,27 +8,17 @@ export interface Config extends ClientConfig { }
 
 export interface Context<C extends Config = Config> extends ClientContext<C> { }
 
-/** The alias every entrypoint of one job group answers under. */
-export interface JobEntrypointAliases {
-  base: string
-  list: string
-  get: string
-  cancel: string
-  watch: string
-}
-
-export interface UseJobsOptions<D = unknown, R = unknown> {
-  sort?: Sort<JobRecord<D, R>>[]
+export interface UseJobsOptions {
+  sort?: Sort<JobView>[]
   /** Which store to read; the package's own when omitted. */
-  resource?: StateAlias<JobRecord>
+  resource?: StateAlias<JobView>
 }
 
 export interface JobFeedOptions {
   /** The alias root the group was declared under. */
   root?: string
-  resource?: StateAlias<JobRecord>
-  /** What the seeding list call asks for — `state`, `name`, `page`, `size`. */
-  query?: Record<string, string | number | undefined>
+  resource?: StateAlias<JobView>
+  query?: JobListQuery
 }
 
 /**
@@ -43,4 +33,4 @@ export interface JobFeed {
   error: Error | null
 }
 
-export type JobFilter<D = unknown, R = unknown> = Criteria<JobRecord<D, R>>
+export type JobFilter = Criteria<JobView>

package/src/utils/event.ts

@@ -1,39 +1,19 @@
-import type { JobEvent, JobRecord } from '@owlmeans/queue'
-import { isSettled, JobEventType, JobState } from '@owlmeans/queue'
+import type { JobView, JobViewEvent } from '@owlmeans/job'
 import type { StateResource } from '@owlmeans/state'
 
 /**
  * Fold one lifecycle frame into the store.
  *
- * The frame is merged over whatever the store holds rather than saved as itself: an event carries
- * only what changed, and `save` replaces the record. An event for an id the store never saw still
- * writes a row — a job enqueued in another tab reports its progress here too, and the next seeding
- * call fills in the rest.
- *
- * A progress frame does NOT move a settled job back to active: the broker's completion and its
- * last progress ping race, and the losing order would leave a finished job spinning forever.
+ * An upsert carries the complete sanitized public view and replaces the stored row. An event for
+ * an id the store never saw still writes a row, so an operation started in another tab reports its
+ * progress here too. A remove carries only the opaque public id.
  */
 export const applyJobEvent = async (
-  store: StateResource<JobRecord>, event: JobEvent
+  store: StateResource<JobView>, event: JobViewEvent
 ): Promise<void> => {
-  const known = await store.load(event.id)
-
-  const change: Partial<JobRecord> = event.type === JobEventType.Completed
-    ? { state: JobState.Completed, result: event.result }
-    : event.type === JobEventType.Failed
-      ? { state: JobState.Failed, error: event.error }
-      : {
-        progress: event.progress,
-        ...(isSettled(known?.state) ? {} : { state: JobState.Active }),
-      }
-
-  await store.save({
-    ...(known ?? { data: undefined as unknown }),
-    id: event.id,
-    queue: event.queue,
-    // A queue that removed the job has no name left to report — never overwrite a known one
-    // with the empty string the contract sends in its place.
-    ...(event.name !== '' ? { name: event.name } : {}),
-    ...change,
-  })
+  if (event.type === 'remove') {
+    if (await store.load(event.id) != null) await store.delete(event.id)
+    return
+  }
+  await store.save(event.job)
 }