skedyul 1.7.6 → 1.7.7

package/dist/server.js

@@ -1988,6 +1988,107 @@ async function handleMcpBatchRoute(req, ctx) {
     }
   };
 }
+async function handleBatchOperationRoute(req, ctx) {
+  const bodyResult = parseJsonBody(req);
+  if (!bodyResult.success) {
+    return bodyResult.error;
+  }
+  const body = bodyResult.data;
+  const registry = ctx.batchOperationRegistry;
+  if (!registry) {
+    return {
+      status: 404,
+      body: {
+        success: false,
+        error: "No batch operations registered"
+      }
+    };
+  }
+  const operation = registry[body.handle];
+  if (!operation) {
+    return {
+      status: 404,
+      body: {
+        success: false,
+        error: `Batch operation not found: ${body.handle}`
+      }
+    };
+  }
+  const log = {
+    info: (message, meta) => {
+      console.log(`[batch:${body.handle}] ${message}`, meta ?? "");
+    },
+    warn: (message, meta) => {
+      console.warn(`[batch:${body.handle}] ${message}`, meta ?? "");
+    },
+    error: (message, meta) => {
+      console.error(`[batch:${body.handle}] ${message}`, meta ?? "");
+    }
+  };
+  try {
+    if (body.method === "setup") {
+      if (!operation.setup) {
+        return {
+          status: 200,
+          body: {
+            success: true,
+            result: { state: {}, total: void 0 }
+          }
+        };
+      }
+      const result = await operation.setup({
+        workplaceId: body.workplaceId,
+        appInstallationId: body.appInstallationId,
+        appId: body.appId,
+        input: body.input,
+        log
+      });
+      return {
+        status: 200,
+        body: {
+          success: true,
+          result
+        }
+      };
+    }
+    if (body.method === "iterate") {
+      const result = await operation.iterate({
+        workplaceId: body.workplaceId,
+        appInstallationId: body.appInstallationId,
+        appId: body.appId,
+        input: body.input,
+        state: body.state,
+        page: body.page,
+        cursor: body.cursor,
+        limit: body.limit,
+        log
+      });
+      return {
+        status: 200,
+        body: {
+          success: true,
+          result
+        }
+      };
+    }
+    return {
+      status: 400,
+      body: {
+        success: false,
+        error: `Unknown method: ${body.method}`
+      }
+    };
+  } catch (err) {
+    log.error("Batch operation failed", { error: err });
+    return {
+      status: 500,
+      body: {
+        success: false,
+        error: err instanceof Error ? err.message : String(err)
+      }
+    };
+  }
+}
 function createNotFoundResponse() {
   return {
     status: 404,
@@ -2067,6 +2168,9 @@ async function routeRequest(req, ctx) {
     if (req.path === "/mcp/batch" && req.method === "POST") {
       return handleMcpBatchRoute(req, ctx);
     }
+    if (req.path === "/batch-operation" && req.method === "POST") {
+      return handleBatchOperationRoute(req, ctx);
+    }
     return createNotFoundResponse();
   } catch (err) {
     return createErrorResponse(err);
@@ -2108,11 +2212,13 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
   const defaultHeaders = getDefaultHeaders(config.cors);
   const registry = config.tools;
   const webhookRegistry = config.webhooks;
+  const batchOperationRegistry = config.batchOperations;
   const ctx = {
     config,
     tools,
     registry,
     webhookRegistry,
+    batchOperationRegistry,
     callTool,
     state,
     mcpServer,
@@ -2227,12 +2333,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer) {
   const defaultHeaders = getDefaultHeaders(config.cors);
   const registry = config.tools;
   const webhookRegistry = config.webhooks;
+  const batchOperationRegistry = config.batchOperations;
   let hasLoggedStartup = false;
   const ctx = {
     config,
     tools,
     registry,
     webhookRegistry,
+    batchOperationRegistry,
     callTool,
     state,
     mcpServer,

package/dist/serverless/server.mjs

@@ -1949,6 +1949,107 @@ async function handleMcpBatchRoute(req, ctx) {
     }
   };
 }
+async function handleBatchOperationRoute(req, ctx) {
+  const bodyResult = parseJsonBody(req);
+  if (!bodyResult.success) {
+    return bodyResult.error;
+  }
+  const body = bodyResult.data;
+  const registry = ctx.batchOperationRegistry;
+  if (!registry) {
+    return {
+      status: 404,
+      body: {
+        success: false,
+        error: "No batch operations registered"
+      }
+    };
+  }
+  const operation = registry[body.handle];
+  if (!operation) {
+    return {
+      status: 404,
+      body: {
+        success: false,
+        error: `Batch operation not found: ${body.handle}`
+      }
+    };
+  }
+  const log = {
+    info: (message, meta) => {
+      console.log(`[batch:${body.handle}] ${message}`, meta ?? "");
+    },
+    warn: (message, meta) => {
+      console.warn(`[batch:${body.handle}] ${message}`, meta ?? "");
+    },
+    error: (message, meta) => {
+      console.error(`[batch:${body.handle}] ${message}`, meta ?? "");
+    }
+  };
+  try {
+    if (body.method === "setup") {
+      if (!operation.setup) {
+        return {
+          status: 200,
+          body: {
+            success: true,
+            result: { state: {}, total: void 0 }
+          }
+        };
+      }
+      const result = await operation.setup({
+        workplaceId: body.workplaceId,
+        appInstallationId: body.appInstallationId,
+        appId: body.appId,
+        input: body.input,
+        log
+      });
+      return {
+        status: 200,
+        body: {
+          success: true,
+          result
+        }
+      };
+    }
+    if (body.method === "iterate") {
+      const result = await operation.iterate({
+        workplaceId: body.workplaceId,
+        appInstallationId: body.appInstallationId,
+        appId: body.appId,
+        input: body.input,
+        state: body.state,
+        page: body.page,
+        cursor: body.cursor,
+        limit: body.limit,
+        log
+      });
+      return {
+        status: 200,
+        body: {
+          success: true,
+          result
+        }
+      };
+    }
+    return {
+      status: 400,
+      body: {
+        success: false,
+        error: `Unknown method: ${body.method}`
+      }
+    };
+  } catch (err) {
+    log.error("Batch operation failed", { error: err });
+    return {
+      status: 500,
+      body: {
+        success: false,
+        error: err instanceof Error ? err.message : String(err)
+      }
+    };
+  }
+}
 function createNotFoundResponse() {
   return {
     status: 404,
@@ -2028,6 +2129,9 @@ async function routeRequest(req, ctx) {
     if (req.path === "/mcp/batch" && req.method === "POST") {
       return handleMcpBatchRoute(req, ctx);
     }
+    if (req.path === "/batch-operation" && req.method === "POST") {
+      return handleBatchOperationRoute(req, ctx);
+    }
     return createNotFoundResponse();
   } catch (err) {
     return createErrorResponse(err);
@@ -2069,11 +2173,13 @@ function createDedicatedServerInstance(config, tools, callTool, state, mcpServer
   const defaultHeaders = getDefaultHeaders(config.cors);
   const registry = config.tools;
   const webhookRegistry = config.webhooks;
+  const batchOperationRegistry = config.batchOperations;
   const ctx = {
     config,
     tools,
     registry,
     webhookRegistry,
+    batchOperationRegistry,
     callTool,
     state,
     mcpServer,
@@ -2188,12 +2294,14 @@ function createServerlessInstance(config, tools, callTool, state, mcpServer) {
   const defaultHeaders = getDefaultHeaders(config.cors);
   const registry = config.tools;
   const webhookRegistry = config.webhooks;
+  const batchOperationRegistry = config.batchOperations;
   let hasLoggedStartup = false;
   const ctx = {
     config,
     tools,
     registry,
     webhookRegistry,
+    batchOperationRegistry,
     callTool,
     state,
     mcpServer,

package/dist/types/batch-operation.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Batch operation runtime types.
+ *
+ * These types define the registry and context for batch operations at runtime.
+ */
+import type { BatchOperationSetupFn, BatchOperationIterateFn } from '../config/types/batch-operation';
+export type { BatchOperationContext } from '../config/types/batch-operation';
+/**
+ * Entry in the batch operation registry.
+ * Contains both metadata and function implementations.
+ */
+export interface BatchOperationRegistryEntry {
+    /** Unique handle for this operation */
+    handle: string;
+    /** Human-readable label */
+    label: string;
+    /** Description of what this operation does */
+    description?: string;
+    /** Entity handle that items will be upserted to */
+    entity: string;
+    /** Setup function called once at the start */
+    setup?: BatchOperationSetupFn;
+    /** Iterate function called for each page */
+    iterate: BatchOperationIterateFn;
+    /** Maximum concurrent operations per app installation */
+    maxConcurrent?: number;
+    /** Default page size */
+    pageSize?: number;
+    /** Optional icon */
+    icon?: string;
+}
+/**
+ * Registry mapping batch operation handles to their implementations.
+ */
+export type BatchOperationRegistry = Record<string, BatchOperationRegistryEntry>;
+/**
+ * Metadata for a batch operation (serializable, no functions).
+ */
+export interface BatchOperationMetadata {
+    handle: string;
+    label: string;
+    description?: string;
+    entity: string;
+    maxConcurrent?: number;
+    pageSize?: number;
+    icon?: string;
+}

package/dist/types/index.d.ts

@@ -22,3 +22,4 @@ export type { WebhookWireRequest, HandlerRawRequest, WebhookRequest, WebhookResp
 export { isRuntimeWebhookContext } from './webhook';
 export type { MCPError, MCPContentItem, MCPResult, MCPResponse, MCPRequest, } from './mcp-protocol';
 export type { DataBlock, DataBlockLink, SpreadsheetBlock, SpreadsheetColumn, ProfileBlock, ProfileAvatar, ProfileField, FieldChangesBlock, FieldChangeItem, DateTimeBlock, } from './data-blocks';
+export type { BatchOperationContext, BatchOperationRegistryEntry, BatchOperationRegistry, BatchOperationMetadata, } from './batch-operation';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "skedyul",
-  "version": "1.7.6",
+  "version": "1.7.7",
   "description": "The Skedyul SDK for Node.js",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",