go-go-try 7.1.0 → 7.2.0

package/AGENTS.md

@@ -0,0 +1,182 @@
+# go-go-try - Agent Guide
+
+## Project Overview
+
+**go-go-try** is a TypeScript utility library for error handling inspired by Go's error handling pattern. It provides a functional approach to try/catch operations by returning a tuple `[error, value]` instead of throwing exceptions.
+
+- **Name**: go-go-try
+- **Version**: 6.2.0
+- **License**: MIT
+- **Repository**: thelinuxlich/go-go-try
+- **Node.js Requirements**: >= 16
+
+## Technology Stack
+
+- **Language**: TypeScript 5.8.3
+- **Build Tool**: [pkgroll](https://github.com/privatenumber/pkgroll) - A zero-config TypeScript package bundler
+- **Linter**: [Biome](https://biomejs.dev/) - Fast linter and formatter
+- **Test Framework**: [Vitest](https://vitest.dev/) - Vite-native unit test framework
+- **Type Testing**: [@ark/attest](https://github.com/arktypeio/arktype) - Runtime type assertions for TypeScript
+
+## Project Structure
+
+```
+.
+├── src/
+│   ├── index.ts        # Main source file - exports goTry, goTryRaw, and utility types
+│   └── index.test.ts   # Comprehensive test suite with runtime and type tests
+├── dist/               # Build output (generated by pkgroll)
+│   ├── index.cjs       # CommonJS build
+│   ├── index.mjs       # ES Module build
+│   ├── index.d.cts     # CommonJS type definitions
+│   └── index.d.mts     # ES Module type definitions
+├── .github/workflows/
+│   └── main.yml        # CI configuration for GitHub Actions
+├── .attest/            # Ark attest cache directory
+├── package.json        # Package configuration with dual CJS/ESM exports
+├── tsconfig.json       # TypeScript strict configuration
+├── vitest.config.ts    # Vitest configuration with type checking enabled
+├── setupVitest.ts      # Vitest global setup for @ark/attest
+└── README.md           # User-facing documentation
+```
+
+## Build and Test Commands
+
+```bash
+# Build the project (generates dist/ with CJS, ESM, and type definitions)
+npm run build
+
+# Run linting with auto-fix
+npm run lint
+
+# Run the full test suite (build + lint + vitest)
+npm test
+```
+
+The test script is a composite that:
+1. Builds the project
+2. Runs the linter
+3. Executes Vitest tests
+
+## Code Style Guidelines
+
+- **Linter**: Biome is used for linting and formatting
+- **Configuration**: Uses Biome's default configuration (no biome.json present)
+- **Strict TypeScript**: The `tsconfig.json` enforces strict mode with additional checks:
+  - `noUnusedLocals`: true
+  - `noUnusedParameters`: true
+  - `allowUnreachableCode`: false
+  - `noUncheckedIndexedAccess`: true
+  - `noFallthroughCasesInSwitch`: true
+  - `forceConsistentCasingInFileNames`: true
+
+## Testing Instructions
+
+### Test Structure
+
+Tests are co-located with source code in `src/index.test.ts` using Vitest.
+
+### Test Types
+
+1. **Runtime Tests**: Standard unit tests verifying behavior
+2. **Type Tests**: Using `@ark/attest` to verify TypeScript type inference at runtime
+
+### Key Testing Patterns
+
+```typescript
+// Runtime test
+import { assert, test } from 'vitest'
+test('description', () => {
+  const result = goTry(() => 'value')
+  assert.equal(result[1], 'value')
+})
+
+// Type test
+import { attest } from '@ark/attest'
+test('types are correct', () => {
+  const result = goTry('value')
+  attest<Result<string, string>>(result)
+})
+```
+
+### Running Tests
+
+```bash
+# Run all tests with type checking
+npx vitest run
+
+# Run tests in watch mode (during development)
+npx vitest
+```
+
+### Global Setup
+
+The `setupVitest.ts` file configures `@ark/attest` for type assertions in tests.
+
+## API Design
+
+### Core Functions
+
+- **`goTry<T>(value)`**: Returns `[string | undefined, T | undefined]` - error is the message string
+- **`goTryRaw<T, E>(value)`**: Returns `[E | undefined, T | undefined]` - error is the raw Error object
+
+### Type Helpers
+
+- **`Result<E, T>`**: The tuple type `[E | undefined, T | undefined]`
+- **`Success<T>`**: `[undefined, T]`
+- **`Failure<E>`**: `[E, undefined]`
+- **`isSuccess(result)`**: Type guard to check if result is success
+- **`isFailure(result)`**: Type guard to check if result is failure
+
+### Input Handling
+
+Both functions accept:
+- Direct values
+- Functions (sync or async)
+- Promises
+
+## Dual Package Support
+
+The package supports both CommonJS and ESM consumers:
+
+```json
+{
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.mts",
+  "exports": {
+    "require": { "types": "./dist/index.d.cts", "default": "./dist/index.cjs" },
+    "import": { "types": "./dist/index.d.mts", "default": "./dist/index.mjs" }
+  }
+}
+```
+
+## CI/CD
+
+GitHub Actions workflow (`.github/workflows/main.yml`) runs on every push and PR:
+
+- Tests against Node.js versions: 12, 14, 16, 18
+- Uses `yarn install` and `yarn test`
+- `fail-fast: false` to see results for all Node versions
+
+## Security Considerations
+
+- Zero runtime dependencies - reduces supply chain attack surface
+- Dev dependencies are locked via `package-lock.json`
+- Uses `type: "module"` for native ESM support
+
+## Development Workflow
+
+1. Make changes to `src/index.ts`
+2. Add/update tests in `src/index.test.ts`
+3. Run `npm test` to verify build, lint, and tests pass
+4. The CI will test against multiple Node.js versions on push
+
+## Notes for AI Agents
+
+- Always run `npm test` after making changes to ensure build, lint, and tests pass
+- Type tests with `@ark/attest` are as important as runtime tests
+- The library has zero dependencies - avoid adding any
+- Maintain dual CJS/ESM compatibility when making changes
+- Follow the existing function overload patterns for type inference
+- Error handling should preserve the Go-style tuple return pattern

package/README.md

@@ -202,6 +202,88 @@ if (err === undefined) {
 }
 ```
 
+### Tagged Errors for Discriminated Unions
+
+Create typed errors with a `_tag` property for pattern matching and discriminated unions:
+
+```ts
+import { taggedError, goTryRaw, failure, type Result } from 'go-go-try'
+
+// Define error types
+const DatabaseError = taggedError('DatabaseError')
+const NetworkError = taggedError('NetworkError')
+const ValidationError = taggedError('ValidationError')
+
+// Create a union type
+import type { TaggedUnion } from 'go-go-try'
+
+// Option 1: Using TaggedUnion helper (cleaner)
+const DatabaseError = taggedError('DatabaseError')
+const NetworkError = taggedError('NetworkError')
+const ValidationError = taggedError('ValidationError')
+
+type AppError = TaggedUnion<[typeof DatabaseError, typeof NetworkError, typeof ValidationError]>
+// Equivalent to: DatabaseError | NetworkError | ValidationError
+
+// Option 2: Using InstanceType (standard TypeScript)
+type AppErrorVerbose = 
+  | InstanceType<typeof DatabaseError>
+  | InstanceType<typeof NetworkError>
+  | InstanceType<typeof ValidationError>
+
+// Use in functions with typed error returns
+async function fetchUser(id: string): Promise<Result<AppError, User>> {
+  const [dbErr, user] = await goTryRaw(queryDatabase(id), DatabaseError)
+  if (dbErr) return failure(dbErr)
+  
+  const [netErr, enriched] = await goTryRaw(enrichUserData(user!), NetworkError)
+  if (netErr) return failure(netErr)
+  
+  return [undefined, enriched] as const
+}
+
+// Pattern matching on errors
+const [err, user] = await fetchUser('123')
+if (err) {
+  switch (err._tag) {
+    case 'DatabaseError':
+      console.error('Database failed:', err.message)
+      break
+    case 'NetworkError':
+      console.error('Network issue:', err.message)
+      break
+    case 'ValidationError':
+      console.error('Invalid data:', err.message)
+      break
+  }
+}
+
+// Exhaustive switch with compile-time safety
+function assertNever(value: never): never {
+  throw new Error(`Unhandled case: ${String(value)}`)
+}
+
+function handleError(err: AppError): string {
+  switch (err._tag) {
+    case 'DatabaseError':
+      return `DB: ${err.message}`
+    case 'NetworkError':
+      return `NET: ${err.message}`
+    case 'ValidationError':
+      return `VAL: ${err.message}`
+    default:
+      // TypeScript will error here if any case is missing above
+      return assertNever(err)
+  }
+}
+```
+
+The `taggedError` function creates an error class with:
+- `_tag`: A readonly string literal for discriminated unions
+- `message`: The error message
+- `cause`: Optional cause for error chaining
+- `name`: Set to the tag value
+
 ### Helper Functions
 
 Build custom utilities on top of the primitives:
@@ -236,12 +318,32 @@ Executes a function, promise, or value and returns a Result type with error mess
 function goTry<T>(value: T | Promise<T> | (() => T | Promise<T>)): Result<string, T> | Promise<Result<string, T>>
 ```
 
-### `goTryRaw<T, E>(value)`
+### `goTryRaw<T, E>(value, ErrorClass?)`
 
 Like `goTry` but returns the raw Error object instead of just the message.
 
+Optionally accepts an error constructor to wrap caught errors - useful with `taggedError` for discriminated unions.
+
 ```ts
+// Without ErrorClass - err is Error | undefined
 function goTryRaw<T, E = Error>(value: T | Promise<T> | (() => T | Promise<T>)): Result<E, T> | Promise<Result<E, T>>
+
+// With ErrorClass - err is E | undefined (e.g., DatabaseError | undefined)
+function goTryRaw<T, E>(value: T | Promise<T> | (() => T | Promise<T>), ErrorClass: ErrorConstructor<E>): Result<E, T> | Promise<Result<E, T>>
+```
+
+**Example:**
+```ts
+const DatabaseError = taggedError('DatabaseError')
+
+// Raw error (default)
+const [err1, data1] = await goTryRaw(fetchData())
+// err1 is Error | undefined
+
+// Tagged error
+const [err2, data2] = await goTryRaw(fetchData(), DatabaseError)
+// err2 is DatabaseError | undefined
+// err2._tag is 'DatabaseError' - enables discriminated unions
 ```
 
 ### `goTryAll<T>(items, options?)`
@@ -325,12 +427,120 @@ function success<T>(value: T): Success<T>
 function failure<E>(error: E): Failure<E>
 ```
 
+### `taggedError<T>(tag)`
+
+Creates a tagged error class for discriminated error handling. Returns a class constructor that extends `Error` and includes a readonly `_tag` property.
+
+```ts
+function taggedError<T extends string>(tag: T): TaggedErrorClass<T>
+
+// Returned class interface:
+class TaggedErrorClass<T> extends Error implements TaggedError<T> {
+  readonly _tag: T
+  readonly cause?: unknown
+  constructor(message: string, options?: { cause?: unknown })
+}
+```
+
+**Example:**
+```ts
+const DatabaseError = taggedError('DatabaseError')
+const err = new DatabaseError('connection failed', { cause: originalError })
+
+console.log(err._tag)    // 'DatabaseError'
+console.log(err.message) // 'connection failed'
+console.log(err.name)    // 'DatabaseError'
+console.log(err.cause)   // originalError
+```
+
+### `TaggedInstance<T>`
+
+Extracts the instance type from a tagged error class. Cleaner alternative to `InstanceType<typeof ErrorClass>`.
+
+```ts
+type TaggedInstance<T extends ErrorConstructor<unknown>> = 
+  T extends ErrorConstructor<infer E> ? E : never
+```
+
+**Example:**
+```ts
+const DatabaseError = taggedError('DatabaseError')
+type DbError = TaggedInstance<typeof DatabaseError>
+// Equivalent to: InstanceType<typeof DatabaseError>
+```
+
+### `TaggedUnion<T>`
+
+Creates a union type from multiple tagged error classes.
+
+```ts
+type TaggedUnion<T extends readonly ErrorConstructor<unknown>[]> = 
+  { [K in keyof T]: T[K] extends ErrorConstructor<infer E> ? E : never }[number]
+```
+
+**Example:**
+```ts
+const DatabaseError = taggedError('DatabaseError')
+const NetworkError = taggedError('NetworkError')
+const ValidationError = taggedError('ValidationError')
+
+// Before (verbose):
+type AppErrorVerbose = 
+  | InstanceType<typeof DatabaseError>
+  | InstanceType<typeof NetworkError>
+  | InstanceType<typeof ValidationError>
+
+// After (clean):
+type AppError = TaggedUnion<[typeof DatabaseError, typeof NetworkError, typeof ValidationError]>
+// Results in: DatabaseError | NetworkError | ValidationError
+```
+
+#### Automatic Union Inference
+
+When using `goTryRaw` with different error classes in the same function, TypeScript **automatically infers** the union type without needing explicit type annotations:
+
+```ts
+// No explicit return type needed!
+async function fetchUserData(id: string) {
+  // First operation might fail with DatabaseError
+  const [dbErr, user] = await goTryRaw(queryDb(id), DatabaseError)
+  if (dbErr) return failure(dbErr)  // returns Failure<DatabaseError>
+
+  // Second operation might fail with NetworkError  
+  const [netErr, enriched] = await goTryRaw(enrichUser(user!), NetworkError)
+  if (netErr) return failure(netErr)  // returns Failure<NetworkError>
+
+  return success(enriched)  // returns Success<User>
+}
+
+// TypeScript infers: Promise<Result<DatabaseError | NetworkError, User>>
+// No TaggedUnion or explicit types needed!
+```
+
+The inferred union enables exhaustive pattern matching:
+
+```ts
+const [err, user] = await fetchUserData('123')
+if (err) {
+  switch (err._tag) {
+    case 'DatabaseError': /* handle db error */ break
+    case 'NetworkError': /* handle network error */ break
+    default: assertNever(err) // compile-time safety
+  }
+}
+```
+
 ## Types
 
 ```ts
 type Success<T> = readonly [undefined, T]
 type Failure<E> = readonly [E, undefined]
 type Result<E, T> = Success<T> | Failure<E>
+
+// Error type helpers
+type TaggedInstance<T> = T extends ErrorConstructor<infer E> ? E : never
+type TaggedUnion<T extends readonly ErrorConstructor<unknown>[]> = 
+  { [K in keyof T]: T[K] extends ErrorConstructor<infer E> ? E : never }[number]
 ```
 
 ## License

package/dist/index.cjs

@@ -1,5 +1,15 @@
 'use strict';
 
+function taggedError(tag) {
+  return class TaggedErrorClass extends Error {
+    constructor(message, options) {
+      super(message);
+      this._tag = tag;
+      this.name = tag;
+      this.cause = options?.cause;
+    }
+  };
+}
 function isSuccess(result) {
   return result[0] === void 0;
 }
@@ -118,24 +128,30 @@ function goTry(value) {
     return failure(getErrorMessage(err));
   }
 }
-function goTryRaw(value) {
+function goTryRaw(value, ErrorClass) {
+  const wrapError = (err) => {
+    if (ErrorClass) {
+      if (err === void 0) {
+        return new ErrorClass("undefined");
+      }
+      if (isError(err)) {
+        return new ErrorClass(err.message, { cause: err });
+      }
+      return new ErrorClass(String(err));
+    }
+    if (err === void 0) {
+      return new Error("undefined");
+    }
+    return isError(err) ? err : new Error(String(err));
+  };
   try {
     const result = typeof value === "function" ? value() : value;
     if (isPromise(result)) {
-      return result.then((resolvedValue) => success(resolvedValue)).catch((err) => {
-        if (err === void 0) {
-          return failure(new Error("undefined"));
-        }
-        return failure(
-          isError(err) ? err : new Error(String(err))
-        );
-      });
+      return result.then((resolvedValue) => success(resolvedValue)).catch((err) => failure(wrapError(err)));
     }
     return success(result);
   } catch (err) {
-    return failure(
-      isError(err) ? err : new Error(String(err))
-    );
+    return failure(wrapError(err));
   }
 }
 
@@ -148,3 +164,4 @@ exports.goTryRaw = goTryRaw;
 exports.isFailure = isFailure;
 exports.isSuccess = isSuccess;
 exports.success = success;
+exports.taggedError = taggedError;

package/dist/index.d.cts

@@ -1,6 +1,51 @@
 type Success<T> = readonly [undefined, T];
 type Failure<E> = readonly [E, undefined];
 type Result<E, T> = Success<T> | Failure<E>;
+/**
+ * Base interface for tagged errors.
+ * The `_tag` property enables discriminated union narrowing.
+ */
+interface TaggedError<T extends string> {
+    readonly _tag: T;
+    readonly message: string;
+    readonly cause?: unknown;
+}
+/**
+ * Creates a tagged error class for discriminated error handling.
+ *
+ * @template T The literal type of the tag
+ * @param tag The string tag to identify this error type (e.g., 'DatabaseError')
+ * @returns A class constructor for creating tagged errors
+ *
+ * @example
+ * const DatabaseError = taggedError('DatabaseError')
+ * const NetworkError = taggedError('NetworkError')
+ *
+ * type MyError = InstanceType<typeof DatabaseError> | InstanceType<typeof NetworkError>
+ *
+ * function fetchUser(id: string): Result<MyError, User> {
+ *   const [err, user] = goTryRaw(fetch(`/users/${id}`), DatabaseError)
+ *   if (err) return failure(err)
+ *   // ...
+ * }
+ *
+ * // Pattern matching on errors
+ * if (err._tag === 'DatabaseError') {
+ *   // TypeScript knows this is DatabaseError
+ * }
+ */
+declare function taggedError<T extends string>(tag: T): {
+    new (message: string, options?: {
+        cause?: unknown;
+    }): {
+        readonly _tag: T;
+        readonly cause?: unknown;
+        name: string;
+        message: string;
+        stack?: string;
+    };
+    isError(error: unknown): error is Error;
+};
 type ResultWithDefault<E, T> = readonly [E | undefined, T];
 type MaybePromise<T> = T | Promise<T>;
 interface GoTryAllOptions {
@@ -121,6 +166,41 @@ declare function goTry<T>(fn: () => Promise<T>): Promise<Result<string, T>>;
 declare function goTry<T>(promise: Promise<T>): Promise<Result<string, T>>;
 declare function goTry<T>(fn: () => T): Result<string, T>;
 declare function goTry<T>(value: T): Result<string, T>;
+/**
+ * Type for error constructors that can be used with goTryRaw.
+ */
+type ErrorConstructor<E> = new (message: string, options?: {
+    cause?: unknown;
+}) => E;
+/**
+ * Extracts the instance type from a tagged error class.
+ * Useful for creating cleaner error type definitions.
+ *
+ * @template T The tagged error class type
+ * @returns The instance type of the error class
+ *
+ * @example
+ * const DatabaseError = taggedError('DatabaseError')
+ * type DbError = TaggedInstance<typeof DatabaseError>
+ * // Equivalent to: InstanceType<typeof DatabaseError>
+ */
+type TaggedInstance<T extends ErrorConstructor<unknown>> = T extends ErrorConstructor<infer E> ? E : never;
+/**
+ * Creates a union type from multiple tagged error classes.
+ *
+ * @template T A tuple of tagged error class types
+ * @returns A union of all instance types
+ *
+ * @example
+ * const DatabaseError = taggedError('DatabaseError')
+ * const NetworkError = taggedError('NetworkError')
+ *
+ * type AppError = TaggedUnion<[typeof DatabaseError, typeof NetworkError]>
+ * // Equivalent to: DatabaseError | NetworkError
+ */
+type TaggedUnion<T extends readonly ErrorConstructor<unknown>[]> = {
+    [K in keyof T]: T[K] extends ErrorConstructor<infer E> ? E : never;
+}[number];
 /**
  * Executes a function, promise, or value and returns a Result type.
  * If an error occurs, it returns a Failure with the raw error object.
@@ -128,6 +208,7 @@ declare function goTry<T>(value: T): Result<string, T>;
  * @template T The type of the successful result
  * @template E The type of the error, defaults to Error
  * @param {T | Promise<T> | (() => T | Promise<T>)} value - The value, promise, or function to execute
+ * @param {ErrorConstructor<E>} [ErrorClass] - Optional error constructor to wrap caught errors
  * @returns {Result<E, T> | Promise<Result<E, T>>} A Result type or a Promise of a Result type
  *
  * @example
@@ -141,13 +222,24 @@ declare function goTry<T>(value: T): Result<string, T>;
  * @example
  * // With a promise
  * const [err, result] = await goTryRaw(fetch('https://api.example.com/data'));
+ *
+ * @example
+ * // With tagged error for discriminated unions
+ * const DatabaseError = taggedError('DatabaseError');
+ * const [err, result] = await goTryRaw(fetchData(), DatabaseError);
+ * // err is InstanceType<typeof DatabaseError> | undefined
  */
 declare function goTryRaw<T, E = Error>(fn: () => never): Result<E, never>;
+declare function goTryRaw<T, E = Error>(fn: () => never, ErrorClass: ErrorConstructor<E>): Result<E, never>;
 declare function goTryRaw<T, E = Error>(fn: () => Promise<T>): Promise<Result<E, T>>;
+declare function goTryRaw<T, E = Error>(fn: () => Promise<T>, ErrorClass: ErrorConstructor<E>): Promise<Result<E, T>>;
 declare function goTryRaw<T, E = Error>(promise: Promise<T>): Promise<Result<E, T>>;
+declare function goTryRaw<T, E = Error>(promise: Promise<T>, ErrorClass: ErrorConstructor<E>): Promise<Result<E, T>>;
 declare function goTryRaw<T, E = Error>(fn: () => T): Result<E, T>;
+declare function goTryRaw<T, E = Error>(fn: () => T, ErrorClass: ErrorConstructor<E>): Result<E, T>;
 declare function goTryRaw<T, E = Error>(value: T): Result<E, T>;
+declare function goTryRaw<T, E = Error>(value: T, ErrorClass: ErrorConstructor<E>): Result<E, T>;
 
-export { failure, goTry, goTryAll, goTryAllRaw, goTryOr, goTryRaw, isFailure, isSuccess, success };
-export type { Failure, GoTryAllOptions, MaybePromise, Result, ResultWithDefault, Success };
+export { failure, goTry, goTryAll, goTryAllRaw, goTryOr, goTryRaw, isFailure, isSuccess, success, taggedError };
+export type { ErrorConstructor, Failure, GoTryAllOptions, MaybePromise, Result, ResultWithDefault, Success, TaggedError, TaggedInstance, TaggedUnion };
 //# sourceMappingURL=index.d.cts.map

package/dist/index.d.cts.map

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