@supergrowthai/tq 1.0.1-canary.a2ffe03

package/dist/src/core/task-handler.d.ts

@@ -0,0 +1,19 @@
+import { IAsyncTaskManager, IMessageQueue, ProcessedTaskResult, Processor, QueueName } from '@supergrowthai/mq';
+import { CronTask } from '../adapters/index.js';
+declare function addTasks(messageQueue: IMessageQueue, tasks: CronTask<any>[]): Promise<void>;
+declare function postProcessTasks(messageQueue: IMessageQueue, { failedTasks: failedTasksRaw, newTasks, successTasks }: ProcessedTaskResult): Promise<void>;
+declare function startConsumingTasks(messageQueue: IMessageQueue, streamName: QueueName): Promise<void>;
+declare function processMatureTasks(messageQueue: IMessageQueue): void;
+declare function taskProcessServer(messageQueue: IMessageQueue): void;
+declare function processBatch(messageQueue: IMessageQueue, queueId: QueueName, processor: Processor, limit?: number): Promise<ProcessedTaskResult>;
+declare function setAsyncTaskManager(manager: IAsyncTaskManager): void;
+declare const _default: {
+    processBatch: typeof processBatch;
+    processMatureTasks: typeof processMatureTasks;
+    startConsumingTasks: typeof startConsumingTasks;
+    postProcessTasks: typeof postProcessTasks;
+    addTasks: typeof addTasks;
+    taskProcessServer: typeof taskProcessServer;
+    setAsyncTaskManager: typeof setAsyncTaskManager;
+};
+export default _default;

package/dist/src/core/task-runner.d.ts

@@ -0,0 +1,19 @@
+import { ActionResults } from './actions/Actions.js';
+import { AsyncActions } from './actions/AsyncActions.js';
+import { CronTask } from '../adapters/index.js';
+import { IAsyncTaskManager, IMessageQueue } from '@supergrowthai/mq';
+/**
+ * Runs tasks either from a provided array or by fetching them based on task types
+ * @param taskRunnerId - Unique identifier for this run
+ * @param tasksRaw - Either an array of tasks to process or an array of task types to fetch
+ * @returns Results of task processing
+ */
+export interface AsyncTask {
+    task: CronTask<any>;
+    promise: Promise<void>;
+    startTime: number;
+    actions: AsyncActions;
+}
+export default function taskRunner(messageQueue: IMessageQueue, taskRunnerId: string, tasksRaw: Array<CronTask<any>>, asyncTaskManager?: IAsyncTaskManager): Promise<ActionResults & {
+    asyncTasks: AsyncTask[];
+}>;

package/dist/src/core/task-store.d.ts

@@ -0,0 +1,74 @@
+import { CronTask } from '../adapters/index.js';
+import { ObjectId } from 'mongodb';
+/**
+ * Adds multiple tasks to the scheduled queue
+ */
+declare function addTasksToScheduled(tasks: CronTask<any>[]): Promise<any>;
+/**
+ * Gets mature tasks that are ready to be processed
+ * Implements a two-phase approach:
+ * 1. Reset stale processing tasks
+ * 2. Fetch and mark new mature tasks
+ */
+declare function getMatureTasks(timestamp: number): Promise<CronTask<any>[]>;
+/**
+ * Marks tasks as processing with current timestamp
+ */
+declare function markTasksAsProcessing(taskIds: ObjectId[]): Promise<void>;
+/**
+ * Marks tasks as executed/completed
+ */
+declare function markTasksAsExecuted(taskIds: ObjectId[]): Promise<void>;
+/**
+ * Marks tasks as failed and increments retry count
+ */
+declare function markTasksAsFailed(taskIds: ObjectId[]): Promise<void>;
+/**
+ * Updates multiple tasks with specific updates
+ */
+declare function updateTasks(updates: Array<{
+    id: ObjectId;
+    updates: Partial<CronTask<any>>;
+}>): Promise<void>;
+/**
+ * Gets tasks by their IDs
+ */
+declare function getTasksByIds(taskIds: ObjectId[]): Promise<CronTask<any>[]>;
+/**
+ * Gets cleanup statistics
+ */
+declare function getCleanupStats(): Promise<{
+    orphanedTasks: number;
+    expiredTasks: number;
+}>;
+/**
+ * Cleans up orphaned and expired tasks
+ */
+declare function cleanupTasks(): Promise<void>;
+/**
+ * Updates tasks for retry with new execution time and retry count
+ */
+declare function updateTasksForRetry(tasks: CronTask<any>[]): Promise<void>;
+/**
+ * Marks tasks as successful/completed
+ */
+declare function markTasksAsSuccess(tasks: CronTask<any>[]): Promise<void>;
+/**
+ * Marks tasks as ignored (same as failed for now)
+ */
+declare function markTasksAsIgnored(tasks: CronTask<any>[]): Promise<void>;
+declare const TaskStore: {
+    addTasksToScheduled: typeof addTasksToScheduled;
+    getMatureTasks: typeof getMatureTasks;
+    markTasksAsProcessing: typeof markTasksAsProcessing;
+    markTasksAsExecuted: typeof markTasksAsExecuted;
+    markTasksAsFailed: typeof markTasksAsFailed;
+    updateTasks: typeof updateTasks;
+    getTasksByIds: typeof getTasksByIds;
+    getCleanupStats: typeof getCleanupStats;
+    cleanupTasks: typeof cleanupTasks;
+    updateTasksForRetry: typeof updateTasksForRetry;
+    markTasksAsSuccess: typeof markTasksAsSuccess;
+    markTasksAsIgnored: typeof markTasksAsIgnored;
+};
+export default TaskStore;

