batchwork 0.0.0 → 1.0.0

package/dist/providers/xai.d.ts

@@ -0,0 +1,8 @@
+import type { BatchAdapter } from "./adapter";
+/**
+ * xAI (Grok) batch adapter. Uses xAI's OpenAI-compatible file-upload path
+ * (`/v1/files` + `/v1/batches` with `input_file_id`), but its status, paginated
+ * `/results`, and `:cancel` shapes are proprietary.
+ */
+export declare const xaiAdapter: BatchAdapter;
+//# sourceMappingURL=xai.d.ts.map

package/dist/providers/xai.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xai.d.ts","sourceRoot":"","sources":["../../src/providers/xai.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,YAAY,EAAe,MAAM,WAAW,CAAC;AAyK3D;;;;GAIG;AACH,eAAO,MAAM,UAAU,EAAE,YAMxB,CAAC"}

package/dist/redis/batch-store.d.ts

@@ -0,0 +1,15 @@
+import type { BatchStore } from "../server/types";
+import type { RedisStoreOptions } from "./types";
+/** Options for {@link createRedisStore}. */
+export type RedisBatchStoreOptions = RedisStoreOptions;
+/**
+ * A Redis-backed {@link BatchStore} for the poller, over `@upstash/redis`. Each
+ * tracked batch is a JSON value at `{prefix}:batch:{id}`, with a set index at
+ * `{prefix}:batches` so `list` can enumerate them.
+ *
+ * @example
+ * import { Redis } from "@upstash/redis";
+ * const store = createRedisStore({ redis: Redis.fromEnv() });
+ */
+export declare const createRedisStore: (options: RedisBatchStoreOptions) => BatchStore;
+//# sourceMappingURL=batch-store.d.ts.map

package/dist/redis/batch-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-store.d.ts","sourceRoot":"","sources":["../../src/redis/batch-store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,iBAAiB,CAAC;AAEhE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAEjD,4CAA4C;AAC5C,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC;AAEvD;;;;;;;;GAQG;AACH,eAAO,MAAM,gBAAgB,YAClB,sBAAsB,KAC9B,UAsCF,CAAC"}

package/dist/redis/index.d.ts

