@owlmeans/api 0.1.18-rc.40 → 0.1.18-rc.41

package/README.md

@@ -12,7 +12,7 @@ HTTP API client service for OwlMeans client contexts — carries entrypoint call
 ## Installation
 
 ```bash
-bun add @owlmeans/api@^0.1.18-rc.40
+bun add @owlmeans/api@^0.1.18-rc.41
 ```
 
 ## Usage
@@ -65,7 +65,7 @@ This package ships embedded agent skills under `agent-meta/`. After installing y
 your project's skill store (`.agents/skills/`):
 
 ```sh
-npx @owlmeans/agent-skills@^0.1.18-rc.41
+npx @owlmeans/agent-skills@^0.1.18-rc.42
 ```
 
 The embedded files are version-matched to this package release. Do not edit them

package/agent-meta/manifest.json

@@ -1,8 +1,8 @@
 {
   "schemaVersion": 2,
   "package": "@owlmeans/api",
-  "version": "0.1.18-rc.40",
-  "generatedAt": "2026-09-28T02:06:37.895Z",
+  "version": "0.1.18-rc.41",
+  "generatedAt": "2026-09-29T08:01:58.146Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

package/agent-meta/skills/api/SKILL.md

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/api
 
 **Layer:** Core
-**Install:** `"@owlmeans/api": "^0.1.18-rc.40"` in `dependencies`
+**Install:** `"@owlmeans/api": "^0.1.18-rc.41"` in `dependencies`
 
 ## Key Exports
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@owlmeans/api",
-  "version": "0.1.18-rc.40",
+  "version": "0.1.18-rc.41",
   "license": "MIT",
   "type": "module",
   "scripts": {
@@ -29,10 +29,10 @@
     }
   },
   "dependencies": {
-    "@owlmeans/auth-common": "^0.1.18-rc.40",
-    "@owlmeans/client-config": "^0.1.18-rc.38",
-    "@owlmeans/client-route": "^0.1.18-rc.41",
-    "@owlmeans/config": "^0.1.18-rc.38",
+    "@owlmeans/auth-common": "^0.1.18-rc.41",
+    "@owlmeans/client-config": "^0.1.18-rc.39",
+    "@owlmeans/client-route": "^0.1.18-rc.42",
+    "@owlmeans/config": "^0.1.18-rc.39",
     "@owlmeans/context": "^0.1.18-rc.32",
     "@owlmeans/error": "^0.1.18-rc.36",
     "@owlmeans/entrypoint": "^0.1.18-rc.37",
@@ -42,6 +42,7 @@
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
+    "@owlmeans/resource": "^0.1.18-rc.37",
     "@types/qs": "^6.9.16",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"

package/tests/handler.spec.ts

@@ -4,6 +4,7 @@ import type { AxiosResponse } from 'axios'
 import type { AbstractResponse } from '@owlmeans/entrypoint'
 import { EntrypointOutcome } from '@owlmeans/entrypoint'
 import { ResilientError } from '@owlmeans/error'
+import { RecordExists, UnknownRecordError } from '@owlmeans/resource'
 import {
   ApiClientError, ApiStatusError, ServerAuthError, ServerCrashedError, httpStatusOf, incidentIdOf,
   INCIDENT_ID_HEADER,
@@ -143,6 +144,41 @@ describe('a development body stays its typed class', () => {
     expect(error.status).toBe(409)
     expect(error.incidentId).toBe(INCIDENT)
   })
+
+  test('a storage refusal (404 absent record, 409 taken key) rebuilds into its own class', () => {
+    for (const [refusal, code] of [
+      [new UnknownRecordError('shelf/3'), 404], [new RecordExists('isbn'), 409],
+    ] as const) {
+      const body = ResilientError.marshal(refusal, { includeStack: true, incidentId: INCIDENT }).message
+      const { error } = respond(code, body, { [INCIDENT_ID_HEADER]: INCIDENT })
+      expect(error!.constructor).toBe(refusal.constructor)
+      expect(error!.message).toBe(refusal.message)
+      expect(httpStatusOf(error)).toBe(code)
+      expect(incidentIdOf(error)).toBe(INCIDENT)
+    }
+    const body = ResilientError.marshal(new UnknownRecordError('shelf/3')).message
+    expect((respond(404, body).error as UnknownRecordError).id).toBe('shelf/3')
+  })
+
+  test('a class this process never registered still answers the status the server sent', () => {
+    const body = `ApiSpecUnregisteredRefusal${ResilientError.separator}spec:unregistered:x`
+    const { error } = respond(404, body, { [INCIDENT_ID_HEADER]: INCIDENT })
+    expect(error).not.toBeInstanceOf(ServerCrashedError)
+    expect(httpStatusOf(error)).toBe(404)
+    expect(incidentIdOf(error)).toBe(INCIDENT)
+  })
+})
+
+describe('a production body of a storage refusal keeps the declared status', () => {
+  test('404 and 409 become status errors, not a crash', () => {
+    for (const code of [404, 409]) {
+      const { error } = respond(code, INCIDENT)
+      expect(error).toBeInstanceOf(ApiStatusError)
+      expect(error).not.toBeInstanceOf(ServerCrashedError)
+      expect(error!.message).toBe(`api:client:status:${code}:${INCIDENT}`)
+      expect(httpStatusOf(error)).toBe(code)
+    }
+  })
 })
 
 describe('marshal round trips', () => {