@shipload/sdk 1.0.0-next.61 → 1.0.0-next.62

package/package.json

@@ -1,7 +1,7 @@
 {
     "name": "@shipload/sdk",
     "description": "SDKs for Shipload",
-    "version": "1.0.0-next.61",
+    "version": "1.0.0-next.62",
     "homepage": "https://github.com/shipload/toolkit/tree/master/packages/sdk",
     "repository": {
         "type": "git",

package/src/index-module.ts

@@ -51,6 +51,7 @@ export {
     computeFreeCells,
     NftManager,
     ConstructionManager,
+    JobsManager,
 } from './managers'
 export type {GridCell, ClusterCell, Cluster} from './managers'
 export type {
@@ -288,8 +289,15 @@ export type {
 export {taskCargoChanges} from './scheduling/task-cargo'
 export type {TaskCargoChange, TaskCargoDirection} from './scheduling/task-cargo'
 
-export {jobsToLanes, pickFabricator, socketTail, JOB_QUEUE_CAP} from './scheduling/jobs'
-export type {JobWindow, JobLane, JobLaneEntry} from './scheduling/jobs'
+export {
+    jobsToLanes,
+    pickFabricator,
+    socketTail,
+    JOB_QUEUE_CAP,
+    jobStatus,
+    splitJobCargo,
+} from './scheduling/jobs'
+export type {JobWindow, JobLane, JobLaneEntry, JobStatus, OwnedJob} from './scheduling/jobs'
 
 export {composeIdleResolve} from './scheduling/idle-resolve'
 export type {CounterpartLookup, IdleResolveTarget} from './scheduling/idle-resolve'

package/src/managers/context.ts

@@ -11,6 +11,7 @@ import {EpochsManager} from './epochs'
 import {ActionsManager} from './actions'
 import {ClusterManager} from './cluster'
 import {NftManager} from './nft'
+import {JobsManager} from './jobs'
 import {SubscriptionsManager} from '../subscriptions/manager'
 
 export class GameContext {
@@ -22,6 +23,7 @@ export class GameContext {
     private _actions?: ActionsManager
     private _clusters?: ClusterManager
     private _nft?: NftManager
+    private _jobs?: JobsManager
     private _subscriptions?: SubscriptionsManager
     private _subscriptionsUrl?: string
 
@@ -91,6 +93,13 @@ export class GameContext {
         return this._nft
     }
 
+    get jobs(): JobsManager {
+        if (!this._jobs) {
+            this._jobs = new JobsManager(this)
+        }
+        return this._jobs
+    }
+
     setSubscriptionsUrl(url: string) {
         this._subscriptionsUrl = url
     }

package/src/managers/index.ts

@@ -12,6 +12,7 @@ export {ClusterManager, computeFreeCells} from './cluster'
 export type {GridCell, ClusterCell, Cluster} from './cluster'
 export {NftManager} from './nft'
 export type {NftConfigForItem} from './nft'
+export {JobsManager} from './jobs'
 export {PlotManager} from './plot'
 export type {PlotProgress, PlotProgressInputRow} from './plot'
 export {ConstructionManager} from './construction'

package/src/managers/jobs.test.ts

@@ -0,0 +1,62 @@
+import {describe, expect, it} from 'bun:test'
+import {Name} from '@wharfkit/antelope'
+import {JobsManager} from './jobs'
+
+const OWNER = 'eggmaple.gm'
+const row = (over: Record<string, unknown> = {}) => ({
+    id: {toNumber: () => 7},
+    workshop: {toNumber: () => 42},
+    socket: {toNumber: () => 0},
+    owner: Name.from(OWNER),
+    ship_id: {toNumber: () => 100},
+    coords: {x: {toNumber: () => 12}, y: {toNumber: () => 34}},
+    starts_at: {toDate: () => new Date('2026-07-26T10:00:00Z')},
+    completes_at: {toDate: () => new Date('2026-07-26T11:00:00Z')},
+    recipe_id: {toNumber: () => 10001},
+    quantity: {toNumber: () => 5},
+    energy_paid: {toNumber: () => 0},
+    cargo: [{item: 'in'}, {item: 'out'}],
+    ...over,
+})
+
+function managerWith(queryImpl: () => Promise<unknown[]>, allImpl: () => Promise<unknown[]>) {
+    const table = () => ({query: () => ({all: queryImpl}), all: allImpl})
+    const ctx = {server: {table}} as never
+    return new JobsManager(ctx)
+}
+
+describe('JobsManager.getOwnedJobs', () => {
+    it('parses owner rows: output = last cargo, inputs = rest, status derived', async () => {
+        const m = managerWith(
+            async () => [row()],
+            async () => []
+        )
+        const jobs = await m.getOwnedJobs(OWNER, {now: new Date('2026-07-26T11:30:00Z')})
+        expect(jobs).toHaveLength(1)
+        expect(jobs[0]).toMatchObject({id: 7, workshop: 42, quantity: 5, status: 'ready'})
+        expect(jobs[0].coords).toEqual({x: 12, y: 34})
+        expect(jobs[0].output).toEqual({item: 'out'} as never)
+        expect(jobs[0].inputs).toEqual([{item: 'in'}] as never)
+    })
+
+    it('drops rows whose owner does not match (positional-index safety re-filter)', async () => {
+        const other = row({owner: Name.from('someoneelse.gm')})
+        const m = managerWith(
+            async () => [row(), other],
+            async () => []
+        )
+        const jobs = await m.getOwnedJobs(OWNER)
+        expect(jobs).toHaveLength(1)
+    })
+
+    it('falls back to a full-scan .all() when the positional query throws', async () => {
+        const m = managerWith(
+            async () => {
+                throw new Error('bad index_position')
+            },
+            async () => [row()]
+        )
+        const jobs = await m.getOwnedJobs(OWNER)
+        expect(jobs).toHaveLength(1)
+    })
+})

package/src/managers/jobs.ts

@@ -0,0 +1,52 @@
+import {Name, type NameType} from '@wharfkit/antelope'
+import {BaseManager} from './base'
+import {jobStatus, splitJobCargo, type OwnedJob} from '../scheduling/jobs'
+import type {ServerContract} from '../contracts'
+
+type JobRow = ServerContract.Types.job_row
+
+export class JobsManager extends BaseManager {
+    async getOwnedJobs(owner: NameType, opts?: {now?: Date}): Promise<OwnedJob[]> {
+        const ownerName = Name.from(owner)
+        const now = opts?.now ?? new Date()
+
+        let rows: JobRow[]
+        try {
+            // index_position 'tertiary' = nodeos slot 3 = owner's secondary index; no ABI metadata for it.
+            rows = (await this.server
+                .table('jobs')
+                .query({
+                    index_position: 'tertiary',
+                    key_type: 'i64',
+                    from: ownerName.value,
+                    to: ownerName.value,
+                })
+                .all()) as JobRow[]
+        } catch {
+            rows = (await this.server.table('jobs').all()) as JobRow[]
+        }
+
+        return rows.filter((r) => ownerName.equals(r.owner)).map((r) => this.parseOwnedJob(r, now))
+    }
+
+    private parseOwnedJob(r: JobRow, now: Date): OwnedJob {
+        const startsAt = r.starts_at.toDate()
+        const completesAt = r.completes_at.toDate()
+        const {output, inputs} = splitJobCargo(r.cargo)
+        return {
+            id: r.id.toNumber(),
+            workshop: r.workshop.toNumber(),
+            socket: r.socket.toNumber(),
+            shipId: r.ship_id.toNumber(),
+            coords: {x: r.coords.x.toNumber(), y: r.coords.y.toNumber()},
+            startsAt,
+            completesAt,
+            recipeId: r.recipe_id.toNumber(),
+            quantity: r.quantity.toNumber(),
+            status: jobStatus({startsAt, completesAt}, now),
+            output,
+            inputs,
+            outputStats: output?.stats === undefined ? undefined : BigInt(output.stats.toString()),
+        }
+    }
+}

package/src/scheduling/jobs.test.ts

@@ -0,0 +1,32 @@
+import {describe, expect, it} from 'bun:test'
+import {jobStatus, splitJobCargo} from './jobs'
+
+const at = (s: string) => new Date(s)
+
+describe('jobStatus', () => {
+    const job = {startsAt: at('2026-07-26T10:00:00Z'), completesAt: at('2026-07-26T11:00:00Z')}
+    it('is waiting before startsAt', () => {
+        expect(jobStatus(job, at('2026-07-26T09:59:59Z'))).toBe('waiting')
+    })
+    it('is crafting between startsAt and completesAt', () => {
+        expect(jobStatus(job, at('2026-07-26T10:30:00Z'))).toBe('crafting')
+    })
+    it('is ready at or after completesAt', () => {
+        expect(jobStatus(job, at('2026-07-26T11:00:00Z'))).toBe('ready')
+        expect(jobStatus(job, at('2026-07-26T12:00:00Z'))).toBe('ready')
+    })
+})
+
+describe('splitJobCargo', () => {
+    it('takes the last element as output, the rest as inputs', () => {
+        const cargo = [{n: 'a'}, {n: 'b'}, {n: 'out'}] as unknown as Parameters<
+            typeof splitJobCargo
+        >[0]
+        const {output, inputs} = splitJobCargo(cargo)
+        expect(output).toEqual({n: 'out'} as never)
+        expect(inputs).toEqual([{n: 'a'}, {n: 'b'}] as never)
+    })
+    it('returns null output for empty cargo', () => {
+        expect(splitJobCargo([])).toEqual({output: null, inputs: []})
+    })
+})

package/src/scheduling/jobs.ts

@@ -1,3 +1,7 @@
+import type {ServerContract} from '../contracts'
+
+type CargoItem = ServerContract.Types.cargo_item
+
 export interface JobWindow {
     id: number
     socket: number
@@ -6,6 +10,8 @@ export interface JobWindow {
     completesAt: Date
     recipeId: number
     quantity: number
+    /** Packed stat roll of the job's output, when the source carried the job's cargo. */
+    outputStats?: bigint
 }
 
 export interface JobLaneEntry {
@@ -69,3 +75,34 @@ export function pickFabricator(
     }
     return best
 }
+
+export type JobStatus = 'waiting' | 'crafting' | 'ready'
+
+export function jobStatus(job: {startsAt: Date; completesAt: Date}, now: Date): JobStatus {
+    if (now < job.startsAt) return 'waiting'
+    if (now < job.completesAt) return 'crafting'
+    return 'ready'
+}
+
+// Generic in the element so raw chain JSON (readonly actions) splits by the same rule as decoded rows.
+export function splitJobCargo<T>(cargo: readonly T[]): {output: T | null; inputs: T[]} {
+    if (cargo.length === 0) return {output: null, inputs: []}
+    return {output: cargo[cargo.length - 1], inputs: cargo.slice(0, -1)}
+}
+
+export interface OwnedJob {
+    id: number
+    workshop: number
+    socket: number
+    shipId: number
+    coords: {x: number; y: number}
+    startsAt: Date
+    completesAt: Date
+    recipeId: number
+    quantity: number
+    status: JobStatus
+    output: CargoItem | null
+    inputs: CargoItem[]
+    /** Packed stat roll of `output`, so every job shape answers this the same way. */
+    outputStats?: bigint
+}

package/src/shipload.ts

@@ -12,6 +12,7 @@ import type {EpochsManager} from './managers/epochs'
 import type {ActionsManager} from './managers/actions'
 import type {ClusterManager} from './managers/cluster'
 import type {NftManager} from './managers/nft'
+import type {JobsManager} from './managers/jobs'
 import type {SubscriptionsManager} from './subscriptions/manager'
 import type {GameState} from './entities/gamestate'
 
@@ -132,6 +133,10 @@ export class Shipload {
         return this._context.nft
     }
 
+    get jobs(): JobsManager {
+        return this._context.jobs
+    }
+
     get subscriptions(): SubscriptionsManager {
         return this._context.subscriptions
     }