@@ -0,0 +1,4 @@
+export { createRedisStore } from "./batch-store";
+export type { RedisBatchStoreOptions } from "./batch-store";
+export { DEFAULT_PREFIX, type RedisClient, type RedisStoreOptions, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/redis/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,YAAY,EAAE,sBAAsB,EAAE,MAAM,eAAe,CAAC;AAC5D,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,iBAAiB,GACvB,MAAM,SAAS,CAAC"}

package/dist/redis/index.js

@@ -0,0 +1,55 @@
+import"../chunk-v0bahtg2.js";
+
+// src/redis/types.ts
+var DEFAULT_PREFIX = "batchwork";
+var coerce = (value) => {
+  if (value === null || value === undefined) {
+    return null;
+  }
+  return typeof value === "string" ? JSON.parse(value) : value;
+};
+
+// src/redis/batch-store.ts
+var createRedisStore = (options) => {
+  const { redis } = options;
+  const prefix = options.prefix ?? DEFAULT_PREFIX;
+  const batchKey = (id) => `${prefix}:batch:${id}`;
+  const indexKey = `${prefix}:batches`;
+  return {
+    delete: async (id) => {
+      await redis.del(batchKey(id));
+      await redis.srem(indexKey, id);
+    },
+    get: async (id) => coerce(await redis.get(batchKey(id))),
+    list: async (filter) => {
+      const ids = await redis.smembers(indexKey);
+      if (ids.length === 0) {
+        return [];
+      }
+      const raws = await redis.mget(...ids.map(batchKey));
+      const records = [];
+      for (const raw of raws) {
+        const record = coerce(raw);
+        if (record) {
+          records.push(record);
+        }
+      }
+      if (filter?.delivered === undefined) {
+        return records;
+      }
+      const { delivered } = filter;
+      return records.filter((record) => record.deliveredAt !== undefined === delivered);
+    },
+    set: async (record) => {
+      await redis.set(batchKey(record.id), JSON.stringify(record));
+      await redis.sadd(indexKey, record.id);
+    }
+  };
+};
+export {
+  createRedisStore,
+  DEFAULT_PREFIX
+};
+
+//# debugId=80E91990D446837F64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/redis/index.js.map

@@ -0,0 +1,11 @@
+{
+  "version": 3,
+  "sources": ["../src/redis/types.ts", "../src/redis/batch-store.ts"],
+  "sourcesContent": [
+    "import type { Redis } from \"@upstash/redis\";\n\n/** The Upstash Redis client batchwork's adapters drive. */\nexport type RedisClient = Redis;\n\n/** Options for the Redis-backed batch store. */\nexport interface RedisStoreOptions {\n  /** A connected `@upstash/redis` client. */\n  redis: Redis;\n  /** Key namespace, so one Redis can back many apps. Defaults to `batchwork`. */\n  prefix?: string;\n}\n\nexport const DEFAULT_PREFIX = \"batchwork\";\n\n/**\n * Read a stored value back into a record. `@upstash/redis` may or may not\n * auto-deserialize depending on the client's config, and values returned from\n * Lua (`eval`) are always raw strings — so tolerate both an object and a JSON\n * string, and treat a missing key as `null`.\n */\nexport const coerce = <T>(value: unknown): T | null => {\n  if (value === null || value === undefined) {\n    return null;\n  }\n  return (typeof value === \"string\" ? JSON.parse(value) : value) as T;\n};\n",
+    "import type { BatchStore, TrackedBatch } from \"../server/types\";\nimport { coerce, DEFAULT_PREFIX } from \"./types\";\nimport type { RedisStoreOptions } from \"./types\";\n\n/** Options for {@link createRedisStore}. */\nexport type RedisBatchStoreOptions = RedisStoreOptions;\n\n/**\n * A Redis-backed {@link BatchStore} for the poller, over `@upstash/redis`. Each\n * tracked batch is a JSON value at `{prefix}:batch:{id}`, with a set index at\n * `{prefix}:batches` so `list` can enumerate them.\n *\n * @example\n * import { Redis } from \"@upstash/redis\";\n * const store = createRedisStore({ redis: Redis.fromEnv() });\n */\nexport const createRedisStore = (\n  options: RedisBatchStoreOptions\n): BatchStore => {\n  const { redis } = options;\n  const prefix = options.prefix ?? DEFAULT_PREFIX;\n  const batchKey = (id: string): string => `${prefix}:batch:${id}`;\n  const indexKey = `${prefix}:batches`;\n\n  return {\n    delete: async (id) => {\n      await redis.del(batchKey(id));\n      await redis.srem(indexKey, id);\n    },\n    get: async (id) => coerce<TrackedBatch>(await redis.get(batchKey(id))),\n    list: async (filter) => {\n      const ids = await redis.smembers(indexKey);\n      if (ids.length === 0) {\n        return [];\n      }\n      const raws = await redis.mget<unknown[]>(...ids.map(batchKey));\n      const records: TrackedBatch[] = [];\n      for (const raw of raws) {\n        const record = coerce<TrackedBatch>(raw);\n        if (record) {\n          records.push(record);\n        }\n      }\n      if (filter?.delivered === undefined) {\n        return records;\n      }\n      const { delivered } = filter;\n      return records.filter(\n        (record) => (record.deliveredAt !== undefined) === delivered\n      );\n    },\n    set: async (record) => {\n      await redis.set(batchKey(record.id), JSON.stringify(record));\n      await redis.sadd(indexKey, record.id);\n    },\n  };\n};\n"
+  ],
+  "mappings": ";;;AAaO,IAAM,iBAAiB;AAQvB,IAAM,SAAS,CAAI,UAA6B;AAAA,EACrD,IAAI,UAAU,QAAQ,UAAU,WAAW;AAAA,IACzC,OAAO;AAAA,EACT;AAAA,EACA,OAAQ,OAAO,UAAU,WAAW,KAAK,MAAM,KAAK,IAAI;AAAA;;;ACTnD,IAAM,mBAAmB,CAC9B,YACe;AAAA,EACf,QAAQ,UAAU;AAAA,EAClB,MAAM,SAAS,QAAQ,UAAU;AAAA,EACjC,MAAM,WAAW,CAAC,OAAuB,GAAG,gBAAgB;AAAA,EAC5D,MAAM,WAAW,GAAG;AAAA,EAEpB,OAAO;AAAA,IACL,QAAQ,OAAO,OAAO;AAAA,MACpB,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC;AAAA,MAC5B,MAAM,MAAM,KAAK,UAAU,EAAE;AAAA;AAAA,IAE/B,KAAK,OAAO,OAAO,OAAqB,MAAM,MAAM,IAAI,SAAS,EAAE,CAAC,CAAC;AAAA,IACrE,MAAM,OAAO,WAAW;AAAA,MACtB,MAAM,MAAM,MAAM,MAAM,SAAS,QAAQ;AAAA,MACzC,IAAI,IAAI,WAAW,GAAG;AAAA,QACpB,OAAO,CAAC;AAAA,MACV;AAAA,MACA,MAAM,OAAO,MAAM,MAAM,KAAgB,GAAG,IAAI,IAAI,QAAQ,CAAC;AAAA,MAC7D,MAAM,UAA0B,CAAC;AAAA,MACjC,WAAW,OAAO,MAAM;AAAA,QACtB,MAAM,SAAS,OAAqB,GAAG;AAAA,QACvC,IAAI,QAAQ;AAAA,UACV,QAAQ,KAAK,MAAM;AAAA,QACrB;AAAA,MACF;AAAA,MACA,IAAI,QAAQ,cAAc,WAAW;AAAA,QACnC,OAAO;AAAA,MACT;AAAA,MACA,QAAQ,cAAc;AAAA,MACtB,OAAO,QAAQ,OACb,CAAC,WAAY,OAAO,gBAAgB,cAAe,SACrD;AAAA;AAAA,IAEF,KAAK,OAAO,WAAW;AAAA,MACrB,MAAM,MAAM,IAAI,SAAS,OAAO,EAAE,GAAG,KAAK,UAAU,MAAM,CAAC;AAAA,MAC3D,MAAM,MAAM,KAAK,UAAU,OAAO,EAAE;AAAA;AAAA,EAExC;AAAA;",
+  "debugId": "80E91990D446837F64756E2164756E21",
+  "names": []
+}

package/dist/redis/types.d.ts

@@ -0,0 +1,19 @@
+import type { Redis } from "@upstash/redis";
+/** The Upstash Redis client batchwork's adapters drive. */
+export type RedisClient = Redis;
+/** Options for the Redis-backed batch store. */
+export interface RedisStoreOptions {
+    /** A connected `@upstash/redis` client. */
+    redis: Redis;
+    /** Key namespace, so one Redis can back many apps. Defaults to `batchwork`. */
+    prefix?: string;
+}
+export declare const DEFAULT_PREFIX = "batchwork";
+/**
+ * Read a stored value back into a record. `@upstash/redis` may or may not
+ * auto-deserialize depending on the client's config, and values returned from
+ * Lua (`eval`) are always raw strings — so tolerate both an object and a JSON
+ * string, and treat a missing key as `null`.
+ */
+export declare const coerce: <T>(value: unknown) => T | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/redis/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/redis/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,gBAAgB,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,MAAM,WAAW,GAAG,KAAK,CAAC;AAEhC,gDAAgD;AAChD,MAAM,WAAW,iBAAiB;IAChC,2CAA2C;IAC3C,KAAK,EAAE,KAAK,CAAC;IACb,+EAA+E;IAC/E,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,eAAO,MAAM,cAAc,cAAc,CAAC;AAE1C;;;;;GAKG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,SAAS,OAAO,KAAG,CAAC,GAAG,IAK9C,CAAC"}

package/dist/server/events.d.ts

@@ -0,0 +1,5 @@
+import type { BatchProvider, BatchSnapshot } from "../types";
+import type { BatchWebhookEvent } from "./types";
+/** Map a terminal snapshot to the unified webhook event batchwork delivers. */
+export declare const toEvent: (provider: BatchProvider, snapshot: BatchSnapshot) => BatchWebhookEvent;
+//# sourceMappingURL=events.d.ts.map

package/dist/server/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../../src/server/events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAe,MAAM,UAAU,CAAC;AAC1E,OAAO,KAAK,EAAE,iBAAiB,EAAyB,MAAM,SAAS,CAAC;AASxE,+EAA+E;AAC/E,eAAO,MAAM,OAAO,aACR,aAAa,YACb,aAAa,KACtB,iBAOD,CAAC"}

package/dist/server/index.d.ts

@@ -0,0 +1,7 @@
+export { createBatchPoller } from "./poller";
+export type { BatchPoller, BatchPollerOptions, CompletionSink, CredentialResolver, OpenAIWebhookOptions, TickResult, TrackOptions, TrackTarget, } from "./poller";
+export { signWebhook, verifyBatchWebhook, verifyWebhook } from "./signing";
+export type { VerifiedWebhook } from "./signing";
+export { createMemoryStore } from "./store";
+export type { BatchStore, BatchWebhookEvent, BatchWebhookEventType, TrackedBatch, } from "./types";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,UAAU,CAAC;AAC7C,YAAY,EACV,WAAW,EACX,kBAAkB,EAClB,cAAc,EACd,kBAAkB,EAClB,oBAAoB,EACpB,UAAU,EACV,YAAY,EACZ,WAAW,GACZ,MAAM,UAAU,CAAC;AAClB,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAC3E,YAAY,EAAE,eAAe,EAAE,MAAM,WAAW,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAC5C,YAAY,EACV,UAAU,EACV,iBAAiB,EACjB,qBAAqB,EACrB,YAAY,GACb,MAAM,SAAS,CAAC"}

package/dist/server/index.js

@@ -0,0 +1,19 @@
+import {
+  createBatchPoller,
+  createMemoryStore,
+  signWebhook,
+  verifyBatchWebhook,
+  verifyWebhook
+} from "../chunk-zp2cxkyb.js";
+import"../chunk-kv3847wy.js";
+import"../chunk-v0bahtg2.js";
+export {
+  verifyWebhook,
+  verifyBatchWebhook,
+  signWebhook,
+  createMemoryStore,
+  createBatchPoller
+};
+
+//# debugId=C585C9F747001A8C64756E2164756E21
+//# sourceMappingURL=index.js.map

package/dist/server/index.js.map

@@ -0,0 +1,9 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [
+  ],
+  "mappings": "",
+  "debugId": "C585C9F747001A8C64756E2164756E21",
+  "names": []
+}

