@zerospin/error 2.0.1

package/.tsbuildinfo/build.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../src/zerospinerror.ts","../src/zerospinerrorjsonschema.ts","../src/index.ts","../src/types.ts"],"version":"5.9.0-dev.20250623"}

package/.turbo/turbo-lint.log

@@ -0,0 +1,20 @@
+
+
+> @zerospin/error@2.0.1 lint /Users/morgs32/GitHub/zerospin/packages/error
+> eslint .
+
+=============
+
+
+WARNING: You are currently running a version of TypeScript which is not officially supported by @typescript-eslint/typescript-estree.
+
+
+* @typescript-eslint/typescript-estree version: 8.34.1
+* Supported TypeScript versions: >=4.8.4 <5.9.0
+* Your TypeScript version: 5.9.0-dev.20250623
+
+
+Please only submit bug reports when using the officially supported version.
+
+
+=============

package/dist/ZerospinError.js

@@ -0,0 +1,44 @@
+import { Brand, Data } from 'effect';
+import { isObject } from 'effect/Predicate';
+export class ZerospinError extends Data.TaggedError('ZerospinError') {
+    message;
+    constructor(props) {
+        if (typeof props === 'string') {
+            super({
+                code: props,
+                extra: null,
+                message: props,
+                status: null,
+            });
+            this.message = props;
+        }
+        else {
+            super({
+                status: null,
+                ...props,
+            });
+            this.message = props.message ?? props.code;
+        }
+    }
+    static isZerospinError(data) {
+        return isObject(data) && '_tag' in data && data._tag === 'ZerospinError';
+    }
+    static makeZerospinErrorJson(props) {
+        return Brand.nominal()(props);
+    }
+    serialize(
+    // You can omit anything BUT id, code
+    omit = []) {
+        const json = ZerospinError.makeZerospinErrorJson({
+            cause: this.cause,
+            code: this.code,
+            extra: this.extra,
+            message: this.message,
+            status: this.status,
+        });
+        for (const key of omit) {
+            delete json[key];
+        }
+        return json;
+    }
+}

package/dist/ZerospinErrorJsonSchema.js

@@ -0,0 +1,7 @@
+import { Schema } from 'effect';
+export const ZerospinErrorJsonSchema = Schema.Struct({
+    code: Schema.String,
+    extra: Schema.Unknown,
+    message: Schema.String,
+    status: Schema.Union(Schema.Null, Schema.Number),
+});

package/dist/index.js

@@ -0,0 +1,2 @@
+export * from './ZerospinError';
+export * from './ZerospinErrorJsonSchema';

package/dist/types.js

@@ -0,0 +1 @@
+export {};

package/eslint.config.ts

@@ -0,0 +1,10 @@
+import { baseConfig, defineConfig } from '@zerospin/utils'
+
+const eslintConfig = defineConfig(
+  {
+    ignores: ['dist', 'node_modules', '.turbo'],
+  },
+  baseConfig
+)
+
+export default eslintConfig

package/package.json

@@ -0,0 +1,45 @@
+{
+  "name": "@zerospin/error",
+  "version": "2.0.1",
+  "private": false,
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./src/index.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.js"
+    }
+  },
+  "dependencies": {
+    "type-fest": "^4.41.0"
+  },
+  "devDependencies": {
+    "@effect/language-service": "^0.43.2",
+    "@effect/vitest": "^0.25.1",
+    "@vitest/coverage-v8": "^3.2.4",
+    "@vitest/pretty-format": "^3.1.4",
+    "effect": "^3.17.11",
+    "eslint": "^9.27.0",
+    "glob": "^11.0.3",
+    "jsdom": "^26.1.0",
+    "knip": "^4.2.4",
+    "tsafe": "^1.8.5",
+    "tsx": "^4.20.3",
+    "vite-tsconfig-paths": "^5.1.4",
+    "vitest": "^3.2.4",
+    "@zerospin/utils": "2.0.1"
+  },
+  "peerDependencies": {
+    "effect": "^3.15.2"
+  },
+  "scripts": {
+    "build": "tsc -b tsconfig.build.json",
+    "watch": "tsc -b tsconfig.build.json --watch",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "lint": "eslint .",
+    "test:watch": "vitest watch",
+    "test:coverage": "vitest run --coverage",
+    "knip": "knip"
+  }
+}

