Refine JSON Schema typing across packages

The changes introduce stricter typing for JSON Schema-related definitions, specifically replacing vague types with more precise ones, such as using `z.record(z.unknown())` instead of `z.any()` and `Record<string, unknown>` in place of `any`. This is part of an effort to better align with common practices and improve type safety in the packages.

- Updated the `payloadSchema` in several files to use `z.record(z.unknown())`, enhancing the type strictness and consistency with JSON Schema Draft 7 recommendations.
- Added `@types/json-schema` as a dependency, utilizing its definitions for improved type clarity and adherence to best practices in TypeScript.
- Modified various comments to explicitly mention JSON Schema Draft 7, ensuring developers are aware of the JSON Schema version being implemented.
- These adjustments are informed by research into how popular libraries and tools handle JSON Schema typing, aiming to integrate best practices for improved maintainability and interoperability.

Author: ericallam

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

@@ -13,7 +13,7 @@ export const TaskResource = z.object({
   triggerSource: z.string().optional(),
   schedule: ScheduleMetadata.optional(),
   maxDuration: z.number().optional(),
-  payloadSchema: z.any().optional(),
+  payloadSchema: z.record(z.unknown()).optional(),
 });
 
 export type TaskResource = z.infer<typeof TaskResource>;

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

@@ -189,7 +189,7 @@ const taskMetadata = {
   triggerSource: z.string().optional(),
   schedule: ScheduleMetadata.optional(),
   maxDuration: z.number().optional(),
-  payloadSchema: z.any().optional(),
+  payloadSchema: z.record(z.unknown()).optional(),
 };
 
 export const TaskMetadata = z.object(taskMetadata);

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

@@ -342,8 +342,9 @@ 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?: any;
+  payloadSchema?: Record<string, unknown>;
 };
 
 export type TaskOptions<

packages/schema-to-json/package.json

@@ -43,6 +43,7 @@
     "check-exports": "tshy --check-exports"
   },
   "dependencies": {
+    "@types/json-schema": "^7.0.15",
     "zod-to-json-schema": "^3.24.5",
     "@sodaru/yup-to-json-schema": "^2.0.1"
   },

packages/schema-to-json/src/index.ts

@@ -1,4 +1,8 @@
+import type { JSONSchema7, JSONSchema7Definition } from '@types/json-schema';
+
 export type Schema = unknown;
+export type JSONSchema = JSONSchema7;
+export type JSONSchemaDefinition = JSONSchema7Definition;
 
 export interface ConversionOptions {
   /**
@@ -13,9 +17,9 @@ export interface ConversionOptions {
 
 export interface ConversionResult {
   /**
-   * The JSON Schema representation
+   * The JSON Schema representation (JSON Schema Draft 7)
    */
-  jsonSchema: any;
+  jsonSchema: JSONSchema;
   /**
    * The detected schema type
    */