@objectstack/spec 2.0.6 → 2.0.7

package/dist/integration/index.mjs

@@ -370,6 +370,53 @@ var RetryConfigSchema = z5.object({
    */
   jitter: z5.boolean().optional().default(true).describe("Add jitter to retry delays")
 });
+var ErrorCategorySchema = z5.enum([
+  "validation",
+  "authorization",
+  "not_found",
+  "conflict",
+  "rate_limit",
+  "timeout",
+  "server_error",
+  "integration_error"
+]).describe("Standard error category");
+var ErrorMappingRuleSchema = z5.object({
+  sourceCode: z5.union([z5.string(), z5.number()]).describe("External system error code"),
+  sourceMessage: z5.string().optional().describe("Pattern to match against error message"),
+  targetCode: z5.string().describe("ObjectStack standard error code"),
+  targetCategory: ErrorCategorySchema.describe("Error category"),
+  severity: z5.enum(["low", "medium", "high", "critical"]).describe("Error severity level"),
+  retryable: z5.boolean().describe("Whether the error is retryable"),
+  userMessage: z5.string().optional().describe("Human-readable message to show users")
+}).describe("Error mapping rule");
+var ErrorMappingConfigSchema = z5.object({
+  rules: z5.array(ErrorMappingRuleSchema).describe("Error mapping rules"),
+  defaultCategory: ErrorCategorySchema.optional().default("integration_error").describe("Default category for unmapped errors"),
+  unmappedBehavior: z5.enum(["passthrough", "generic_error", "throw"]).describe("What to do with unmapped errors"),
+  logUnmapped: z5.boolean().optional().default(true).describe("Log unmapped errors")
+}).describe("Error mapping configuration");
+var HealthCheckConfigSchema = z5.object({
+  enabled: z5.boolean().describe("Enable health checks"),
+  intervalMs: z5.number().optional().default(6e4).describe("Health check interval in milliseconds"),
+  timeoutMs: z5.number().optional().default(5e3).describe("Health check timeout in milliseconds"),
+  endpoint: z5.string().optional().describe("Health check endpoint path"),
+  method: z5.enum(["GET", "HEAD", "OPTIONS"]).optional().describe("HTTP method for health check"),
+  expectedStatus: z5.number().optional().default(200).describe("Expected HTTP status code"),
+  unhealthyThreshold: z5.number().optional().default(3).describe("Consecutive failures before marking unhealthy"),
+  healthyThreshold: z5.number().optional().default(1).describe("Consecutive successes before marking healthy")
+}).describe("Health check configuration");
+var CircuitBreakerConfigSchema = z5.object({
+  enabled: z5.boolean().describe("Enable circuit breaker"),
+  failureThreshold: z5.number().optional().default(5).describe("Failures before opening circuit"),
+  resetTimeoutMs: z5.number().optional().default(3e4).describe("Time in open state before half-open"),
+  halfOpenMaxRequests: z5.number().optional().default(1).describe("Requests allowed in half-open state"),
+  monitoringWindow: z5.number().optional().default(6e4).describe("Rolling window for failure count in ms"),
+  fallbackStrategy: z5.enum(["cache", "default_value", "error", "queue"]).optional().describe("Fallback strategy when circuit is open")
+}).describe("Circuit breaker configuration");
+var ConnectorHealthSchema = z5.object({
+  healthCheck: HealthCheckConfigSchema.optional().describe("Health check configuration"),
+  circuitBreaker: CircuitBreakerConfigSchema.optional().describe("Circuit breaker configuration")
+}).describe("Connector health configuration");
 var ConnectorTypeSchema = z5.enum([
   "saas",
   // SaaS application connector
@@ -472,6 +519,14 @@ var ConnectorSchema = z5.object({
    * Enable connector
    */
   enabled: z5.boolean().optional().default(true).describe("Enable connector"),
+  /**
+   * Error mapping configuration
+   */
+  errorMapping: ErrorMappingConfigSchema.optional().describe("Error mapping configuration"),
+  /**
+   * Health check and circuit breaker configuration
+   */
+  health: ConnectorHealthSchema.optional().describe("Health and resilience configuration"),
   /**
    * Custom metadata
    */
@@ -2495,8 +2550,10 @@ export {
   ApiVersionConfigSchema,
   BuildConfigSchema,
   CdcConfigSchema,
+  CircuitBreakerConfigSchema,
   ConflictResolutionSchema,
   ConnectorActionSchema,
+  ConnectorHealthSchema,
   ConnectorSchema,
   ConnectorStatusSchema,
   ConnectorTriggerSchema,
@@ -2513,6 +2570,9 @@ export {
   DomainConfigSchema,
   EdgeFunctionConfigSchema,
   EnvironmentVariablesSchema,
+  ErrorCategorySchema,
+  ErrorMappingConfigSchema,
+  ErrorMappingRuleSchema,
   FieldMappingSchema2 as FieldMappingSchema,
   FileAccessPatternSchema,
   FileFilterConfigSchema,
@@ -2529,6 +2589,7 @@ export {
   GitHubReleaseConfigSchema,
   GitHubRepositorySchema,
   GitRepositoryConfigSchema,
+  HealthCheckConfigSchema,
   MessageFormatSchema,
   MessageQueueConnectorSchema,
   MessageQueueProviderSchema,