package/src/ZerospinError.ts

@@ -0,0 +1,83 @@
+import type { RequiredKeysOf } from 'type-fest'
+
+import { Brand, Data } from 'effect'
+import { isObject } from 'effect/Predicate'
+
+import type { IAnyErrorJson } from './types'
+
+interface IProps<T extends string = string, E = unknown> {
+  code: T
+  cause?: unknown
+  extra?: E
+  message?: string
+  status?: null | number
+}
+
+export interface IError<T extends string = string, E = unknown> {
+  code: T
+  status: null | number
+  cause?: unknown
+  extra?: E
+  message?: string
+}
+
+export class ZerospinError<
+  T extends string = never,
+  E = unknown,
+> extends Data.TaggedError('ZerospinError')<IError<T, E>> {
+  public override message!: string
+
+  constructor(props: IProps<T, E> | T) {
+    if (typeof props === 'string') {
+      super({
+        code: props,
+        extra: null as E,
+        message: props,
+        status: null,
+      })
+      this.message = props
+    } else {
+      super({
+        status: null,
+        ...props,
+      })
+      this.message = props.message ?? props.code
+    }
+  }
+
+  static isZerospinError(data: unknown): data is ZerospinError {
+    return isObject(data) && '_tag' in data && data._tag === 'ZerospinError'
+  }
+
+  static makeZerospinErrorJson(props: {
+    cause: unknown
+    code: string
+    extra: unknown
+    message: string
+    status: null | number
+  }): IAnyErrorJson {
+    return Brand.nominal<IAnyErrorJson>()(props)
+  }
+
+  serialize(
+    // You can omit anything BUT id, code
+    omit: Exclude<
+      keyof IAnyErrorJson,
+      RequiredKeysOf<IAnyErrorJson>
+    >[] = []
+  ): IAnyErrorJson {
+    const json = ZerospinError.makeZerospinErrorJson({
+      cause: this.cause,
+      code: this.code,
+      extra: this.extra,
+      message: this.message,
+      status: this.status,
+    })
+
+    for (const key of omit) {
+      delete json[key]
+    }
+
+    return json
+  }
+}

package/src/ZerospinErrorJsonSchema.ts

@@ -0,0 +1,10 @@
+import { Schema } from 'effect'
+
+import type { IAnyErrorJson } from './types'
+
+export const ZerospinErrorJsonSchema = Schema.Struct({
+  code: Schema.String,
+  extra: Schema.Unknown,
+  message: Schema.String,
+  status: Schema.Union(Schema.Null, Schema.Number),
+}) as any as Schema.Schema<IAnyErrorJson, any>

package/src/index.ts

@@ -0,0 +1,3 @@
+export type * from './types';
+export * from './ZerospinError';
+export * from './ZerospinErrorJsonSchema';

package/src/types.ts

@@ -0,0 +1,13 @@
+import type { Brand } from 'effect';
+
+import type { ZerospinError } from './ZerospinError';
+
+export type IAnyErrorJson<ERROR extends IAnyError = IAnyError> =
+  Brand.Brand<'ZerospinErrorJson'> & {
+    code: ERROR['code'];
+    extra: ERROR['extra'];
+    message: string;
+    status: null | number;
+  };
+
+export type IAnyError = ZerospinError<string>;

package/tsconfig.build.json

@@ -0,0 +1,13 @@
+{
+  "extends": "./tsconfig.json",
+  "include": [
+    "src"
+  ],
+  "compilerOptions": {
+    "tsBuildInfoFile": ".tsbuildinfo/build.tsbuildinfo",
+    "outDir": "dist",
+    "stripInternal": true,
+    "noEmit": false,
+    "rootDir": "./src"
+  }
+}

package/tsconfig.json

@@ -0,0 +1,15 @@
+{
+  "extends": "../../tsconfig.json",
+  "include": [
+    "src",
+    "*.ts"
+  ],
+  "compilerOptions": {
+    "incremental": false,
+    "types": [
+      "vitest/globals"
+    ],
+    "outDir": "./dist",
+    "rootDir": "."
+  }
+}