fix(config): add signedInt schema type for CAMUNDA_WORKER_REQUEST_TIMEOUT

CAMUNDA_WORKER_REQUEST_TIMEOUT supports negative values (immediate
completion semantics), but was typed as 'string' in the schema, making
CamundaOptions.config accept string instead of number for this key and
bypassing input validation entirely.

Introduce a 'signedInt' schema type with a dedicated parser that accepts
base-10 integers with an optional leading minus sign. This:
- Types the config override as number in TypeScript
- Validates input (rejects 'abc', '5.0', etc.)
- Allows negative values like -1

Also fix the worker defaults comment to mention both createJobWorker
and createThreadedJobWorker.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>

Author: jwulf

src/runtime/configSchema.ts

@@ -209,7 +209,7 @@ export const SCHEMA = {
     default: false,
     doc: 'Alias for CAMUNDA_SUPPORT_LOG_ENABLED (deprecated).',
   },
-  // Worker defaults (heritable to all workers created via createJobWorker)
+  // Worker defaults (heritable to all workers created via createJobWorker/createThreadedJobWorker)
   CAMUNDA_WORKER_TIMEOUT: {
     type: 'int',
     doc: 'Default job timeout in ms for all workers. Individual JobWorkerConfig.jobTimeoutMs overrides this.',
@@ -219,8 +219,8 @@ export const SCHEMA = {
     doc: 'Default max parallel jobs for all workers. Individual JobWorkerConfig.maxParallelJobs overrides this.',
   },
   CAMUNDA_WORKER_REQUEST_TIMEOUT: {
-    type: 'string',
-    doc: 'Default long-poll timeout in ms for all workers (signed integer string; negative values are valid — they cause activation to complete immediately when no jobs are available). Individual JobWorkerConfig.pollTimeoutMs overrides this.',
+    type: 'signedInt',
+    doc: 'Default long-poll timeout in ms for all workers. Negative values cause activation to complete immediately when no jobs are available. Individual JobWorkerConfig.pollTimeoutMs overrides this.',
   },
   CAMUNDA_WORKER_NAME: {
     type: 'string',
@@ -239,7 +239,7 @@ type PrimitiveType<T> = T extends { type: 'string' }
   ? string
   : T extends { type: 'boolean' }
     ? boolean
-    : T extends { type: 'int' }
+    : T extends { type: 'int' | 'signedInt' }
       ? number
       : T extends { type: 'enum'; choices: readonly (infer C)[] }
         ? C

src/runtime/unifiedConfiguration.ts

@@ -190,6 +190,23 @@ function parseInteger(raw: string, key: string, errors: ConfigErrorDetail[]): nu
   return undefined;
 }
 
+// Signed integer parser (allows negative values)
+function parseSignedInteger(
+  raw: string,
+  key: string,
+  errors: ConfigErrorDetail[]
+): number | undefined {
+  const v = raw.trim();
+  if (v === '') return undefined;
+  if (/^-?[0-9]+$/.test(v)) return parseInt(v, 10);
+  errors.push({
+    code: ConfigErrorCode.CONFIG_INVALID_INTEGER,
+    key,
+    message: `Invalid integer '${raw}'. Only base-10 integers (optionally negative) allowed.`,
+  });
+  return undefined;
+}
+
 // Validation mini-language parser (strict per design)
 function parseValidation(
   raw: string,
@@ -291,6 +308,13 @@ export function hydrateConfig(options: HydrateOptions = {}): HydratedConfigurati
       return parsed;
     };
   }
+  function signedIntParserFactory(key: string) {
+    return (v: string) => {
+      const parsed = parseSignedInteger(v, key, parseErrors);
+      if (parsed === undefined) return undefined;
+      return parsed;
+    };
+  }
   function enumParserFactory(key: string, choices: readonly string[]) {
     // Case-insensitive parsing. Canonicalize to schema-declared casing style.
     // If all choices are lowercase => return lowercase value.
@@ -334,6 +358,10 @@ export function hydrateConfig(options: HydrateOptions = {}): HydratedConfigurati
       const base: any = { parser: intParserFactory(k), ...baseOpt };
       if (entry.default !== undefined) base.default = entry.default;
       typedEnvSchema[k] = base;
+    } else if (entry.type === 'signedInt') {
+      const base: any = { parser: signedIntParserFactory(k), ...baseOpt };
+      if (entry.default !== undefined) base.default = entry.default;
+      typedEnvSchema[k] = base;
     } else if (entry.type === 'enum') {
       const base: any = { parser: enumParserFactory(k, entry.choices || []), ...baseOpt };
       if (entry.default !== undefined) base.default = entry.default;