@devp0nt/error0 1.0.0-next.46 → 1.0.0-next.47

package/dist/esm/plugins/meta.js

@@ -0,0 +1,49 @@
+import { Error0 } from "../index.js";
+const toJsonSafe = (input) => {
+  if (input === null) {
+    return null;
+  }
+  if (typeof input === "string" || typeof input === "number" || typeof input === "boolean") {
+    return input;
+  }
+  if (Array.isArray(input)) {
+    return input.map((value) => toJsonSafe(value));
+  }
+  if (typeof input === "object") {
+    const output = {};
+    for (const [key, value] of Object.entries(input)) {
+      const jsonValue = toJsonSafe(value);
+      if (jsonValue !== void 0) {
+        output[key] = jsonValue;
+      }
+    }
+    return output;
+  }
+  return void 0;
+};
+const isMetaRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const metaPlugin = Error0.plugin().use("prop", "meta", {
+  init: (input) => input,
+  resolve: ({ flow }) => {
+    const values = flow.filter(isMetaRecord);
+    if (values.length === 0) {
+      return void 0;
+    }
+    const merged = {};
+    for (const value of [...values].reverse()) {
+      Object.assign(merged, value);
+    }
+    return merged;
+  },
+  serialize: ({ value, isPublic }) => isPublic ? void 0 : toJsonSafe(value),
+  deserialize: ({ value }) => {
+    if (!isMetaRecord(value)) {
+      return void 0;
+    }
+    return value;
+  }
+});
+export {
+  metaPlugin
+};
+//# sourceMappingURL=meta.js.map