package/dist/server/poller.d.ts

@@ -0,0 +1,60 @@
+import type { BatchProvider, BatchSnapshot, BatchStatus, ProviderCredentials } from "../types";
+import type { BatchStore, TrackedBatch } from "./types";
+/** Credentials for polling: a fixed config, or one resolved per provider. */
+export type CredentialResolver = ProviderCredentials | ((provider: BatchProvider) => ProviderCredentials);
+/**
+ * Handles a batch reaching a terminal status. Replaces the default signed
+ * webhook delivery — e.g. to invoke a callback instead (see `batchwork/next`).
+ */
+export type CompletionSink = (record: TrackedBatch, snapshot: BatchSnapshot) => Promise<void>;
+export interface BatchPollerOptions {
+    store: BatchStore;
+    /** Falls back to provider env vars (e.g. `OPENAI_API_KEY`) when omitted. */
+    credentials?: CredentialResolver;
+    /** Replaces signed-webhook delivery when a batch finishes. */
+    onComplete?: CompletionSink;
+    /**
+     * Called when processing a single batch throws during `tick`. When provided,
+     * the tick reports the error and continues to the next batch; when omitted,
+     * the error propagates out of `tick`.
+     */
+    onError?: (record: TrackedBatch, error: unknown) => void;
+}
+export interface TrackTarget {
+    id: string;
+    provider: BatchProvider;
+    status?: BatchStatus;
+}
+export interface TrackOptions {
+    /** Where to POST the completion webhook. Omit for callback-based delivery. */
+    webhookUrl?: string;
+    /** Signs the outbound webhook (Standard Webhooks HMAC) when provided. */
+    secret?: string;
+}
+export interface TickResult {
+    checked: number;
+    delivered: string[];
+    /** Batches whose processing threw this tick (only when `onError` is set). */
+    failed?: {
+        id: string;
+        error: string;
+    }[];
+}
+export interface OpenAIWebhookOptions {
+    /** The OpenAI webhook signing secret (`whsec_…`). */
+    signingSecret: string;
+}
+export interface BatchPoller {
+    track: (target: TrackTarget, options: TrackOptions) => Promise<TrackedBatch>;
+    tick: () => Promise<TickResult>;
+    deliver: (record: TrackedBatch, snapshot: BatchSnapshot) => Promise<void>;
+    openaiWebhookHandler: (options: OpenAIWebhookOptions) => (request: Request) => Promise<Response>;
+}
+/**
+ * Create a managed poller: register submitted batches with `track`, then run
+ * `tick` on a schedule (cron) to poll open batches and deliver one unified,
+ * signed webhook per batch when it finishes. For OpenAI, mount
+ * `openaiWebhookHandler` to skip polling and react to native webhooks instead.
+ */
+export declare const createBatchPoller: (options: BatchPollerOptions) => BatchPoller;
+//# sourceMappingURL=poller.d.ts.map