package/dist/src/index.d.ts

@@ -0,0 +1,46 @@
+import { IMessageQueue, QueueName } from '@supergrowthai/mq';
+import { TaskExecutor } from './core/base/interfaces.js';
+export * from './types.js';
+export * from './adapters/index.js';
+export { default as TaskStore } from './core/task-store.js';
+export { default as taskHandler } from './core/task-handler.js';
+export { default as taskRunner } from './core/task-runner.js';
+export { getEnabledQueues } from './core/environment.js';
+export { Actions } from './core/actions/Actions.js';
+export { AsyncActions } from './core/actions/AsyncActions.js';
+export { AsyncTaskManager } from './core/async/AsyncTaskManager.js';
+export * from './core/base/interfaces.js';
+export * from './task-registry.js';
+export { default as tId } from './utils/task-id-gen.js';
+declare class TaskQueue {
+    queueTaskExecutorMap: Map<QueueName, Map<string, TaskExecutor<any>>>;
+    /**
+     * Registers a task executor with a message queue and queue name
+     * @param messageQueue The message queue to register with
+     * @param queueName The name of the queue
+     * @param taskType The type of task
+     * @param executor The executor for the task
+     */
+    register(messageQueue: IMessageQueue, queueName: QueueName, taskType: string, executor: TaskExecutor<any>): void;
+    /**
+     * Gets the task executor for a specific queue and task type
+     * @param queueName The name of the queue
+     * @param taskType The type of task
+     * @returns The executor for the task
+     */
+    getExecutor(queueName: QueueName, taskType: string): TaskExecutor<any> | undefined;
+    /**
+     * Gets all registered queues
+     * @returns Array of queue names
+     */
+    getQueues(): QueueName[];
+    /**
+     * Gets all task types for a specific queue
+     * @param queueName The name of the queue
+     * @returns Array of task types
+     */
+    getTasksForQueue(queueName: QueueName): string[];
+}
+declare const taskQueue: TaskQueue;
+export { TaskQueue };
+export default taskQueue;

package/dist/src/task-registry.d.ts

@@ -0,0 +1,4 @@
+type TasksTypeExt = string;
+export type TasksType = TasksTypeExt;
+declare const _default: {};
+export default _default;

package/dist/src/types.d.ts

@@ -0,0 +1,2 @@
+export declare enum CronTaskType {
+}

package/dist/src/utils/task-id-gen.d.ts

@@ -0,0 +1,3 @@
+import { CronTask } from '../adapters';
+declare function tId<T>(task: CronTask<T>): any;
+export default tId;

package/dist/types.d.ts

@@ -0,0 +1,2 @@
+export * from './src/types'
+export {}

package/dist/types.js

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+var CronTaskType = /* @__PURE__ */ ((CronTaskType2) => {
+  return CronTaskType2;
+})(CronTaskType || {});
+exports.CronTaskType = CronTaskType;
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sources":["../src/types.ts"],"sourcesContent":["export enum CronTaskType {}"],"names":["CronTaskType"],"mappings":";;AAAO,IAAK,iCAAAA,kBAAL;AAAK,SAAAA;AAAA,GAAA,gBAAA,CAAA,CAAA;;"}

