Add JSONSchema type for payloadSchema in tasks

The change was necessary to improve type safety by using a proper JSONSchema type definition instead of a generic Record<string, unknown>. This enhances the developer experience and ensures that task payloads conform to the JSON Schema Draft 7 specification. The JSONSchema type is now re-exported from the SDK for user convenience, hiding internal complexity and maintaining a seamless developer experience.

- Added JSONSchema type based on Draft 7 specification
- Updated task metadata and options to use JSONSchema type
- Hid internal schema conversion logic from users by re-exporting types from SDK
- Improved bundle safety and dependency management

Author: ericallam

packages/core/src/v3/schemas/resources.ts

@@ -13,6 +13,7 @@ export const TaskResource = z.object({
   triggerSource: z.string().optional(),
   schedule: ScheduleMetadata.optional(),
   maxDuration: z.number().optional(),
+  // JSONSchema type - using z.record for runtime validation
   payloadSchema: z.record(z.unknown()).optional(),
 });
 

packages/core/src/v3/schemas/schemas.ts

@@ -189,6 +189,7 @@ const taskMetadata = {
   triggerSource: z.string().optional(),
   schedule: ScheduleMetadata.optional(),
   maxDuration: z.number().optional(),
+  // JSONSchema type - using z.record for runtime validation
   payloadSchema: z.record(z.unknown()).optional(),
 };
 

packages/core/src/v3/types/index.ts

@@ -7,6 +7,7 @@ export * from "./tasks.js";
 export * from "./idempotencyKeys.js";
 export * from "./tools.js";
 export * from "./queues.js";
+export * from "./jsonSchema.js";
 
 type ResolveEnvironmentVariablesOptions = {
   variables: Record<string, string> | Array<{ name: string; value: string }>;

packages/core/src/v3/types/jsonSchema.ts

@@ -0,0 +1,69 @@
+/**
+ * Basic JSON Schema type definition
+ * Based on JSON Schema Draft 7
+ */
+export type JSONSchemaType = "string" | "number" | "integer" | "boolean" | "object" | "array" | "null";
+
+export interface JSONSchema {
+  $id?: string;
+  $ref?: string;
+  $schema?: string;
+  $comment?: string;
+  
+  type?: JSONSchemaType | JSONSchemaType[];
+  enum?: any[];
+  const?: any;
+  
+  // Number/Integer validations
+  multipleOf?: number;
+  maximum?: number;
+  exclusiveMaximum?: number;
+  minimum?: number;
+  exclusiveMinimum?: number;
+  
+  // String validations
+  maxLength?: number;
+  minLength?: number;
+  pattern?: string;
+  format?: string;
+  
+  // Array validations
+  items?: JSONSchema | JSONSchema[];
+  additionalItems?: JSONSchema | boolean;
+  maxItems?: number;
+  minItems?: number;
+  uniqueItems?: boolean;
+  contains?: JSONSchema;
+  
+  // Object validations
+  maxProperties?: number;
+  minProperties?: number;
+  required?: string[];
+  properties?: Record<string, JSONSchema>;
+  patternProperties?: Record<string, JSONSchema>;
+  additionalProperties?: JSONSchema | boolean;
+  dependencies?: Record<string, JSONSchema | string[]>;
+  propertyNames?: JSONSchema;
+  
+  // Conditionals
+  if?: JSONSchema;
+  then?: JSONSchema;
+  else?: JSONSchema;
+  
+  // Boolean logic
+  allOf?: JSONSchema[];
+  anyOf?: JSONSchema[];
+  oneOf?: JSONSchema[];
+  not?: JSONSchema;
+  
+  // Metadata
+  title?: string;
+  description?: string;
+  default?: any;
+  readOnly?: boolean;
+  writeOnly?: boolean;
+  examples?: any[];
+  
+  // Additional properties
+  [key: string]: any;
+}

packages/core/src/v3/types/tasks.ts

@@ -28,6 +28,7 @@ import { QueueOptions } from "./queues.js";
 import { AnySchemaParseFn, inferSchemaIn, inferSchemaOut, Schema } from "./schemas.js";
 import { inferToolParameters, ToolTaskParameters } from "./tools.js";
 import { Prettify } from "./utils.js";
+import { JSONSchema } from "./jsonSchema.js";
 
 export type Queue = QueueOptions;
 export type TaskSchema = Schema;
@@ -344,7 +345,7 @@ type CommonTaskOptions<
    * JSON Schema for the task payload. This will be synced to the server during indexing.
    * Should be a valid JSON Schema Draft 7 object.
    */
-  payloadSchema?: Record<string, unknown>;
+  payloadSchema?: JSONSchema;
 };
 
 export type TaskOptions<

packages/trigger-sdk/src/v3/schemas.ts

@@ -1,12 +1,2 @@
 // Re-export JSON Schema types for user convenience
-export type { JSONSchema, JSONSchemaDefinition } from "@trigger.dev/schema-to-json";
-
-// Re-export the standard JSON Schema types from @types/json-schema
-export type {
-  JSONSchema7,
-  JSONSchema7Type,
-  JSONSchema7TypeName,
-  JSONSchema7Definition,
-  JSONSchema7Object,
-  JSONSchema7Array,
-} from "@trigger.dev/schema-to-json";
+export type { JSONSchema } from "@trigger.dev/core/v3";