package/dist/server/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../../src/server/poller.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,WAAW,EACX,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAGlB,OAAO,KAAK,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAExD,6EAA6E;AAC7E,MAAM,MAAM,kBAAkB,GAC1B,mBAAmB,GACnB,CAAC,CAAC,QAAQ,EAAE,aAAa,KAAK,mBAAmB,CAAC,CAAC;AAEvD;;;GAGG;AACH,MAAM,MAAM,cAAc,GAAG,CAC3B,MAAM,EAAE,YAAY,EACpB,QAAQ,EAAE,aAAa,KACpB,OAAO,CAAC,IAAI,CAAC,CAAC;AAEnB,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,UAAU,CAAC;IAClB,4EAA4E;IAC5E,WAAW,CAAC,EAAE,kBAAkB,CAAC;IACjC,8DAA8D;IAC9D,UAAU,CAAC,EAAE,cAAc,CAAC;IAC5B;;;;OAIG;IACH,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CAC1D;AAED,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,yEAAyE;IACzE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,6EAA6E;IAC7E,MAAM,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC1C;AAED,MAAM,WAAW,oBAAoB;IACnC,qDAAqD;IACrD,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,YAAY,KAAK,OAAO,CAAC,YAAY,CAAC,CAAC;IAC7E,IAAI,EAAE,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC;IAChC,OAAO,EAAE,CAAC,MAAM,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC1E,oBAAoB,EAAE,CACpB,OAAO,EAAE,oBAAoB,KAC1B,CAAC,OAAO,EAAE,OAAO,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CAC9C;AAoCD;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB,YAAa,kBAAkB,KAAG,WA2H/D,CAAC"}