package/dist/types.mjs

@@ -0,0 +1,7 @@
+var CronTaskType = /* @__PURE__ */ ((CronTaskType2) => {
+  return CronTaskType2;
+})(CronTaskType || {});
+export {
+  CronTaskType
+};
+//# sourceMappingURL=types.mjs.map

package/dist/types.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.mjs","sources":["../src/types.ts"],"sourcesContent":["export enum CronTaskType {}"],"names":["CronTaskType"],"mappings":"AAAO,IAAK,iCAAAA,kBAAL;AAAK,SAAAA;AAAA,GAAA,gBAAA,CAAA,CAAA;"}

package/package.json

@@ -0,0 +1,101 @@
+{
+  "name": "@supergrowthai/tq",
+  "version": "1.0.1-canary.a2ffe03",
+  "description": "Task queue management library with multiple executor types and async task handling",
+  "repository": "https://github.com/captadexp/next-blog",
+  "homepage": "https://github.com/captadexp/next-blog/tree/main#readme",
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "require": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/types.d.ts",
+      "import": "./dist/types.mjs",
+      "require": "./dist/types.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.mjs",
+      "require": "./dist/adapters/index.js"
+    },
+    "./adapters/database": {
+      "types": "./dist/adapters/database-adapter.d.ts",
+      "import": "./dist/adapters/database-adapter.mjs",
+      "require": "./dist/adapters/database-adapter.js"
+    },
+    "./core/base/interfaces": {
+      "types": "./dist/core/base/interfaces.d.ts",
+      "import": "./dist/core/base/interfaces.mjs",
+      "require": "./dist/core/base/interfaces.js"
+    },
+    "./core/task-store": {
+      "types": "./dist/core/task-store.d.ts",
+      "import": "./dist/core/task-store.mjs",
+      "require": "./dist/core/task-store.js"
+    },
+    "./core/task-handler": {
+      "types": "./dist/core/task-handler.d.ts",
+      "import": "./dist/core/task-handler.mjs",
+      "require": "./dist/core/task-handler.js"
+    },
+    "./core/task-runner": {
+      "types": "./dist/core/task-runner.d.ts",
+      "import": "./dist/core/task-runner.mjs",
+      "require": "./dist/core/task-runner.js"
+    },
+    "./core/actions": {
+      "types": "./dist/core/actions/Actions.d.ts",
+      "import": "./dist/core/actions/Actions.mjs",
+      "require": "./dist/core/actions/Actions.js"
+    },
+    "./core/actions/async": {
+      "types": "./dist/core/actions/AsyncActions.d.ts",
+      "import": "./dist/core/actions/AsyncActions.mjs",
+      "require": "./dist/core/actions/AsyncActions.js"
+    },
+    "./core/async": {
+      "types": "./dist/core/async/AsyncTaskManager.d.ts",
+      "import": "./dist/core/async/AsyncTaskManager.mjs",
+      "require": "./dist/core/async/AsyncTaskManager.js"
+    },
+    "./utils": {
+      "types": "./dist/utils/task-id-gen.d.ts",
+      "import": "./dist/utils/task-id-gen.mjs",
+      "require": "./dist/utils/task-id-gen.js"
+    }
+  },
+  "scripts": {
+    "clean": "rm -rf dist",
+    "dev": "vite build --watch",
+    "build": "vite build",
+    "typecheck": "tsc --noEmit",
+    "prepublishOnly": "npm run build"
+  },
+  "files": [
+    "dist"
+  ],
+  "author": "Capt ADExp <tech@developer.toys>",
+  "license": "MIT",
+  "dependencies": {
+    "lodash": "^4.17.21",
+    "mongodb": "^6.16.0",
+    "moment": "^2.30.1",
+    "@supergrowthai/mq": "1.0.1-canary.a2ffe03",
+    "@supergrowthai/utils": "1.0.1"
+  },
+  "devDependencies": {
+    "@types/node": "^24.5.2",
+    "typescript": "^5.9.2",
+    "vite": "^7.1.5",
+    "vite-plugin-dts": "^4.5.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}