convex-batch-processor 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Blocksight
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,395 @@
+# convex-batch-processor
+
+A Convex component for batch processing:
+
+1. **Batch Accumulator** - Collect items and flush when reaching size threshold or time interval
+2. **Table Iterator** - Process large tables in controlled batch sizes with pause/resume support
+
+## Installation
+
+```bash
+npm install convex-batch-processor
+```
+
+## Setup
+
+Add the component to your Convex app:
+
+```typescript
+// convex/convex.config.ts
+import { defineApp } from "convex/server";
+import batchProcessor from "convex-batch-processor/convex.config";
+
+const app = defineApp();
+app.use(batchProcessor);
+
+export default app;
+```
+
+## Usage
+
+### Batch Accumulator
+
+The batch accumulator collects items and flushes them based on:
+- **Time interval**: Flush automatically after `flushIntervalMs` (primary trigger for high-throughput small items)
+- **Size threshold**: Immediate flush when a single call adds `>= maxBatchSize` items
+- **Manual trigger**: Force flush via API call
+
+```typescript
+import { mutation, internalAction } from "./_generated/server";
+import { internal, components } from "./_generated/api";
+import { BatchProcessor } from "convex-batch-processor";
+import { v } from "convex/values";
+
+// Define the event schema
+const analyticsEventValidator = v.object({
+  eventName: v.string(),
+  properties: v.optional(v.record(v.string(), v.string())),
+  timestamp: v.number(),
+});
+
+type AnalyticsEvent = typeof analyticsEventValidator.type;
+
+// Create a batch processor with config
+// Note: Explicit type annotation is required when the file also exports Convex functions
+const batchProcessor: BatchProcessor<AnalyticsEvent> = new BatchProcessor(components.batchProcessor, {
+  maxBatchSize: 100,
+  flushIntervalMs: 30000,
+  processBatch: internal.analytics.processEventsBatch,
+});
+
+// Define the batch processor (must be an action)
+export const processEventsBatch = internalAction({
+  args: { items: v.array(analyticsEventValidator) },
+  handler: async (ctx, { items }) => {
+    await fetch("https://api.analytics.com/batch", {
+      method: "POST",
+      body: JSON.stringify({ events: items }),
+    });
+  },
+});
+
+// Add items to a batch
+export const trackEvent = mutation({
+  args: {
+    eventName: v.string(),
+    properties: v.optional(v.record(v.string(), v.string())),
+  },
+  handler: async (ctx, { eventName, properties }) => {
+    const event: AnalyticsEvent = { eventName, properties, timestamp: Date.now() };
+
+    return await batchProcessor.addItems(ctx, "analytics-events", [event]);
+  },
+});
+
+// Manual flush
+await batchProcessor.flush(ctx, "analytics-events");
+
+// Get batch status
+await batchProcessor.getBatchStatus(ctx, "analytics-events");
+
+// Get flush history
+await batchProcessor.getFlushHistory(ctx, "analytics-events");
+```
+
+The interval flush is scheduled automatically when the first item is added to a batch. No cron job is required.
+
+### Table Iterator
+
+The table iterator processes large datasets using a callback-based design:
+
+1. **You provide**: `getNextBatch` (query) + `processBatch` (action)
+2. **Component handles**: Scheduling, progress tracking, retries, pause/resume
+
+```typescript
+import { mutation, query, internalQuery, internalAction, internalMutation } from "./_generated/server";
+import { internal, components } from "./_generated/api";
+import { BatchProcessor } from "convex-batch-processor";
+import { v } from "convex/values";
+
+// Define the user schema
+const userValidator = v.object({
+  _id: v.id("users"),
+  _creationTime: v.number(),
+  name: v.string(),
+  email: v.string(),
+});
+
+type User = typeof userValidator.type;
+
+// For iterator-only usage, config is optional
+const batchProcessor = new BatchProcessor(components.batchProcessor);
+
+export const startMigration = mutation({
+  args: {},
+  handler: async (ctx) => {
+    const jobId = `migration-${Date.now()}`;
+
+    await batchProcessor.startIterator<User>(ctx, jobId, {
+      batchSize: 100,
+      delayBetweenBatchesMs: 100,
+      getNextBatch: internal.migrations.getNextBatch,
+      processBatch: internal.migrations.processBatch,
+      onComplete: internal.migrations.onComplete,
+      maxRetries: 5,
+    });
+
+    return { jobId };
+  },
+});
+
+export const getNextBatch = internalQuery({
+  args: {
+    cursor: v.optional(v.string()),
+    batchSize: v.number(),
+  },
+  handler: async (ctx, { cursor, batchSize }) => {
+    const results = await ctx.db
+      .query("users")
+      .paginate({ cursor: cursor ?? null, numItems: batchSize });
+
+    return {
+      items: results.page,
+      cursor: results.continueCursor,
+      done: results.isDone,
+    };
+  },
+});
+
+export const processBatch = internalAction({
+  args: { items: v.array(userValidator) },
+  handler: async (ctx, { items }) => {
+    for (const user of items) {
+      await migrateUser(user);
+    }
+  },
+});
+
+export const onComplete = internalMutation({
+  args: {
+    jobId: v.string(),
+    processedCount: v.number(),
+  },
+  handler: async (ctx, { jobId, processedCount }) => {
+    console.log(`Migration ${jobId} completed: ${processedCount} users`);
+  },
+});
+```
+
+#### Job Control
+
+```typescript
+export const pause = mutation({
+  args: { jobId: v.string() },
+  handler: async (ctx, { jobId }) => {
+    return await batchProcessor.pauseIterator(ctx, jobId);
+  },
+});
+
+export const resume = mutation({
+  args: { jobId: v.string() },
+  handler: async (ctx, { jobId }) => {
+    return await batchProcessor.resumeIterator(ctx, jobId);
+  },
+});
+
+export const cancel = mutation({
+  args: { jobId: v.string() },
+  handler: async (ctx, { jobId }) => {
+    return await batchProcessor.cancelIterator(ctx, jobId);
+  },
+});
+
+export const getStatus = query({
+  args: { jobId: v.string() },
+  handler: async (ctx, { jobId }) => {
+    return await batchProcessor.getIteratorStatus(ctx, jobId);
+  },
+});
+
+export const listJobs = query({
+  args: { status: v.optional(v.string()) },
+  handler: async (ctx, { status }) => {
+    return await batchProcessor.listIteratorJobs(ctx, { status });
+  },
+});
+```
+
+## API Reference
+
+### BatchProcessor Class
+
+#### Batch Accumulator Methods
+
+| Method | Description |
+|--------|-------------|
+| `addItems(ctx, batchId, items)` | Add items to a batch |
+| `flush(ctx, batchId)` | Force flush a batch |
+| `getBatchStatus(ctx, batchId)` | Get batch status |
+| `getFlushHistory(ctx, batchId, limit?)` | Get flush history |
+| `deleteBatch(ctx, batchId)` | Delete a completed batch |
+
+#### Table Iterator Methods
+
+| Method | Description |
+|--------|-------------|
+| `startIterator(ctx, jobId, config)` | Start a new iterator job |
+| `pauseIterator(ctx, jobId)` | Pause a running job |
+| `resumeIterator(ctx, jobId)` | Resume a paused job |
+| `cancelIterator(ctx, jobId)` | Cancel a job |
+| `getIteratorStatus(ctx, jobId)` | Get job status |
+| `listIteratorJobs(ctx, options?)` | List jobs |
+| `deleteIteratorJob(ctx, jobId)` | Delete a completed job |
+
+### Types
+
+#### BatchConfig
+
+```typescript
+interface BatchConfig<T = unknown> {
+  maxBatchSize: number;
+  flushIntervalMs: number;
+  processBatch: FunctionReference<"action", "internal", { items: T[] }>;
+}
+```
+
+**`processBatch` Requirements:**
+
+The `processBatch` **must be a Convex action** (not a mutation or plain JavaScript function). This is because:
+- The batch processor is called via `ctx.runAction()` internally
+- Actions can perform async operations like HTTP requests, which is the typical use case for batch processing (e.g., sending events to an external analytics service)
+
+Pass the function reference directly:
+
+```typescript
+const batchProcessor: BatchProcessor<MyEvent> = new BatchProcessor(components.batchProcessor, {
+  maxBatchSize: 100,
+  flushIntervalMs: 30000,
+  processBatch: internal.myModule.processBatch,
+});
+```
+
+If you only need to write to the database (no external calls), you can still use an action that calls a mutation internally:
+
+```typescript
+export const processBatch = internalAction({
+  args: { items: v.array(myItemValidator) },
+  handler: async (ctx, { items }) => {
+    await ctx.runMutation(internal.myModule.writeBatchToDb, { items });
+  },
+});
+```
+
+#### BatchResult
+
+Returned by `addItems()`:
+
+```typescript
+interface BatchResult {
+  batchId: string;      // Same ID you passed in
+  itemCount: number;    // Items added in THIS call (use getBatchStatus for total)
+  flushed: boolean;     // Whether batch was flushed
+  status: BatchStatus;  // "accumulating" | "flushing" | "completed"
+}
+```
+
+#### BatchStatusResult
+
+Returned by `getBatchStatus()`:
+
+```typescript
+interface BatchStatusResult {
+  batchId: string;  // Same ID you passed in
+  batches: Array<{
+    status: "accumulating" | "flushing";
+    itemCount: number;
+    createdAt: number;
+    lastUpdatedAt: number;
+  }>;
+  config: {
+    maxBatchSize: number;
+    flushIntervalMs: number;
+  };
+}
+```
+
+The `batches` array contains all active batches. Typically there's one, but during flush there may be both a flushing batch and a new accumulating batch.
+
+#### IteratorConfig
+
+```typescript
+interface IteratorConfig<T = unknown> {
+  batchSize: number;
+  delayBetweenBatchesMs?: number;
+  getNextBatch: FunctionReference<"query", "internal", { cursor: string | undefined; batchSize: number }>;
+  processBatch: FunctionReference<"action", "internal", { items: T[] }>;
+  onComplete?: FunctionReference<"mutation", "internal", { jobId: string; processedCount: number }>;
+  maxRetries?: number;
+}
+```
+
+#### Callback Types
+
+```typescript
+interface GetNextBatchResult<T = unknown> {
+  items: T[];
+  cursor: string | undefined;
+  done: boolean;
+}
+
+interface ProcessBatchArgs<T = unknown> {
+  items: T[];
+}
+
+interface OnCompleteArgs {
+  jobId: string;
+  processedCount: number;
+}
+```
+
+## TypeScript Notes
+
+### Explicit Type Annotation Required
+
+When creating a `BatchProcessor` with config in a file that also exports Convex functions (mutations, queries, actions), you must add an explicit type annotation:
+
+```typescript
+// ✅ Correct - explicit type annotation
+const batchProcessor: BatchProcessor<MyEvent> = new BatchProcessor(components.batchProcessor, {
+  processBatch: internal.myModule.processBatch,
+  // ...
+});
+
+// ❌ Will cause error TS7022
+const batchProcessor = new BatchProcessor<MyEvent>(components.batchProcessor, {
+  processBatch: internal.myModule.processBatch,
+  // ...
+});
+```
+
+This is due to circular type inference: TypeScript can't infer the type because the `internal` API types are generated from your file's exports, creating a circular dependency. The explicit annotation breaks this cycle.
+
+## Error Handling
+
+### Batch Accumulator
+- Failed flushes are recorded in `flushHistory`
+- Items are preserved for retry (batch reverts to "accumulating" state)
+
+### Table Iterator
+- Automatic retry with exponential backoff (1s, 2s, 4s... up to 30s)
+- Job marked as "failed" after `maxRetries` attempts
+- Error messages preserved in job status
+
+## Development
+
+```bash
+pnpm install
+pnpm run build
+pnpm test
+pnpm run lint
+pnpm run format
+```
+
+## License
+
+MIT