package/dist/server/signing.d.ts

@@ -0,0 +1,20 @@
+import type { BatchWebhookEvent } from "./types";
+/** Build Standard Webhooks signature headers for an outbound delivery. */
+export declare const signWebhook: (secret: string, id: string, body: string, timestampSeconds: number) => Promise<Record<string, string>>;
+export interface VerifiedWebhook {
+    id: string;
+    timestamp: number;
+    body: string;
+}
+/**
+ * Verify a Standard Webhooks-signed request and return its raw body. Throws if
+ * headers are missing, the timestamp is outside tolerance, or no signature
+ * matches. Consumes the request body.
+ */
+export declare const verifyWebhook: (request: Request, secret: string) => Promise<VerifiedWebhook>;
+/**
+ * Verify and parse a batchwork webhook on your receiving endpoint. Returns the
+ * unified {@link BatchWebhookEvent}.
+ */
+export declare const verifyBatchWebhook: (request: Request, secret: string) => Promise<BatchWebhookEvent>;
+//# sourceMappingURL=signing.d.ts.map

package/dist/server/signing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"signing.d.ts","sourceRoot":"","sources":["../../src/server/signing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,SAAS,CAAC;AA8DjD,0EAA0E;AAC1E,eAAO,MAAM,WAAW,WACd,MAAM,MACV,MAAM,QACJ,MAAM,oBACM,MAAM,KACvB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAQhC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;GAIG;AACH,eAAO,MAAM,aAAa,YACf,OAAO,UACR,MAAM,KACb,OAAO,CAAC,eAAe,CAsCzB,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,kBAAkB,YACpB,OAAO,UACR,MAAM,KACb,OAAO,CAAC,iBAAiB,CAG3B,CAAC"}

package/dist/server/store.d.ts

@@ -0,0 +1,4 @@
+import type { BatchStore } from "./types";
+/** An in-memory `BatchStore`. Suitable for development and single-process use. */
+export declare const createMemoryStore: () => BatchStore;
+//# sourceMappingURL=store.d.ts.map