package/dist/esm/plugins/meta.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/meta.ts"],"sourcesContent":["import { Error0 } from '../index.js'\n\ntype Json = null | boolean | number | string | Json[] | { [key: string]: Json }\n\nconst toJsonSafe = (input: unknown): Json | undefined => {\n  if (input === null) {\n    return null\n  }\n  if (typeof input === 'string' || typeof input === 'number' || typeof input === 'boolean') {\n    return input\n  }\n  if (Array.isArray(input)) {\n    return input.map((value) => toJsonSafe(value)) as Json[]\n  }\n  if (typeof input === 'object') {\n    const output: Record<string, Json> = {}\n    for (const [key, value] of Object.entries(input as Record<string, unknown>)) {\n      const jsonValue = toJsonSafe(value)\n      if (jsonValue !== undefined) {\n        output[key] = jsonValue\n      }\n    }\n    return output\n  }\n  return undefined\n}\n\nconst isMetaRecord = (value: unknown): value is Record<string, unknown> =>\n  typeof value === 'object' && value !== null && !Array.isArray(value)\n\nexport const metaPlugin = Error0.plugin().use('prop', 'meta', {\n  init: (input: Record<string, unknown>) => input,\n  resolve: ({ flow }) => {\n    const values = flow.filter(isMetaRecord)\n    if (values.length === 0) {\n      return undefined\n    }\n\n    // Merge cause meta into the current error; nearer errors win on conflicts.\n    const merged: Record<string, unknown> = {}\n    for (const value of [...values].reverse()) {\n      Object.assign(merged, value)\n    }\n    return merged\n  },\n  serialize: ({ value, isPublic }) => (isPublic ? undefined : toJsonSafe(value)),\n  deserialize: ({ value }) => {\n    if (!isMetaRecord(value)) {\n      return undefined\n    }\n    return value\n  },\n})\n"],"mappings":"AAAA,SAAS,cAAc;AAIvB,MAAM,aAAa,CAAC,UAAqC;AACvD,MAAI,UAAU,MAAM;AAClB,WAAO;AAAA,EACT;AACA,MAAI,OAAO,UAAU,YAAY,OAAO,UAAU,YAAY,OAAO,UAAU,WAAW;AACxF,WAAO;AAAA,EACT;AACA,MAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,WAAO,MAAM,IAAI,CAAC,UAAU,WAAW,KAAK,CAAC;AAAA,EAC/C;AACA,MAAI,OAAO,UAAU,UAAU;AAC7B,UAAM,SAA+B,CAAC;AACtC,eAAW,CAAC,KAAK,KAAK,KAAK,OAAO,QAAQ,KAAgC,GAAG;AAC3E,YAAM,YAAY,WAAW,KAAK;AAClC,UAAI,cAAc,QAAW;AAC3B,eAAO,GAAG,IAAI;AAAA,MAChB;AAAA,IACF;AACA,WAAO;AAAA,EACT;AACA,SAAO;AACT;AAEA,MAAM,eAAe,CAAC,UACpB,OAAO,UAAU,YAAY,UAAU,QAAQ,CAAC,MAAM,QAAQ,KAAK;AAE9D,MAAM,aAAa,OAAO,OAAO,EAAE,IAAI,QAAQ,QAAQ;AAAA,EAC5D,MAAM,CAAC,UAAmC;AAAA,EAC1C,SAAS,CAAC,EAAE,KAAK,MAAM;AACrB,UAAM,SAAS,KAAK,OAAO,YAAY;AACvC,QAAI,OAAO,WAAW,GAAG;AACvB,aAAO;AAAA,IACT;AAGA,UAAM,SAAkC,CAAC;AACzC,eAAW,SAAS,CAAC,GAAG,MAAM,EAAE,QAAQ,GAAG;AACzC,aAAO,OAAO,QAAQ,KAAK;AAAA,IAC7B;AACA,WAAO;AAAA,EACT;AAAA,EACA,WAAW,CAAC,EAAE,OAAO,SAAS,MAAO,WAAW,SAAY,WAAW,KAAK;AAAA,EAC5E,aAAa,CAAC,EAAE,MAAM,MAAM;AAC1B,QAAI,CAAC,aAAa,KAAK,GAAG;AACxB,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AACF,CAAC;","names":[]}

package/dist/esm/plugins/stack-merge.d.ts

@@ -0,0 +1,5 @@
+import { PluginError0 } from '../index.js';
+
+declare const stackMergePlugin: PluginError0<Record<never, never>, Record<never, never>>;
+
+export { stackMergePlugin };

package/dist/esm/plugins/stack-merge.js

@@ -0,0 +1,15 @@
+import { Error0 } from "../index.js";
+const stackMergePlugin = Error0.plugin().use("stack", {
+  serialize: ({ error, isPublic }) => {
+    if (isPublic) {
+      return void 0;
+    }
+    return error.causes().map((cause) => {
+      return cause instanceof Error ? cause.stack : void 0;
+    }).filter((value) => typeof value === "string").join("\n");
+  }
+});
+export {
+  stackMergePlugin
+};
+//# sourceMappingURL=stack-merge.js.map

package/dist/esm/plugins/stack-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/stack-merge.ts"],"sourcesContent":["import { Error0 } from '../index.js'\n\nexport const stackMergePlugin = Error0.plugin().use('stack', {\n  serialize: ({ error, isPublic }) => {\n    if (isPublic) {\n      return undefined\n    }\n    return error\n      .causes()\n      .map((cause) => {\n        return cause instanceof Error ? cause.stack : undefined\n      })\n      .filter((value): value is string => typeof value === 'string')\n      .join('\\n')\n  },\n})\n"],"mappings":"AAAA,SAAS,cAAc;AAEhB,MAAM,mBAAmB,OAAO,OAAO,EAAE,IAAI,SAAS;AAAA,EAC3D,WAAW,CAAC,EAAE,OAAO,SAAS,MAAM;AAClC,QAAI,UAAU;AACZ,aAAO;AAAA,IACT;AACA,WAAO,MACJ,OAAO,EACP,IAAI,CAAC,UAAU;AACd,aAAO,iBAAiB,QAAQ,MAAM,QAAQ;AAAA,IAChD,CAAC,EACA,OAAO,CAAC,UAA2B,OAAO,UAAU,QAAQ,EAC5D,KAAK,IAAI;AAAA,EACd;AACF,CAAC;","names":[]}

package/dist/esm/plugins/tags.d.ts

@@ -0,0 +1,5 @@
+import { PluginError0, ErrorPluginPropOptions, Error0 } from '../index.js';
+
+declare const tagsPlugin: PluginError0<Record<never, never> & Record<"tags", ErrorPluginPropOptions<string[], string[], Error0, string[] | undefined>>, Record<never, never>>;
+
+export { tagsPlugin };

package/dist/esm/plugins/tags.js

@@ -0,0 +1,24 @@
+import { Error0 } from "../index.js";
+const tagsPlugin = Error0.plugin().use("prop", "tags", {
+  init: (input) => input,
+  resolve: ({ flow }) => {
+    const merged = [];
+    for (const value of flow) {
+      if (Array.isArray(value)) {
+        merged.push(...value.filter((item) => typeof item === "string"));
+      }
+    }
+    return merged.length > 0 ? Array.from(new Set(merged)) : void 0;
+  },
+  serialize: ({ value, isPublic }) => isPublic ? void 0 : value,
+  deserialize: ({ value }) => {
+    if (!Array.isArray(value)) {
+      return void 0;
+    }
+    return value.filter((item) => typeof item === "string");
+  }
+});
+export {
+  tagsPlugin
+};
+//# sourceMappingURL=tags.js.map

package/dist/esm/plugins/tags.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/plugins/tags.ts"],"sourcesContent":["import { Error0 } from '../index.js'\n\nexport const tagsPlugin = Error0.plugin().use('prop', 'tags', {\n  init: (input: string[]) => input,\n  resolve: ({ flow }) => {\n    const merged: string[] = []\n    for (const value of flow) {\n      if (Array.isArray(value)) {\n        merged.push(...value.filter((item): item is string => typeof item === 'string'))\n      }\n    }\n    return merged.length > 0 ? Array.from(new Set(merged)) : undefined\n  },\n  serialize: ({ value, isPublic }) => (isPublic ? undefined : value),\n  deserialize: ({ value }) => {\n    if (!Array.isArray(value)) {\n      return undefined\n    }\n    return value.filter((item): item is string => typeof item === 'string')\n  },\n})\n"],"mappings":"AAAA,SAAS,cAAc;AAEhB,MAAM,aAAa,OAAO,OAAO,EAAE,IAAI,QAAQ,QAAQ;AAAA,EAC5D,MAAM,CAAC,UAAoB;AAAA,EAC3B,SAAS,CAAC,EAAE,KAAK,MAAM;AACrB,UAAM,SAAmB,CAAC;AAC1B,eAAW,SAAS,MAAM;AACxB,UAAI,MAAM,QAAQ,KAAK,GAAG;AACxB,eAAO,KAAK,GAAG,MAAM,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ,CAAC;AAAA,MACjF;AAAA,IACF;AACA,WAAO,OAAO,SAAS,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI;AAAA,EAC3D;AAAA,EACA,WAAW,CAAC,EAAE,OAAO,SAAS,MAAO,WAAW,SAAY;AAAA,EAC5D,aAAa,CAAC,EAAE,MAAM,MAAM;AAC1B,QAAI,CAAC,MAAM,QAAQ,KAAK,GAAG;AACzB,aAAO;AAAA,IACT;AACA,WAAO,MAAM,OAAO,CAAC,SAAyB,OAAO,SAAS,QAAQ;AAAA,EACxE;AACF,CAAC;","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@devp0nt/error0",
-  "version": "1.0.0-next.46",
+  "version": "1.0.0-next.47",
   "license": "MIT",
   "author": {
     "name": "Sergei Dmitriev",
@@ -23,12 +23,20 @@
       "types": "./dist/esm/index.d.ts",
       "require": "./dist/cjs/index.cjs",
       "import": "./dist/esm/index.js"
+    },
+    "./plugins/*": {
+      "types": "./dist/esm/plugins/*.d.ts",
+      "require": "./dist/cjs/plugins/*.cjs",
+      "import": "./dist/esm/plugins/*.js"
     }
   },
   "typesVersions": {
     "*": {
       "": [
         "./dist/esm/index.d.ts"
+      ],
+      "plugins/*": [
+        "./dist/esm/plugins/*"
       ]
     }
   },

package/src/index.test.ts

@@ -185,27 +185,35 @@ describe('Error0', () => {
   })
 
   it('stack plugin can customize stack serialization without defining prop plugin', () => {
-    const AppError = Error0.use('stack', ({ value }) => (value ? `custom:${value}` : undefined))
+    const AppError = Error0.use('stack', { serialize: ({ value }) => (value ? `custom:${value}` : undefined) })
     const error = new AppError('test')
     const json = AppError.serialize(error)
     expect(typeof json.stack).toBe('string')
     expect((json.stack as string).startsWith('custom:')).toBe(true)
   })
 
-  it('stack plugin serialize true keeps default stack', () => {
-    const AppError = Error0.use('stack', true)
+  it('stack plugin can keep default stack via identity function', () => {
+    const AppError = Error0.use('stack', { serialize: ({ value }) => value })
     const error = new AppError('test')
     const json = AppError.serialize(error)
     expect(json.stack).toBe(error.stack)
   })
 
-  it('stack plugin serialize false disables stack serialization', () => {
-    const AppError = Error0.use('stack', false)
+  it('stack plugin can disable stack serialization via function', () => {
+    const AppError = Error0.use('stack', { serialize: () => undefined })
     const error = new AppError('test')
     const json = AppError.serialize(error)
     expect('stack' in json).toBe(false)
   })
 
+  it('stack plugin rejects boolean config', () => {
+    expect(() => Error0.use('stack', true as any)).toThrow('expects { serialize: function }')
+  })
+
+  it('message plugin rejects boolean config', () => {
+    expect(() => Error0.use('message', true as any)).toThrow('expects { serialize: function }')
+  })
+
   it('prop("stack") throws and suggests using stack plugin', () => {
     expect(() =>
       Error0.use('prop', 'stack', {
@@ -228,6 +236,26 @@ describe('Error0', () => {
     ).toThrow('reserved prop key')
   })
 
+  it('prop("message") throws and suggests using message plugin', () => {
+    expect(() =>
+      Error0.use('prop', 'message', {
+        resolve: ({ own }) => own as string,
+        serialize: ({ value }) => value,
+        deserialize: ({ value }) => (typeof value === 'string' ? value : undefined),
+      }),
+    ).toThrow('reserved prop key')
+  })
+
+  it('plugin builder also rejects prop("message") as reserved key', () => {
+    expect(() =>
+      Error0.plugin().prop('message', {
+        resolve: ({ own }) => own as string,
+        serialize: ({ value }) => value,
+        deserialize: ({ value }) => (typeof value === 'string' ? value : undefined),
+      }),
+    ).toThrow('reserved prop key')
+  })
+
   it('.serialize() -> .from() roundtrip keeps plugin values', () => {
     const AppError = Error0.use(statusPlugin).use(codePlugin)
     const error = new AppError('test', { status: 409, code: 'NOT_FOUND' })
@@ -249,22 +277,12 @@ describe('Error0', () => {
     expect('cause' in json).toBe(false)
   })
 
-  it('cause plugin true serializes and deserializes nested Error0 causes', () => {
-    const AppError = Error0.use(statusPlugin).use(codePlugin).use('cause', true)
-    const causeError = new AppError('cause', { status: 409, code: 'NOT_FOUND' })
-    const error = new AppError('root', { status: 500, cause: causeError })
 
+  it('by default causes not serialized', () => {
+    const AppError = Error0.use(statusPlugin).use(codePlugin)
+    const error = new AppError('test', { status: 400, code: 'NOT_FOUND' })
     const json = AppError.serialize(error, false)
-    expect(typeof json.cause).toBe('object')
-    expect((json.cause as Record<string, unknown>).message).toBe('cause')
-    expect((json.cause as Record<string, unknown>).status).toBe(409)
-    expect((json.cause as Record<string, unknown>).code).toBe('NOT_FOUND')
-
-    const recreated = AppError.from(json)
-    expect(recreated).toBeInstanceOf(AppError)
-    expect(recreated.cause).toBeInstanceOf(AppError)
-    expect((recreated.cause as InstanceType<typeof AppError>).status).toBe(409)
-    expect((recreated.cause as InstanceType<typeof AppError>).code).toBe('NOT_FOUND')
+    expect('cause' in json).toBe(false)
   })
 
   it('serialize can hide props for public output', () => {
@@ -536,41 +554,19 @@ describe('Error0', () => {
     expect(error1.code).toBe(undefined)
   })
 
-  it('expected prop can be realized to send or not to send error to your error tracker', () => {
-    const AppError = Error0.use(statusPlugin)
-      .use('prop', 'expected', {
-        init: (input: boolean) => input,
-        resolve: ({ flow }) => flow.find((value) => typeof value === 'boolean'),
-        serialize: ({ value }) => value,
-        deserialize: ({ value }) => (typeof value === 'boolean' ? value : undefined),
-      })
-      .use('method', 'isExpected', (error) => {
-        return error.expected ?? false
-      })
-    const errorExpected = new AppError('test', { status: 400, expected: true })
-    const errorUnexpected = new AppError('test', { status: 400, expected: false })
-    const usualError = new Error('test')
-    const errorFromUsualError = AppError.from(usualError)
-    const errorWithExpectedErrorAsCause = new AppError('test', { status: 400, cause: errorExpected })
-    const errorWithUnexpectedErrorAsCause = new AppError('test', { status: 400, cause: errorUnexpected })
-    expect(errorExpected.expected).toBe(true)
-    expect(errorUnexpected.expected).toBe(false)
-    expect(AppError.isExpected(usualError)).toBe(false)
-    expect(errorFromUsualError.expected).toBe(undefined)
-    expect(errorFromUsualError.isExpected()).toBe(false)
-    expect(errorWithExpectedErrorAsCause.expected).toBe(true)
-    expect(errorWithExpectedErrorAsCause.isExpected()).toBe(true)
-    expect(errorWithUnexpectedErrorAsCause.expected).toBe(false)
-    expect(errorWithUnexpectedErrorAsCause.isExpected()).toBe(false)
-  })
 
   it('messages can be combined on serialization', () => {
     const AppError = Error0.use(statusPlugin)
       .use(codePlugin)
-      .use('prop', 'message', {
-        resolve: ({ own }) => own as string,
-        serialize: ({ value, error }) => error.flow('message').join(': '),
-        deserialize: ({ value }) => (typeof value === 'string' ? value : undefined),
+      .use('message', {
+        serialize: ({ error }) =>
+          error
+            .causes()
+            .map((cause) => {
+              return cause instanceof Error ? cause.message : undefined
+            })
+            .filter((value): value is string => typeof value === 'string')
+            .join(': '),
       })
     const error1 = new AppError('test1', { status: 400, code: 'NOT_FOUND' })
     const error2 = new AppError({ message: 'test2', status: 401, cause: error1 })
@@ -584,15 +580,16 @@ describe('Error0', () => {
   it('stack plugin can merge stack across causes in one serialized value', () => {
     const AppError = Error0.use(statusPlugin)
       .use(codePlugin)
-      .use('stack', ({ error }) =>
-        error
-          .causes()
-          .map((cause) => {
-            return cause instanceof Error ? cause.stack : undefined
-          })
-          .filter((value): value is string => typeof value === 'string')
-          .join('\n'),
-      )
+      .use('stack', {
+        serialize: ({ error }) =>
+          error
+            .causes()
+            .map((cause) => {
+              return cause instanceof Error ? cause.stack : undefined
+            })
+            .filter((value): value is string => typeof value === 'string')
+            .join('\n'),
+      })
     const error1 = new AppError('test1', { status: 400, code: 'NOT_FOUND' })
     const error2 = new AppError('test2', { status: 401, cause: error1 })
     const mergedStack1 = error1.serialize().stack as string
@@ -612,26 +609,6 @@ describe('Error0', () => {
     `)
   })
 
-  it('stack plugin can merge stack across causes in one serialized value by helper "merge"', () => {
-    const AppError = Error0.use(statusPlugin).use(codePlugin).use('stack', 'merge')
-    const error1 = new AppError('test1', { status: 400, code: 'NOT_FOUND' })
-    const error2 = new AppError('test2', { status: 401, cause: error1 })
-    const mergedStack1 = error1.serialize().stack as string
-    const mergedStack2 = error2.serialize().stack as string
-    expect(mergedStack1).toContain('Error0: test1')
-    expect(mergedStack2).toContain('Error0: test2')
-    expect(mergedStack2).toContain('Error0: test1')
-    expect(fixStack(mergedStack1)).toMatchInlineSnapshot(`
-      "Error0: test1
-          at <anonymous> (...)"
-    `)
-    expect(fixStack(mergedStack2)).toMatchInlineSnapshot(`
-      "Error0: test2
-          at <anonymous> (...)
-      Error0: test1
-          at <anonymous> (...)"
-    `)
-  })
 
   it('Error0 assignable to LikeError0', () => {
     type LikeError0 = {