package/dist/client/index.d.ts

@@ -0,0 +1,212 @@
+import { type FunctionReference, type GenericMutationCtx, type GenericQueryCtx } from "convex/server";
+export type BatchStatus = "accumulating" | "flushing" | "completed";
+export type JobStatus = "pending" | "running" | "paused" | "completed" | "failed";
+export interface BatchConfig<T = unknown> {
+    maxBatchSize: number;
+    flushIntervalMs: number;
+    processBatch: FunctionReference<"action", "internal", {
+        items: T[];
+    }>;
+}
+export interface IteratorConfig<T = unknown> {
+    batchSize: number;
+    delayBetweenBatchesMs?: number;
+    getNextBatch: FunctionReference<"query", "internal", {
+        cursor: string | undefined;
+        batchSize: number;
+    }>;
+    processBatch: FunctionReference<"action", "internal", {
+        items: T[];
+    }>;
+    onComplete?: FunctionReference<"mutation", "internal", {
+        jobId: string;
+        processedCount: number;
+    }>;
+    maxRetries?: number;
+}
+interface InternalBatchConfig {
+    maxBatchSize: number;
+    flushIntervalMs: number;
+    processBatchHandle: string;
+}
+interface InternalIteratorConfig {
+    batchSize: number;
+    delayBetweenBatchesMs?: number;
+    getNextBatchHandle: string;
+    processBatchHandle: string;
+    onCompleteHandle?: string;
+    maxRetries?: number;
+}
+export interface BatchResult {
+    batchId: string;
+    itemCount: number;
+    flushed: boolean;
+    status: BatchStatus;
+}
+export interface FlushResult {
+    batchId: string;
+    itemCount: number;
+    flushed: boolean;
+    status?: BatchStatus;
+    reason?: string;
+}
+export interface BatchStatusResult {
+    batchId: string;
+    batches: Array<{
+        status: "accumulating" | "flushing";
+        itemCount: number;
+        createdAt: number;
+        lastUpdatedAt: number;
+    }>;
+    config: {
+        maxBatchSize: number;
+        flushIntervalMs: number;
+    };
+}
+export interface BatchListItem {
+    batchId: string;
+    baseBatchId: string;
+    sequence: number;
+    itemCount: number;
+    status: BatchStatus;
+    createdAt: number;
+    lastUpdatedAt: number;
+}
+export interface JobResult {
+    jobId: string;
+    status: JobStatus;
+}
+export interface JobStatusResult {
+    jobId: string;
+    status: JobStatus;
+    processedCount: number;
+    cursor?: string;
+    retryCount: number;
+    errorMessage?: string;
+    createdAt: number;
+    lastRunAt?: number;
+    config: {
+        batchSize: number;
+        delayBetweenBatchesMs: number;
+    };
+}
+export interface JobListItem {
+    jobId: string;
+    status: JobStatus;
+    processedCount: number;
+    createdAt: number;
+    lastRunAt?: number;
+    errorMessage?: string;
+}
+export interface FlushHistoryItem {
+    batchId: string;
+    itemCount: number;
+    flushedAt: number;
+    durationMs: number;
+    success: boolean;
+    errorMessage?: string;
+}
+export interface BatchProcessorAPI {
+    lib: {
+        addItems: FunctionReference<"mutation", "internal", {
+            batchId: string;
+            items: unknown[];
+            config: InternalBatchConfig;
+        }, BatchResult>;
+        flushBatch: FunctionReference<"mutation", "internal", {
+            batchId: string;
+        }, FlushResult>;
+        getBatchStatus: FunctionReference<"query", "internal", {
+            batchId: string;
+        }, BatchStatusResult | null>;
+        getFlushHistory: FunctionReference<"query", "internal", {
+            batchId: string;
+            limit?: number;
+        }, FlushHistoryItem[]>;
+        getAllBatchesForBaseId: FunctionReference<"query", "internal", {
+            baseBatchId: string;
+        }, BatchListItem[]>;
+        deleteBatch: FunctionReference<"mutation", "internal", {
+            batchId: string;
+        }, {
+            deleted: boolean;
+            reason?: string;
+        }>;
+        startIteratorJob: FunctionReference<"mutation", "internal", {
+            jobId: string;
+            config: InternalIteratorConfig;
+        }, JobResult>;
+        pauseIteratorJob: FunctionReference<"mutation", "internal", {
+            jobId: string;
+        }, JobResult>;
+        resumeIteratorJob: FunctionReference<"mutation", "internal", {
+            jobId: string;
+        }, JobResult>;
+        cancelIteratorJob: FunctionReference<"mutation", "internal", {
+            jobId: string;
+        }, JobResult & {
+            reason?: string;
+        }>;
+        getIteratorJobStatus: FunctionReference<"query", "internal", {
+            jobId: string;
+        }, JobStatusResult | null>;
+        listIteratorJobs: FunctionReference<"query", "internal", {
+            status?: JobStatus;
+            limit?: number;
+        }, JobListItem[]>;
+        deleteIteratorJob: FunctionReference<"mutation", "internal", {
+            jobId: string;
+        }, {
+            deleted: boolean;
+            reason?: string;
+        }>;
+    };
+}
+export declare class BatchProcessor<T = unknown> {
+    private component;
+    private config?;
+    private processBatchHandle;
+    constructor(component: BatchProcessorAPI, config?: BatchConfig<T>);
+    addItems(ctx: GenericMutationCtx<any>, batchId: string, items: T[]): Promise<BatchResult>;
+    flush(ctx: GenericMutationCtx<any>, batchId: string): Promise<FlushResult>;
+    getBatchStatus(ctx: GenericQueryCtx<any>, batchId: string): Promise<BatchStatusResult | null>;
+    getFlushHistory(ctx: GenericQueryCtx<any>, batchId: string, limit?: number): Promise<FlushHistoryItem[]>;
+    getAllBatchesForBaseId(ctx: GenericQueryCtx<any>, baseBatchId: string): Promise<BatchListItem[]>;
+    deleteBatch(ctx: GenericMutationCtx<any>, batchId: string): Promise<{
+        deleted: boolean;
+        reason?: string;
+    }>;
+    startIterator<T>(ctx: GenericMutationCtx<any>, jobId: string, config: IteratorConfig<T>): Promise<JobResult>;
+    pauseIterator(ctx: GenericMutationCtx<any>, jobId: string): Promise<JobResult>;
+    resumeIterator(ctx: GenericMutationCtx<any>, jobId: string): Promise<JobResult>;
+    cancelIterator(ctx: GenericMutationCtx<any>, jobId: string): Promise<JobResult & {
+        reason?: string;
+    }>;
+    getIteratorStatus(ctx: GenericQueryCtx<any>, jobId: string): Promise<JobStatusResult | null>;
+    listIteratorJobs(ctx: GenericQueryCtx<any>, options?: {
+        status?: JobStatus;
+        limit?: number;
+    }): Promise<JobListItem[]>;
+    deleteIteratorJob(ctx: GenericMutationCtx<any>, jobId: string): Promise<{
+        deleted: boolean;
+        reason?: string;
+    }>;
+}
+export interface GetNextBatchResult<T = unknown> {
+    items: T[];
+    cursor: string | undefined;
+    done: boolean;
+}
+export interface GetNextBatchArgs {
+    cursor: string | undefined;
+    batchSize: number;
+}
+export interface ProcessBatchArgs<T = unknown> {
+    items: T[];
+}
+export interface OnCompleteArgs {
+    jobId: string;
+    processedCount: number;
+}
+export {};
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"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"}