package/dist/server/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/server/store.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,SAAS,CAAC;AAExD,kFAAkF;AAClF,eAAO,MAAM,iBAAiB,QAAO,UAwBpC,CAAC"}

package/dist/server/types.d.ts

@@ -0,0 +1,37 @@
+import type { BatchProvider, BatchRequestCounts, BatchStatus } from "../types";
+/** The unified webhook event batchwork delivers when a batch finishes. */
+export type BatchWebhookEventType = "batch.completed" | "batch.failed" | "batch.expired" | "batch.cancelled";
+export interface BatchWebhookEvent {
+    type: BatchWebhookEventType;
+    id: string;
+    provider: BatchProvider;
+    requestCounts: BatchRequestCounts;
+    createdAt?: string;
+    completedAt?: string;
+}
+/** A batch being watched by the poller, plus its delivery target. */
+export interface TrackedBatch {
+    id: string;
+    provider: BatchProvider;
+    /** Where to POST the completion webhook. Omitted for callback-based flows. */
+    webhookUrl?: string;
+    webhookSecret?: string;
+    status: BatchStatus;
+    createdAt: string;
+    /** Set once the completion webhook has been delivered. */
+    deliveredAt?: string;
+}
+/**
+ * Persistence for tracked batches. Implement against any KV/DB (Vercel KV,
+ * Upstash Redis, Cloudflare KV, Postgres). `createMemoryStore` is provided for
+ * development and single-process use.
+ */
+export interface BatchStore {
+    get: (id: string) => Promise<TrackedBatch | null>;
+    set: (record: TrackedBatch) => Promise<void>;
+    delete: (id: string) => Promise<void>;
+    list: (filter?: {
+        delivered?: boolean;
+    }) => Promise<TrackedBatch[]>;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/server/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/server/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,kBAAkB,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AAE/E,0EAA0E;AAC1E,MAAM,MAAM,qBAAqB,GAC7B,iBAAiB,GACjB,cAAc,GACd,eAAe,GACf,iBAAiB,CAAC;AAEtB,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,qBAAqB,CAAC;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,aAAa,EAAE,kBAAkB,CAAC;IAClC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qEAAqE;AACrE,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,EAAE,aAAa,CAAC;IACxB,8EAA8E;IAC9E,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,MAAM,EAAE,WAAW,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,0DAA0D;IAC1D,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;;GAIG;AACH,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAAC;IAClD,GAAG,EAAE,CAAC,MAAM,EAAE,YAAY,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,EAAE,CAAC,EAAE,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,EAAE,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,OAAO,CAAA;KAAE,KAAK,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;CACrE"}

package/dist/types.d.ts

@@ -0,0 +1,118 @@
+import type { JSONValue, LanguageModel, ModelMessage, ToolChoice, ToolSet } from "ai";
+/** Providers with a batch adapter. */
+export type BatchProvider = "anthropic" | "google" | "groq" | "mistral" | "openai" | "together" | "xai";
+/**
+ * Provider-specific options, forwarded verbatim into the underlying request
+ * body. Structurally identical to the AI SDK's `ProviderOptions`.
+ */
+export type ProviderOptions = Record<string, Record<string, JSONValue>>;
+/**
+ * Sampling and prompt-shaping fields shared with the AI SDK's `generateText`.
+ * Used both per request and as batch-wide defaults.
+ */
+export interface BatchRequestSettings {
+    frequencyPenalty?: number;
+    maxOutputTokens?: number;
+    presencePenalty?: number;
+    providerOptions?: ProviderOptions;
+    seed?: number;
+    stopSequences?: string[];
+    system?: string;
+    temperature?: number;
+    toolChoice?: ToolChoice<ToolSet>;
+    tools?: ToolSet;
+    topK?: number;
+    topP?: number;
+}
+/**
+ * A single request within a batch. Mirrors the AI SDK `generateText` input
+ * (minus `model`), plus a `customId` used to correlate the result.
+ */
+export interface BatchRequest extends BatchRequestSettings {
+    /** Correlates this request to its result. Auto-generated when omitted. */
+    customId?: string;
+    messages?: ModelMessage[];
+    prompt?: string;
+}
+/** Defaults merged into every request; request-level values take precedence. */
+export type BatchDefaults = BatchRequestSettings;
+/** Normalized batch lifecycle status, unified across providers. */
+export type BatchStatus = "validating" | "in_progress" | "finalizing" | "completed" | "failed" | "expired" | "cancelling" | "cancelled";
+/** Normalized per-request tallies. `completed` = succeeded, `failed` = errored. */
+export interface BatchRequestCounts {
+    canceled?: number;
+    completed: number;
+    expired?: number;
+    failed: number;
+    processing?: number;
+    total: number;
+}
+/** Outcome of a single request within a batch. */
+export type BatchResultStatus = "succeeded" | "errored" | "expired" | "canceled";
+export interface BatchUsage {
+    inputTokens?: number;
+    outputTokens?: number;
+    totalTokens?: number;
+}
+export interface BatchResultError {
+    code?: string | number;
+    message: string;
+    type?: string;
+}
+/** A normalized result line, correlated by `customId`. */
+export interface BatchResult {
+    customId: string;
+    /** Normalized error, present when `status` is `"errored"`. */
+    error?: BatchResultError;
+    /** Raw provider response body (OpenAI `response.body` / Anthropic message). */
+    response?: unknown;
+    status: BatchResultStatus;
+    /** Normalized text output, when the request produced a message. */
+    text?: string;
+    usage?: BatchUsage;
+}
+/** A point-in-time, normalized view of a batch's status. */
+export interface BatchSnapshot {
+    completedAt?: Date;
+    createdAt?: Date;
+    expiresAt?: Date;
+    id: string;
+    provider: BatchProvider;
+    /** Raw provider status object. */
+    raw: unknown;
+    requestCounts: BatchRequestCounts;
+    status: BatchStatus;
+}
+/** Provider credentials and connection config. Falls back to env when omitted. */
+export interface ProviderCredentials {
+    apiKey?: string;
+    baseURL?: string;
+    /** Extra provider-level HTTP headers (e.g. beta flags). */
+    headers?: Record<string, string>;
+}
+/** Input to `batch()`. */
+export interface BatchOptions extends ProviderCredentials {
+    defaults?: BatchDefaults;
+    metadata?: Record<string, string>;
+    model: LanguageModel;
+    requests: BatchRequest[];
+}
+/**
+ * Reference to an existing batch, used to rehydrate a handle. Identify the
+ * provider with either `model` or `provider` (e.g. from a webhook event).
+ */
+export interface BatchRef extends ProviderCredentials {
+    id: string;
+    model?: LanguageModel;
+    provider?: BatchProvider;
+}
+export interface WaitOptions {
+    /** Invoked after every poll with the latest snapshot. */
+    onPoll?: (snapshot: BatchSnapshot) => void;
+    /** Delay between polls. Default 15000ms. */
+    pollIntervalMs?: number;
+    signal?: AbortSignal;
+    /** Give up after this long. Default: no timeout. */
+    timeoutMs?: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/util.d.ts

@@ -0,0 +1,10 @@
+/** Small, defensive helpers for reading loosely-typed provider JSON. */
+export declare const asRecord: (value: unknown) => Record<string, unknown>;
+export declare const asString: (value: unknown) => string | undefined;
+export declare const asNumber: (value: unknown) => number | undefined;
+export declare const asArray: (value: unknown) => unknown[];
+/** Return a shallow copy of `obj` without `key`. */
+export declare const omit: (obj: Record<string, unknown>, key: string) => Record<string, unknown>;
+/** Coerce a provider timestamp (ISO string or unix seconds) to a `Date`. */
+export declare const toDate: (value: unknown) => Date | undefined;
+//# sourceMappingURL=util.d.ts.map

package/dist/util.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"util.d.ts","sourceRoot":"","sources":["../src/util.ts"],"names":[],"mappings":"AAAA,wEAAwE;AAExE,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAK/D,CAAC;AAEF,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,MAAM,GAAG,SACJ,CAAC;AAEhD,eAAO,MAAM,QAAQ,UAAW,OAAO,KAAG,MAAM,GAAG,SACJ,CAAC;AAEhD,eAAO,MAAM,OAAO,UAAW,OAAO,KAAG,OAAO,EACb,CAAC;AAEpC,oDAAoD;AACpD,eAAO,MAAM,IAAI,QACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,OACvB,MAAM,KACV,MAAM,CAAC,MAAM,EAAE,OAAO,CAQxB,CAAC;AAEF,4EAA4E;AAC5E,eAAO,MAAM,MAAM,UAAW,OAAO,KAAG,IAAI,GAAG,SAO9C,CAAC"}

package/package.json

@@ -1,12 +1,124 @@
 {
   "name": "batchwork",
-  "version": "0.0.0",
-  "description": "",
-  "license": "ISC",
-  "author": "",
-  "type": "commonjs",
-  "main": "index.js",
+  "version": "1.0.0",
+  "description": "Unified batch API for AI providers — low-cost LLM batch processing at scale.",
+  "keywords": [
+    "ai",
+    "ai-sdk",
+    "anthropic",
+    "batch",
+    "llm",
+    "openai",
+    "vercel"
+  ],
+  "homepage": "https://github.com/haydenbleasel/batchwork#readme",
+  "bugs": {
+    "url": "https://github.com/haydenbleasel/batchwork/issues"
+  },
+  "license": "MIT",
+  "author": "Hayden Bleasel",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/haydenbleasel/batchwork.git",
+    "directory": "packages/batchwork"
+  },
+  "files": [
+    "dist"
+  ],
+  "type": "module",
+  "main": "./dist/index.js",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./server": {
+      "types": "./dist/server/index.d.ts",
+      "import": "./dist/server/index.js"
+    },
+    "./next": {
+      "types": "./dist/next/index.d.ts",
+      "import": "./dist/next/index.js"
+    },
+    "./postgres": {
+      "types": "./dist/postgres/index.d.ts",
+      "import": "./dist/postgres/index.js"
+    },
+    "./redis": {
+      "types": "./dist/redis/index.d.ts",
+      "import": "./dist/redis/index.js"
+    }
+  },
+  "publishConfig": {
+    "access": "public"
+  },
   "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
