@nxgt/typespec 0.9.0 → 0.9.1

package/docs/guide/errors.md

@@ -162,7 +162,9 @@ its own way, through `onValidationError`, turns that off with the generator's
 | `Forbidden` | 403 | `ForbiddenBody` | authenticated, but not allowed; a `@nxgt/janus-hono` guard sends `AccessDenied` instead, and `janusErrors()` its own `{ code }` body ([Authentication](auth.md)) |
 | `NotFound` | 404 | `NotFoundBody` | nothing is there |
 | `Conflict` | 409 | `ConflictBody` | the request conflicts with the resource's state, such as a stale `version` |
+| `IdempotencyInProgress` | 409 | `ConflictBody` | the first request with this `Idempotency-Key` still runs; with the `RateLimit-*` headers and `Retry-After` ([Headers](headers.md)) |
 | `UnprocessableEntity` | 422 | `UnprocessableEntityBody` | well-formed, but not something the server can act on |
+| `IdempotencyKeyReused` | 422 | `UnprocessableEntityBody` | an `Idempotency-Key` sent again with another body; with the `RateLimit-*` headers ([Headers](headers.md)) |
 | `TooManyRequests` | 429 | `TooManyRequestsBody` | too many requests; with the `RateLimit-*` headers and `Retry-After` ([Headers](headers.md)) |
 | `InternalServerError` | 500 | `InternalServerErrorBody` | the server failed; with `validateResponses`, `@nxgt/openapi-hono` sends it with `errors.response-validation-failed` when a reply breaks the spec |
 | `ErrorResponse<Status>` | any | `ErrorBody<Status>` | any other status |

package/lib/errors.tsp

@@ -130,6 +130,29 @@ model TooManyRequests {
   @body body: TooManyRequestsBody;
 }
 
+/**
+ * A request with this `Idempotency-Key` is still running. Retry it as it is,
+ * after `Retry-After`.
+ */
+@error
+model IdempotencyInProgress {
+  @statusCode _: 409;
+  ...RateLimitHeaders;
+  ...RetryAfterHeader;
+  @body body: ConflictBody;
+}
+
+/**
+ * This `Idempotency-Key` was already used for a request with another body. A
+ * new request takes a new key.
+ */
+@error
+model IdempotencyKeyReused {
+  @statusCode _: 422;
+  ...RateLimitHeaders;
+  @body body: UnprocessableEntityBody;
+}
+
 /**
  * The server failed. With `validateResponses`, `@nxgt/openapi-hono` answers
  * it too when a reply breaks the spec, with `errors.response-validation-failed`.

package/lib/headers.tsp

@@ -51,26 +51,3 @@ model RetryAfterHeader {
   @header("Retry-After")
   retryAfter?: integer;
 }
-
-/**
- * A request with this `Idempotency-Key` is still running. Retry it as it is,
- * after `Retry-After`.
- */
-@error
-model IdempotencyInProgress {
-  @statusCode _: 409;
-  ...RateLimitHeaders;
-  ...RetryAfterHeader;
-  @body body: ConflictBody;
-}
-
-/**
- * This `Idempotency-Key` was already used for a request with another body. A
- * new request takes a new key.
- */
-@error
-model IdempotencyKeyReused {
-  @statusCode _: 422;
-  ...RateLimitHeaders;
-  @body body: UnprocessableEntityBody;
-}

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@nxgt/typespec",
-	"version": "0.9.0",
+	"version": "0.9.1",
 	"license": "MIT",
 	"type": "module",
 	"main": "./dist/index.js",