@toa.io/extensions.exposition 1.0.0-alpha.197 → 1.0.0-alpha.198

package/features/dev.feature

@@ -54,3 +54,34 @@ Feature: Dev
 
       "Invalid sleep duration"
       """
+
+  Scenario: Faulty mode
+    Given the annotation:
+      """yaml
+      /:
+        io:output: true
+        anonymous: true
+        dev:faulty: 1
+        GET:
+          dev:stub: hello
+      """
+    # CORS permission
+    When the following request is received:
+      """
+      OPTIONS / HTTP/1.1
+      origin: http://example.com
+      """
+    Then the following reply is sent:
+      """
+      204 No Content
+      access-control-allow-headers: accept, authorization, content-type, if-match, if-none-match, faulty
+      """
+    When the following request is received:
+      """
+      GET / HTTP/1.1
+      faulty: 1
+      """
+    Then the following reply is sent:
+      """
+      503 Service Unavailable
+      """

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@toa.io/extensions.exposition",
-  "version": "1.0.0-alpha.197",
+  "version": "1.0.0-alpha.198",
   "description": "Toa Exposition",
   "author": "temich <tema.gurtovoy@gmail.com>",
   "homepage": "https://github.com/toa-io/toa#readme",
@@ -61,5 +61,5 @@
     },
     "testEnvironment": "node"
   },
-  "gitHead": "630fc3af7de745d97f5c06a6c1b204f0cdf7d4c7"
+  "gitHead": "9138736f36096cb210f00056cf62fa25cb3eaca7"
 }

package/source/HTTP/exceptions.ts

@@ -83,3 +83,9 @@ export class TooManyRequests extends ClientError {
     super(429)
   }
 }
+
+export class ServiceUnavailable extends Exception {
+  public constructor (body?: any) {
+    super(503, body)
+  }
+}

package/source/directives/dev/Development.ts

@@ -1,6 +1,7 @@
 import { Stub } from './Stub'
 import { Throw } from './Throw'
 import { Sleep } from './Sleep'
+import { Faulty } from './Faulty'
 import { type Directive } from './types'
 import type { Input, Output } from '../../io'
 import type { DirectiveFamily } from '../../RTD'
@@ -36,5 +37,6 @@ export class Development implements DirectiveFamily<Directive> {
 const constructors: Record<string, new (value: any) => Directive> = {
   stub: Stub,
   throw: Throw,
-  sleep: Sleep
+  sleep: Sleep,
+  faulty: Faulty
 }

package/source/directives/dev/Faulty.ts

@@ -0,0 +1,26 @@
+import assert from 'node:assert'
+import type { Directive } from './types'
+import { ServiceUnavailable } from '../../HTTP'
+import { Output } from '../../io'
+import { cors } from '../cors'
+
+export class Faulty implements Directive {
+  private static warned = false
+  private readonly probability: number
+
+  public constructor (probability: number) {
+    assert.ok(typeof probability === 'number', '`dev:faulty` directive value must be a number')
+    assert.ok(probability > 0 && probability <= 1, '`dev:faulty` directive value must be in the range (0, 1]')
+
+    this.probability = probability
+
+    cors.allow('faulty')
+  }
+
+  public async apply (): Promise<Output> {
+    if (Math.random() > this.probability)
+      return null
+
+    throw new ServiceUnavailable()
+  }
+}