flashq 0.1.0

package/dist/client/dlq.js

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDlq = getDlq;
+exports.retryDlq = retryDlq;
+exports.purgeDlq = purgeDlq;
+/**
+ * Get jobs from the dead letter queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @param count - Max jobs to return (default: 100)
+ * @returns Array of failed jobs
+ *
+ * @example
+ * ```typescript
+ * const failed = await client.getDlq('emails', 50);
+ * console.log(`${failed.length} jobs in DLQ`);
+ * ```
+ */
+async function getDlq(client, queue, count = 100) {
+    const response = await client.send({
+        cmd: 'DLQ',
+        queue,
+        count,
+    });
+    return response.jobs;
+}
+/**
+ * Retry jobs from the dead letter queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @param jobId - Optional specific job ID to retry
+ * @returns Number of jobs retried
+ *
+ * @example
+ * ```typescript
+ * // Retry all jobs in DLQ
+ * const retried = await client.retryDlq('emails');
+ *
+ * // Retry specific job
+ * await client.retryDlq('emails', 123);
+ * ```
+ */
+async function retryDlq(client, queue, jobId) {
+    const response = await client.send({
+        cmd: 'RETRYDLQ',
+        queue,
+        id: jobId,
+    });
+    return response.ids?.[0] ?? 0;
+}
+/**
+ * Purge all jobs from the dead letter queue.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Queue name
+ * @returns Number of jobs purged
+ *
+ * @example
+ * ```typescript
+ * const purged = await client.purgeDlq('emails');
+ * console.log(`Purged ${purged} failed jobs`);
+ * ```
+ */
+async function purgeDlq(client, queue) {
+    const response = await client.send({
+        cmd: 'PURGEDLQ',
+        queue,
+    });
+    return response.count;
+}
+//# sourceMappingURL=dlq.js.map

package/dist/client/dlq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dlq.js","sourceRoot":"","sources":["../../src/client/dlq.ts"],"names":[],"mappings":";;AAmBA,wBAWC;AAmBD,4BAWC;AAeD,4BASC;AA/ED;;;;;;;;;;;;;GAaG;AACI,KAAK,UAAU,MAAM,CAC1B,MAAqB,EACrB,KAAa,EACb,KAAK,GAAG,GAAG;IAEX,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAA+B;QAC/D,GAAG,EAAE,KAAK;QACV,KAAK;QACL,KAAK;KACN,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED;;;;;;;;;;;;;;;;GAgBG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAAqB,EACrB,KAAa,EACb,KAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAiC;QACjE,GAAG,EAAE,UAAU;QACf,KAAK;QACL,EAAE,EAAE,KAAK;KACV,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;AAChC,CAAC;AAED;;;;;;;;;;;;GAYG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAAqB,EACrB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAAiC;QACjE,GAAG,EAAE,UAAU;QACf,KAAK;KACN,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,KAAK,CAAC;AACxB,CAAC"}

package/dist/client/flows.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Flow operations (parent-child job dependencies)
+ */
+import type { IFlashQClient, FlowChild, FlowResult, FlowOptions } from './types';
+/**
+ * Push a flow (parent job with children).
+ * The parent job waits until all children complete before becoming ready.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Parent queue name
+ * @param parentData - Parent job data
+ * @param children - Array of child jobs
+ * @param options - Flow options
+ * @returns Parent and children IDs
+ *
+ * @example
+ * ```typescript
+ * const flow = await client.pushFlow(
+ *   'reports',
+ *   { reportType: 'monthly' },
+ *   [
+ *     { queue: 'process', data: { section: 'sales' } },
+ *     { queue: 'process', data: { section: 'marketing' } },
+ *     { queue: 'process', data: { section: 'operations' } },
+ *   ]
+ * );
+ * console.log('Parent:', flow.parent_id);
+ * console.log('Children:', flow.children_ids);
+ * ```
+ */
+export declare function pushFlow<T = unknown>(client: IFlashQClient, queue: string, parentData: T, children: FlowChild[], options?: FlowOptions): Promise<FlowResult>;
+/**
+ * Get children job IDs for a parent job in a flow.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Parent job ID
+ * @returns Array of children job IDs
+ *
+ * @example
+ * ```typescript
+ * const childIds = await client.getChildren(parentJobId);
+ * for (const id of childIds) {
+ *   const child = await client.getJob(id);
+ *   console.log(`Child ${id}: ${child?.state}`);
+ * }
+ * ```
+ */
+export declare function getChildren(client: IFlashQClient, jobId: number): Promise<number[]>;
+//# sourceMappingURL=flows.d.ts.map

