@ivan-pasco/clean-node-server 0.1.49 → 0.1.50

package/dist/bridge/jobs.d.ts

@@ -1,35 +1,92 @@
+import { WasmState } from '../types';
+export type JobStatus = 'pending' | 'running' | 'succeeded' | 'failed' | 'cancelled';
+export type BackoffStrategy = 'fixed' | 'exponential';
+interface JobConfig {
+    name: string;
+    handler: string;
+    maxAttempts: number;
+    backoff: BackoffStrategy;
+    delayMs: number;
+    timeoutMs: number;
+    queue: string;
+}
+interface JobRecord {
+    id: string;
+    name: string;
+    args: string;
+    status: JobStatus;
+    attempt: number;
+    maxAttempts: number;
+    backoff: BackoffStrategy;
+    delayMs: number;
+    timeoutMs: number;
+    queue: string;
+    handler: string;
+    scheduledAt: number;
+    createdAt: number;
+    updatedAt: number;
+    finishedAt: number | null;
+    result: string | null;
+    error: string | null;
+}
 /**
- * frame.jobs (background job queue) bridge — node-server stubs.
- *
- * The frame.jobs runtime is implemented in clean-server (Rust) at
- * clean-server/src/jobs.rs — FIFO queue with SQLite persistence,
- * retry/backoff state machine, worker pool, and request-scoped current-job
- * accessors.
- *
- * Porting to TypeScript is tracked in
- * foundation/management/cross-component-prompts/
- *   all-host-bridge-parity-enforcement.md (Step 4 — node-server jobs).
- *
- * These stubs satisfy the WASM linker contract so apps using `jobs:` blocks
- * can instantiate on node-server, but any actual queue call fails loudly
- * instead of crashing in WASM linking or silently dropping work.
- *
- * Signature reference: foundation/platform-architecture/function-registry.toml
- * (entries with category = "jobs").
+ * Start the jobs worker against the provided WASM instance. Idempotent.
+ * Opens the SQLite store, ensures schema, recovers pending records, and
+ * begins polling every `WORKER_POLL_MS` ms.
  */
