@owlmeans/resource 0.1.18-rc.35 → 0.1.18-rc.37

package/README.md

@@ -12,7 +12,7 @@ wants is the `resource-choice` decision.
 ## Installation
 
 ```bash
-bun add @owlmeans/resource@^0.1.18-rc.35
+bun add @owlmeans/resource@^0.1.18-rc.37
 ```
 
 ## Concepts
@@ -403,7 +403,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.38
+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/resource",
-  "version": "0.1.18-rc.35",
-  "generatedAt": "2026-09-23T19:57:40.674Z",
+  "version": "0.1.18-rc.37",
+  "generatedAt": "2026-09-29T08:01:58.119Z",
   "canonicalRepo": "https://github.com/owlmeans/common",
   "entries": [
     {

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

@@ -8,7 +8,7 @@ user-invocable: false
 # @owlmeans/resource
 
 **Layer:** Core
-**Install:** `"@owlmeans/resource": "^0.1.18-rc.35"` in `dependencies`
+**Install:** `"@owlmeans/resource": "^0.1.18-rc.37"` in `dependencies`
 
 ## Key Exports
 
@@ -30,7 +30,7 @@ user-invocable: false
 | `ResourceDbService<Db, Client>`, `DbLocker<T>` | What a connection service implements: `db`/`client`/`clients`/`config`/`name`/`ensureConfigAlias`/`initialize`, plus `lock`/`unlock` when the backend encrypts fields. |
 | `ResourceMaker<R, T>` | `(dbAlias?, serviceAlias?) => T` — the signature every resource maker is typed with, so an app registers `makeXResource()` without repeating the argument list. |
 | `filterObject(obj, keep?)`, `createListSchema` | Drop null and undefined properties, keeping the names listed in `keep`; the AJV schema for a `ListResult<T>` envelope. |
-| Errors | `ResourceError`, `UnknownRecordError`, `MisshapedRecord`, `RecordExists`, `RecordUpdateFailed`, `UnsupportedArgumentError`, `UnsupportedMethodError`, `MigrationError`, `MigrationConflict`. |
+| Errors | `ResourceError`, `UnknownRecordError` (404), `MisshapedRecord`, `RecordExists` (409), `RecordUpdateFailed`, `UnsupportedArgumentError`, `UnsupportedMethodError`, `MigrationError`, `MigrationConflict` — the unmarked ones are faults (500). `tests/errors.spec.ts` refuses an exported class whose status was not decided. `UnknownRecordError.id` is everything after the first `/`, so an id or criteria text holding one survives. |
 | `DbConfig`, `Config`, `Context` | Database config (`cfg.dbs`) types. |
 
 ## Usage
@@ -85,6 +85,19 @@ else; the criteria overload takes `{ sort }` to say which match is "the" one:
 Every method returns the record(s) themselves, never a driver result object — there is no
 `rowsAffected`/`rowCount` anywhere on this contract.
 
+### What an escaped storage error answers
+
+The two refusals declare their HTTP status (`static httpStatus`, the `error` skill's rule), so an
+`@owlmeans/server-api` handler that lets one escape answers it: `UnknownRecordError` **404**,
+`RecordExists` **409** (a unique-key violation, a taken id, and a `create` handed an id —
+`id-present` — alike). Every other class of the family is a fault and answers 500. A development
+body rebuilds into the same class on the client; a production body is the incident id alone and
+arrives as `ApiStatusError` with that status (`@owlmeans/api`).
+
+So `get` only what the REQUEST addressed. A missing row it did not name — a configuration record,
+a session, an internal lookup — is not the caller's 404: `load` it and throw the fault or the
+refusal that fits (an auth path throws `AuthorizationError`).
+
 ### The criteria language
 
 `Criteria<T>` is keyed by the record's own fields, so a typo is a compile error. A dotted key

package/build/errors.d.ts

@@ -1,20 +1,33 @@
 import { ResilientError } from '@owlmeans/error';
+/**
+ * The storage refusal family. A class that answers the caller's request declares the HTTP status
+ * an `@owlmeans/server-api` boundary answers it with (`static httpStatus`, inherited through the
+ * constructor chain): an absent record 404, a taken id or unique key 409. A fault — a misshaped
+ * record, an unsupported argument, a failed migration — declares nothing and answers 500.
+ */
 export declare class ResourceError extends ResilientError {
     static typeName: string;
     constructor(message?: string);
 }
+/** The addressed record does not exist (`get`, `update`, `take` of an absent id or criteria). */
 export declare class UnknownRecordError extends ResourceError {
     static typeName: string;
+    /** The addressed record is absent: answered 404. */
+    static httpStatus: number;
     static readonly idSeparator: string;
     constructor(id: string);
+    /** Everything after the first separator — an id or a criteria description may contain one. */
     get id(): string;
 }
 export declare class MisshapedRecord extends ResourceError {
     static typeName: string;
     constructor(msg: string);
 }
+/** A record under that id or unique key is already stored (`create`, a unique-index violation). */
 export declare class RecordExists extends ResourceError {
     static typeName: string;
+    /** The id or unique key is taken: answered 409. */
+    static httpStatus: number;
     constructor(msg: string);
 }
 export declare class RecordUpdateFailed extends ResourceError {

package/build/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAG,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEjD,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAuB,QAAQ,SAAkB;IAEjD,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAuB,QAAQ,SAAgD;IAE/E,gBAAuB,WAAW,EAAE,MAAM,CAAM;IAEhD,YAAY,EAAE,EAAE,MAAM,EAGrB;IAED,IAAI,EAAE,IAAI,MAAM,CAEf;CACF;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,qBAAa,YAAa,SAAQ,aAAa;IAC7C,OAAuB,QAAQ,SAA0C;IAEzE,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAuB,QAAQ,SAAgD;IAE/E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,OAAuB,QAAQ,SAAsD;IAErF,YAAY,QAAQ,EAAE,MAAM,EAG3B;CACF;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,OAAuB,QAAQ,SAAoD;IAEnF,YAAY,MAAM,EAAE,MAAM,EAGzB;CACF;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAuB,QAAQ,SAA4C;IAE3E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAuB,QAAQ,SAA+C;IAE9E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAG,cAAc,EAAE,MAAM,iBAAiB,CAAA;AAEjD;;;;;GAKG;AACH,qBAAa,aAAc,SAAQ,cAAc;IAC/C,OAAuB,QAAQ,SAAkB;IAEjD,YAAY,OAAO,GAAE,MAAgB,EAEpC;CACF;AAED,iGAAiG;AACjG,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAuB,QAAQ,SAAgD;IAC/E,oDAAoD;IACpD,OAAc,UAAU,SAAM;IAE9B,gBAAuB,WAAW,EAAE,MAAM,CAAM;IAEhD,YAAY,EAAE,EAAE,MAAM,EAGrB;IAED,8FAA8F;IAC9F,IAAI,EAAE,IAAI,MAAM,CAIf;CACF;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAuB,QAAQ,SAA6C;IAE5E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,mGAAmG;AACnG,qBAAa,YAAa,SAAQ,aAAa;IAC7C,OAAuB,QAAQ,SAA0C;IACzE,mDAAmD;IACnD,OAAc,UAAU,SAAM;IAE9B,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,OAAuB,QAAQ,SAAgD;IAE/E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED,qBAAa,wBAAyB,SAAQ,aAAa;IACzD,OAAuB,QAAQ,SAAsD;IAErF,YAAY,QAAQ,EAAE,MAAM,EAG3B;CACF;AAED,qBAAa,sBAAuB,SAAQ,aAAa;IACvD,OAAuB,QAAQ,SAAoD;IAEnF,YAAY,MAAM,EAAE,MAAM,EAGzB;CACF;AAED;;;;GAIG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,OAAuB,QAAQ,SAA4C;IAE3E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF;AAED;;;;GAIG;AACH,qBAAa,iBAAkB,SAAQ,aAAa;IAClD,OAAuB,QAAQ,SAA+C;IAE9E,YAAY,GAAG,EAAE,MAAM,EAGtB;CACF"}

package/build/errors.js

@@ -1,19 +1,30 @@
 import { ResilientError } from '@owlmeans/error';
+/**
+ * The storage refusal family. A class that answers the caller's request declares the HTTP status
+ * an `@owlmeans/server-api` boundary answers it with (`static httpStatus`, inherited through the
+ * constructor chain): an absent record 404, a taken id or unique key 409. A fault — a misshaped
+ * record, an unsupported argument, a failed migration — declares nothing and answers 500.
+ */
 export class ResourceError extends ResilientError {
     static typeName = 'ResourceError';
     constructor(message = 'error') {
         super(ResourceError.typeName, `resource:${message}`);
     }
 }
+/** The addressed record does not exist (`get`, `update`, `take` of an absent id or criteria). */
 export class UnknownRecordError extends ResourceError {
     static typeName = `${ResourceError.typeName}UnknownRecordError`;
+    /** The addressed record is absent: answered 404. */
+    static httpStatus = 404;
     static idSeparator = '/';
     constructor(id) {
         super(`unknown-record${UnknownRecordError.idSeparator}${id}`);
         this.type = UnknownRecordError.typeName;
     }
+    /** Everything after the first separator — an id or a criteria description may contain one. */
     get id() {
-        return this.message.split(UnknownRecordError.idSeparator)[1];
+        const at = this.message.indexOf(UnknownRecordError.idSeparator);
+        return at < 0 ? '' : this.message.slice(at + UnknownRecordError.idSeparator.length);
     }
 }
 export class MisshapedRecord extends ResourceError {
@@ -23,8 +34,11 @@ export class MisshapedRecord extends ResourceError {
         this.type = MisshapedRecord.typeName;
     }
 }
+/** A record under that id or unique key is already stored (`create`, a unique-index violation). */
 export class RecordExists extends ResourceError {
     static typeName = `${ResourceError.typeName}RecordExists`;
+    /** The id or unique key is taken: answered 409. */
+    static httpStatus = 409;
     constructor(msg) {
         super(`record-exists:${msg}`);
         this.type = RecordExists.typeName;

package/build/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "@owlmeans/resource",
-  "version": "0.1.18-rc.35",
+  "version": "0.1.18-rc.37",
   "license": "MIT",
   "type": "module",
   "scripts": {
     "build": "tsc -b",
     "dev": "sleep 252 && nodemon -e ts,tsx,json --watch src --exec \"tsc -p ./tsconfig.json\"",
-    "watch": "tsc -b -w --preserveWatchOutput --pretty"
+    "watch": "tsc -b -w --preserveWatchOutput --pretty",
+    "test": "bun test ./tests"
   },
   "main": "build/index.js",
   "module": "build/index.js",
@@ -22,13 +23,14 @@
   },
   "dependencies": {
     "@owlmeans/context": "^0.1.18-rc.32",
-    "@owlmeans/error": "^0.1.18-rc.35"
+    "@owlmeans/error": "^0.1.18-rc.36"
   },
   "peerDependencies": {
     "ajv": "*"
   },
   "devDependencies": {
     "@owlmeans/dep-config": "workspace:*",
+    "@types/bun": "^1.4.0",
     "nodemon": "^3.1.14",
     "typescript": "^7.0.2"
   },

package/src/errors.ts

@@ -1,6 +1,12 @@
 
 import {  ResilientError } from '@owlmeans/error'
 
+/**
+ * The storage refusal family. A class that answers the caller's request declares the HTTP status
+ * an `@owlmeans/server-api` boundary answers it with (`static httpStatus`, inherited through the
+ * constructor chain): an absent record 404, a taken id or unique key 409. A fault — a misshaped
+ * record, an unsupported argument, a failed migration — declares nothing and answers 500.
+ */
 export class ResourceError extends ResilientError {
   public static override typeName = 'ResourceError'
 
@@ -9,8 +15,11 @@ export class ResourceError extends ResilientError {
   }
 }
 
+/** The addressed record does not exist (`get`, `update`, `take` of an absent id or criteria). */
 export class UnknownRecordError extends ResourceError {
   public static override typeName = `${ResourceError.typeName}UnknownRecordError`
+  /** The addressed record is absent: answered 404. */
+  public static httpStatus = 404
 
   public static readonly idSeparator: string = '/'
 
@@ -19,8 +28,11 @@ export class UnknownRecordError extends ResourceError {
     this.type = UnknownRecordError.typeName
   }
 
+  /** Everything after the first separator — an id or a criteria description may contain one. */
   get id(): string {
-    return this.message.split(UnknownRecordError.idSeparator)[1]
+    const at = this.message.indexOf(UnknownRecordError.idSeparator)
+
+    return at < 0 ? '' : this.message.slice(at + UnknownRecordError.idSeparator.length)
   }
 }
 
@@ -33,8 +45,11 @@ export class MisshapedRecord extends ResourceError {
   }
 }
 
+/** A record under that id or unique key is already stored (`create`, a unique-index violation). */
 export class RecordExists extends ResourceError {
   public static override typeName = `${ResourceError.typeName}RecordExists`
+  /** The id or unique key is taken: answered 409. */
+  public static httpStatus = 409
 
   constructor(msg: string) {
     super(`record-exists:${msg}`)

package/tests/errors.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=errors.spec.d.ts.map

package/tests/errors.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.spec.d.ts","sourceRoot":"","sources":["errors.spec.ts"],"names":[],"mappings":""}

package/tests/errors.spec.js

@@ -0,0 +1,51 @@
+import { describe, expect, test } from 'bun:test';
+import { ResilientError } from '@owlmeans/error';
+import * as errors from '../src/errors.js';
+/**
+ * The status an HTTP boundary (`@owlmeans/server-api` `errorStatus`) reads off a class: a static
+ * `httpStatus` inherited through the constructor chain. A refusal of the caller's request declares
+ * a 4xx; a fault declares nothing and answers 500.
+ */
+const statusOf = (error) => error.constructor.httpStatus;
+const DECLARED = {
+    ResourceError: undefined,
+    UnknownRecordError: 404,
+    RecordExists: 409,
+    MisshapedRecord: undefined,
+    RecordUpdateFailed: undefined,
+    UnsupportedArgumentError: undefined,
+    UnsupportedMethodError: undefined,
+    MigrationError: undefined,
+    MigrationConflict: undefined,
+};
+const classes = Object.entries(errors).filter(([, value]) => typeof value === 'function' && value.prototype instanceof ResilientError);
+describe('resource errors — declared HTTP statuses', () => {
+    test('every class of the family has decided its status', () => {
+        expect(classes.map(([name]) => name).sort()).toEqual(Object.keys(DECLARED).sort());
+    });
+    test('an absent record is 404, a taken id or key 409; faults declare nothing', () => {
+        for (const [name, Class] of classes) {
+            expect([name, statusOf(new Class('x'))]).toEqual([name, DECLARED[name]]);
+        }
+    });
+    test('an error rebuilt from its marshalled form keeps its class and its status', () => {
+        for (const [name, Class] of classes) {
+            const back = ResilientError.ensure(new Class('x').marshal());
+            expect([name, back.constructor === Class, statusOf(back)]).toEqual([name, true, DECLARED[name]]);
+        }
+    });
+});
+describe('UnknownRecordError.id', () => {
+    test('is everything after the first separator, however many the id carries', () => {
+        expect(new errors.UnknownRecordError('abc').id).toBe('abc');
+        expect(new errors.UnknownRecordError('shelf/3/hammer').id).toBe('shelf/3/hammer');
+        expect(new errors.UnknownRecordError('{"url":"https://example.org/a"}').id)
+            .toBe('{"url":"https://example.org/a"}');
+    });
+    test('survives a marshal round trip', () => {
+        const back = ResilientError.ensure(new errors.UnknownRecordError('shelf/3').marshal());
+        expect(back).toBeInstanceOf(errors.UnknownRecordError);
+        expect(back.id).toBe('shelf/3');
+    });
+});
+//# sourceMappingURL=errors.spec.js.map

package/tests/errors.spec.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.spec.js","sourceRoot":"","sources":["errors.spec.ts"],"names":[],"mappings":"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"}

package/tests/errors.spec.ts

@@ -0,0 +1,60 @@
+import { describe, expect, test } from 'bun:test'
+import { ResilientError } from '@owlmeans/error'
+import * as errors from '../src/errors.js'
+
+/**
+ * The status an HTTP boundary (`@owlmeans/server-api` `errorStatus`) reads off a class: a static
+ * `httpStatus` inherited through the constructor chain. A refusal of the caller's request declares
+ * a 4xx; a fault declares nothing and answers 500.
+ */
+const statusOf = (error: Error): unknown => (error.constructor as { httpStatus?: unknown }).httpStatus
+
+const DECLARED: Record<string, number | undefined> = {
+  ResourceError: undefined,
+  UnknownRecordError: 404,
+  RecordExists: 409,
+  MisshapedRecord: undefined,
+  RecordUpdateFailed: undefined,
+  UnsupportedArgumentError: undefined,
+  UnsupportedMethodError: undefined,
+  MigrationError: undefined,
+  MigrationConflict: undefined,
+}
+
+const classes = Object.entries(errors).filter(([, value]) =>
+  typeof value === 'function' && value.prototype instanceof ResilientError
+) as [string, new (message: string) => ResilientError][]
+
+describe('resource errors — declared HTTP statuses', () => {
+  test('every class of the family has decided its status', () => {
+    expect(classes.map(([name]) => name).sort()).toEqual(Object.keys(DECLARED).sort())
+  })
+
+  test('an absent record is 404, a taken id or key 409; faults declare nothing', () => {
+    for (const [name, Class] of classes) {
+      expect([name, statusOf(new Class('x'))]).toEqual([name, DECLARED[name]])
+    }
+  })
+
+  test('an error rebuilt from its marshalled form keeps its class and its status', () => {
+    for (const [name, Class] of classes) {
+      const back = ResilientError.ensure(new Class('x').marshal())
+      expect([name, back.constructor === Class, statusOf(back)]).toEqual([name, true, DECLARED[name]])
+    }
+  })
+})
+
+describe('UnknownRecordError.id', () => {
+  test('is everything after the first separator, however many the id carries', () => {
+    expect(new errors.UnknownRecordError('abc').id).toBe('abc')
+    expect(new errors.UnknownRecordError('shelf/3/hammer').id).toBe('shelf/3/hammer')
+    expect(new errors.UnknownRecordError('{"url":"https://example.org/a"}').id)
+      .toBe('{"url":"https://example.org/a"}')
+  })
+
+  test('survives a marshal round trip', () => {
+    const back = ResilientError.ensure(new errors.UnknownRecordError('shelf/3').marshal())
+    expect(back).toBeInstanceOf(errors.UnknownRecordError)
+    expect((back as errors.UnknownRecordError).id).toBe('shelf/3')
+  })
+})

package/tests/tsconfig.json

@@ -0,0 +1,17 @@
+{
+  "extends": [
+    "@owlmeans/dep-config/tsconfig.base.json",
+    "@owlmeans/dep-config/tsconfig.node.json"
+  ],
+  "compilerOptions": {
+    "types": [
+      "bun"
+    ],
+    "rootDir": "../",
+    "noEmit": true
+  },
+  "include": [
+    "./**/*",
+    "../src/**/*"
+  ]
+}

package/tsconfig.json

@@ -6,5 +6,5 @@
     "rootDir": "./src/",
     "outDir": "./build/"
   },
-  "exclude": ["./dist/**/*", "./build/**/*", "./*.ts"]
+  "exclude": ["./dist/**/*", "./build/**/*", "./tests/**/*", "./*.ts"]
 }