package/dist/client/flows.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.d.ts","sourceRoot":"","sources":["../../src/client/flows.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAEjF;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAsB,QAAQ,CAAC,CAAC,GAAG,OAAO,EACxC,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,CAAC,EACb,QAAQ,EAAE,SAAS,EAAE,EACrB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,UAAU,CAAC,CAgBrB;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAsB,WAAW,CAC/B,MAAM,EAAE,aAAa,EACrB,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,MAAM,EAAE,CAAC,CAMnB"}

package/dist/client/flows.js

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushFlow = pushFlow;
+exports.getChildren = getChildren;
+/**
+ * Push a flow (parent job with children).
+ * The parent job waits until all children complete before becoming ready.
+ *
+ * @param client - FlashQ client instance
+ * @param queue - Parent queue name
+ * @param parentData - Parent job data
+ * @param children - Array of child jobs
+ * @param options - Flow options
+ * @returns Parent and children IDs
+ *
+ * @example
+ * ```typescript
+ * const flow = await client.pushFlow(
+ *   'reports',
+ *   { reportType: 'monthly' },
+ *   [
+ *     { queue: 'process', data: { section: 'sales' } },
+ *     { queue: 'process', data: { section: 'marketing' } },
+ *     { queue: 'process', data: { section: 'operations' } },
+ *   ]
+ * );
+ * console.log('Parent:', flow.parent_id);
+ * console.log('Children:', flow.children_ids);
+ * ```
+ */
+async function pushFlow(client, queue, parentData, children, options = {}) {
+    const response = await client.send({
+        cmd: 'FLOW',
+        queue,
+        data: parentData,
+        children,
+        priority: options.priority ?? 0,
+    });
+    return {
+        parent_id: response.parent_id,
+        children_ids: response.children_ids,
+    };
+}
+/**
+ * Get children job IDs for a parent job in a flow.
+ *
+ * @param client - FlashQ client instance
+ * @param jobId - Parent job ID
+ * @returns Array of children job IDs
+ *
+ * @example
+ * ```typescript
+ * const childIds = await client.getChildren(parentJobId);
+ * for (const id of childIds) {
+ *   const child = await client.getJob(id);
+ *   console.log(`Child ${id}: ${child?.state}`);
+ * }
+ * ```
+ */
+async function getChildren(client, jobId) {
+    const response = await client.send({
+        cmd: 'GETCHILDREN',
+        parent_id: jobId,
+    });
+    return response.children_ids;
+}
+//# sourceMappingURL=flows.js.map

package/dist/client/flows.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flows.js","sourceRoot":"","sources":["../../src/client/flows.ts"],"names":[],"mappings":";;AA+BA,4BAsBC;AAkBD,kCASC;AA3ED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACI,KAAK,UAAU,QAAQ,CAC5B,MAAqB,EACrB,KAAa,EACb,UAAa,EACb,QAAqB,EACrB,UAAuB,EAAE;IAEzB,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAI/B;QACD,GAAG,EAAE,MAAM;QACX,KAAK;QACL,IAAI,EAAE,UAAU;QAChB,QAAQ;QACR,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,CAAC;KAChC,CAAC,CAAC;IACH,OAAO;QACL,SAAS,EAAE,QAAQ,CAAC,SAAS;QAC7B,YAAY,EAAE,QAAQ,CAAC,YAAY;KACpC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACI,KAAK,UAAU,WAAW,CAC/B,MAAqB,EACrB,KAAa;IAEb,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,IAAI,CAA0C;QAC1E,GAAG,EAAE,aAAa;QAClB,SAAS,EAAE,KAAK;KACjB,CAAC,CAAC;IACH,OAAO,QAAQ,CAAC,YAAY,CAAC;AAC/B,CAAC"}