-import { WasmState } from '../types';
-export declare function createJobsBridge(_getState: () => WasmState): {
-    _job_register(_namePtr: number, _maxAttempts: number, _backoffPtr: number, _baseMs: number, _maxMs: number, _retriesPtr: number, _timeoutPtr: number): void;
-    _job_enqueue(_namePtr: number, _argsPtr: number): number;
-    _job_enqueue_at(_namePtr: number, _argsPtr: number, _epochMs: number): number;
-    _job_cancel(_idPtr: number): number;
-    _job_status(_idPtr: number): number;
-    _job_result(_idPtr: number): number;
+export declare function startJobWorker(state: WasmState): void;
+/** Stop the worker, clear in-memory state and the DB handle. */
+export declare function stopJobWorker(): void;
+/** Test-only synchronous tick — runs one poll/dispatch cycle. */
+export declare function _runJobWorkerTickForTest(): void;
+/** Test-only registry snapshot. */
+export declare function _getJobsSnapshotForTest(): {
+    configs: JobConfig[];
+    records: Omit<JobRecord, 'updatedAt' | 'createdAt'>[];
+};
+export declare function createJobsBridge(getState: () => WasmState): {
+    /**
+     * Register a job handler.
+     * Registry: params=["string","string","i32","string","i32","i32","string"], returns="void"
+     * WASM args: (name_ptr,name_len, handler_ptr,handler_len, max_attempts:i32,
+     *             backoff_ptr,backoff_len, delay:i32, timeout:i32,
+     *             queue_ptr,queue_len)
+     */
+    _job_register(namePtr: number, nameLen: number, handlerPtr: number, handlerLen: number, maxAttempts: number, backoffPtr: number, backoffLen: number, delayMs: number, timeoutMs: number, queuePtr: number, queueLen: number): void;
+    /**
+     * Enqueue a job for immediate execution.
+     * Registry: params=["string","string"], returns="ptr" (LP string job ID).
+     */
+    _job_enqueue(namePtr: number, nameLen: number, argsPtr: number, argsLen: number): number;
+    /**
+     * Schedule a job at a specific Unix epoch ms (f64).
+     * Registry: params=["string","string","number"], returns="ptr".
+     * NaN / negative timestamps are clamped to 0 (run immediately).
+     */
+    _job_enqueue_at(namePtr: number, nameLen: number, argsPtr: number, argsLen: number, runAtMs: number): number;
+    /**
+     * Cancel a pending job.
+     * Registry: params=["string"], returns="boolean" — clean-server's wrapper
+     * returns 0 = cancelled, -1 = not found / not pending. Both are i32 at
+     * the WASM-shape layer; node-server matches the runtime values exactly.
+     */
+    _job_cancel(idPtr: number, idLen: number): number;
+    /** Return current status string (LP). */
+    _job_status(idPtr: number, idLen: number): number;
+    /** Return result/error string (LP). */
+    _job_result(idPtr: number, idLen: number): number;
+    /** Current job id inside a handler — empty string outside. */
     _job_current_id(): number;
+    /** Current job args inside a handler — empty string outside. */
     _job_current_args(): number;
+    /** Current attempt number (1-based) — 0 outside. */
     _job_current_attempt(): number;
-    _job_retry_after(_delayMs: number): void;
-    _job_fail(_msgPtr: number): void;
-    _job_succeed(_resultPtr: number): void;
+    /** Override the backoff delay for this attempt's retry. */
+    _job_retry_after(delayMs: number): void;
+    /** Mark the current attempt as a permanent failure. */
+    _job_fail(reasonPtr: number, reasonLen: number): void;
+    /** Mark the current attempt as succeeded with the given JSON result. */
+    _job_succeed(resultPtr: number, resultLen: number): void;
 };
+export {};
 //# sourceMappingURL=jobs.d.ts.map

package/dist/bridge/jobs.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/bridge/jobs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAWrC,wBAAgB,gBAAgB,CAAC,SAAS,EAAE,MAAM,SAAS;4BAG3C,MAAM,gBAAgB,MAAM,eAAe,MAAM,WAClD,MAAM,UAAU,MAAM,eAAe,MAAM,eAAe,MAAM,GACxE,IAAI;2BAIgB,MAAM,YAAY,MAAM,GAAG,MAAM;8BAI9B,MAAM,YAAY,MAAM,YAAY,MAAM,GAAG,MAAM;wBAIzD,MAAM,GAAG,MAAM;wBAIf,MAAM,GAAG,MAAM;wBAIf,MAAM,GAAG,MAAM;uBAIhB,MAAM;yBAIJ,MAAM;4BAIH,MAAM;+BAIH,MAAM,GAAG,IAAI;uBAIrB,MAAM,GAAG,IAAI;6BAIP,MAAM,GAAG,IAAI;EAIzC"}
+{"version":3,"file":"jobs.d.ts","sourceRoot":"","sources":["../../src/bridge/jobs.ts"],"names":[],"mappings":"AAkCA,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAiBrC,MAAM,MAAM,SAAS,GACjB,SAAS,GACT,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB,MAAM,MAAM,eAAe,GAAG,OAAO,GAAG,aAAa,CAAC;AAkBtD,UAAU,SAAS;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,UAAU,SAAS;IACjB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,CAAC;IAClB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,eAAe,CAAC;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;CACtB;AAsYD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,SAAS,GAAG,IAAI,CAgBrD;AAED,gEAAgE;AAChE,wBAAgB,aAAa,IAAI,IAAI,CAcpC;AAED,iEAAiE;AACjE,wBAAgB,wBAAwB,IAAI,IAAI,CAE/C;AAED,mCAAmC;AACnC,wBAAgB,uBAAuB,IAAI;IACzC,OAAO,EAAE,SAAS,EAAE,CAAC;IACrB,OAAO,EAAE,IAAI,CAAC,SAAS,EAAE,WAAW,GAAG,WAAW,CAAC,EAAE,CAAC;CACvD,CASA;AA2HD,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,SAAS;IAEtD;;;;;;OAMG;2BAEQ,MAAM,WAAW,MAAM,cACpB,MAAM,cAAc,MAAM,eACzB,MAAM,cACP,MAAM,cAAc,MAAM,WAC7B,MAAM,aACJ,MAAM,YACP,MAAM,YAAY,MAAM,GACjC,IAAI;IASP;;;OAGG;0BAEQ,MAAM,WAAW,MAAM,WACvB,MAAM,WAAW,MAAM,GAC/B,MAAM;IAQT;;;;OAIG;6BAEQ,MAAM,WAAW,MAAM,WACvB,MAAM,WAAW,MAAM,WACvB,MAAM,GACd,MAAM;IAST;;;;;OAKG;uBACgB,MAAM,SAAS,MAAM,GAAG,MAAM;IAMjD,yCAAyC;uBACtB,MAAM,SAAS,MAAM,GAAG,MAAM;IAMjD,uCAAuC;uBACpB,MAAM,SAAS,MAAM,GAAG,MAAM;IAMjD,8DAA8D;uBAC3C,MAAM;IAKzB,gEAAgE;yBAC3C,MAAM;IAK3B,oDAAoD;4BAC5B,MAAM;IAI9B,2DAA2D;8BACjC,MAAM,GAAG,IAAI;IAKvC,uDAAuD;yBAClC,MAAM,aAAa,MAAM,GAAG,IAAI;IAOrD,wEAAwE;4BAChD,MAAM,aAAa,MAAM,GAAG,IAAI;EAO3D"}