+    "build": "bun run scripts/build.ts",
+    "dev": "bun run scripts/build.ts --watch",
+    "typecheck": "tsgo --noEmit && tsgo --noEmit -p tsconfig.bun.json",
+    "test": "bun test ./test",
+    "test:coverage": "bun test ./test --coverage",
+    "test:live": "bun test --env-file=.env.local ./live"
+  },
+  "dependencies": {
+    "ai": "^6.0.204"
+  },
+  "devDependencies": {
+    "@ai-sdk/anthropic": "^3.0.84",
+    "@ai-sdk/google": "^3.0.82",
+    "@ai-sdk/groq": "^3.0.41",
+    "@ai-sdk/mistral": "^3.0.39",
+    "@ai-sdk/openai": "^3.0.71",
+    "@ai-sdk/togetherai": "^2.0.55",
+    "@ai-sdk/xai": "^3.0.95",
+    "@electric-sql/pglite": "^0.5.2",
+    "@types/bun": "^1.3.14",
+    "@types/node": "^25.9.3",
+    "@types/pg": "^8.20.0",
+    "@typescript/native-preview": "^7.0.0-dev.20260613.1",
+    "@upstash/redis": "^1.38.0",
+    "pg": "^8.21.0",
+    "typescript": "^6.0.3"
+  },
+  "peerDependencies": {
+    "@ai-sdk/anthropic": ">=3",
+    "@ai-sdk/google": ">=3",
+    "@ai-sdk/groq": ">=3",
+    "@ai-sdk/mistral": ">=3",
+    "@ai-sdk/openai": ">=3",
+    "@ai-sdk/togetherai": ">=2",
+    "@ai-sdk/xai": ">=3",
+    "@upstash/redis": ">=1"
+  },
+  "peerDependenciesMeta": {
+    "@upstash/redis": {
+      "optional": true
+    },
+    "@ai-sdk/anthropic": {
+      "optional": true
+    },
+    "@ai-sdk/google": {
+      "optional": true
+    },
+    "@ai-sdk/groq": {
+      "optional": true
+    },
+    "@ai-sdk/mistral": {
+      "optional": true
+    },
+    "@ai-sdk/openai": {
+      "optional": true
+    },
+    "@ai-sdk/togetherai": {
+      "optional": true
+    },
+    "@ai-sdk/xai": {
+      "optional": true
+    }
+  },
+  "engines": {
+    "node": ">=20"
   }
 }