@ecodrix/erix-client 1.0.0 → 1.0.1

package/dist/index.d.ts

@@ -38,6 +38,29 @@ export interface RateLimitResult {
     remaining: number;
     resetAt: number;
 }
+export interface JobV2<T = JsonValue> {
+    id: string;
+    queueName: string;
+    data: T;
+    status: "waiting" | "active" | "completed" | "failed" | "delayed";
+    attempts: number;
+    maxAttempts: number;
+    priority: number;
+    createdAt: string;
+    runAt: string;
+    clientCode?: string;
+    progress?: number;
+    error?: string;
+    result?: JsonValue;
+}
+export interface EnqueueOptionsV2 {
+    priority?: number;
+    maxAttempts?: number;
+    delayMs?: number;
+    runAt?: Date | string;
+    clientCode?: string;
+    metadata?: Record<string, JsonValue>;
+}
 export declare class ErixClient {
     private readonly baseUrl;
     private readonly headers;
@@ -77,11 +100,26 @@ export declare class ErixClient {
         lpop: <T = JsonValue>(key: string) => Promise<T | null>;
     };
     queue: {
-        /** Enqueue a job payload into a named queue */
+        /** Enqueue a job payload into a named queue (simple list-based) */
         push: (name: string, data: JsonValue) => Promise<void>;
         /** Dequeue the oldest job from a named queue. Returns `null` if empty. */
         pop: <T = JsonValue>(name: string) => Promise<T | null>;
     };
+    /** Advanced Queue (v2) — supports priority, delay, retries, and persistence */
+    queueV2: {
+        /** Enqueue a job into an advanced queue */
+        push: <T = JsonValue>(queueName: string, data: T, options?: EnqueueOptionsV2) => Promise<JobV2<T>>;
+        /** Claim the next eligible job from the queue */
+        claim: <T = JsonValue>(queueName: string) => Promise<JobV2<T> | null>;
+        /** Mark a job as completed */
+        complete: (jobId: string, result?: JsonValue) => Promise<void>;
+        /** Mark a job as failed */
+        fail: (jobId: string, error: string) => Promise<void>;
+        /** Update job progress (0-100) */
+        updateProgress: (jobId: string, progress: number) => Promise<void>;
+        /** Get job by ID */
+        get: <T = JsonValue>(jobId: string) => Promise<JobV2<T> | null>;
+    };
     pubsub: {
         /** Publish a message to a channel */
         publish: (channel: string, message: JsonValue) => Promise<void>;

package/dist/index.js

@@ -81,7 +81,7 @@ export class ErixClient {
         };
         // ─── Queue (FIFO job queue, built on List) ────────────────────────────
         this.queue = {
-            /** Enqueue a job payload into a named queue */
+            /** Enqueue a job payload into a named queue (simple list-based) */
             push: async (name, data) => {
                 await this.list.rpush(`q:${name}`, data);
             },
@@ -90,6 +90,36 @@ export class ErixClient {
                 return this.list.lpop(`q:${name}`);
             },
         };
+        /** Advanced Queue (v2) — supports priority, delay, retries, and persistence */
+        this.queueV2 = {
+            /** Enqueue a job into an advanced queue */
+            push: async (queueName, data, options = {}) => {
+                const res = await this.req("POST", `/queue/v2/${queueName}/jobs`, { data, ...options });
+                return res.job;
+            },
+            /** Claim the next eligible job from the queue */
+            claim: async (queueName) => {
+                const res = await this.req("POST", `/queue/v2/${queueName}/claim`);
+                return res.job;
+            },
+            /** Mark a job as completed */
+            complete: async (jobId, result) => {
+                await this.req("POST", `/queue/v2/jobs/${jobId}/complete`, { result });
+            },
+            /** Mark a job as failed */
+            fail: async (jobId, error) => {
+                await this.req("POST", `/queue/v2/jobs/${jobId}/fail`, { error });
+            },
+            /** Update job progress (0-100) */
+            updateProgress: async (jobId, progress) => {
+                await this.req("PATCH", `/queue/v2/jobs/${jobId}/progress`, { progress });
+            },
+            /** Get job by ID */
+            get: async (jobId) => {
+                const res = await this.req("GET", `/queue/v2/jobs/${jobId}`);
+                return res.job;
+            },
+        };
         // ─── PubSub ───────────────────────────────────────────────────────────
         this.pubsub = {
             /** Publish a message to a channel */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ecodrix/erix-client",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Type-safe HTTP client for the erix-store in-memory data service. Zero dependencies — uses native fetch.",
   "type": "module",
   "main": "./dist/index.js",
@@ -15,10 +15,6 @@
     "dist",
     "README.md"
   ],
-  "scripts": {
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
-  },
   "keywords": [
     "erix-store",
     "cache",
@@ -42,5 +38,8 @@
   "repository": {
     "type": "git",
     "url": "https://github.com/dhanesh125/erix-store"
+  },
+  "scripts": {
+    "build": "tsc"
   }
-}
+}