@oxog/types 1.0.0 → 1.0.2

package/README.md

@@ -217,6 +217,7 @@ const handler: EventHandler<AppEvents, 'user:login'> = (payload) => {
 - `DeepPartial<T>` - All properties optional
 - `DeepReadonly<T>` - All properties readonly
 - `DeepRequired<T>` - All properties required
+- `DeepMutable<T>` - All properties mutable (removes readonly)
 
 **Function:**
 - `MaybePromise<T>` - Sync or async value
@@ -237,6 +238,17 @@ const handler: EventHandler<AppEvents, 'user:login'> = (payload) => {
 - `NonEmptyArray<T>` - Array with ≥1 element
 - `Nullable<T>` - T | null
 - `Optional<T>` - T | undefined
+- `ValueOf<T>` - Extract value types from object
+- `RequireKeys<T, K>` - Make specific keys required
+- `OptionalKeys<T, K>` - Make specific keys optional
+- `KeysOfType<T, V>` - Extract keys with matching value type
+- `NonNullish<T>` - Exclude null and undefined
+- `Mutable<T>` - Remove readonly from properties
+
+**Array:**
+- `Tuple<T, N>` - Fixed-length tuple type
+- `ArrayElement<T>` - Extract element type from array
+- `LiteralUnion<T, U>` - Literal union with autocomplete
 
 ### Events
 
@@ -298,6 +310,7 @@ npm run example:02-result-type
 ### Testing
 
 - 100% code coverage
+- 229 tests across 7 test files
 - Unit tests for all modules
 - Integration tests
 - Vitest test runner

package/dist/index.cjs

@@ -1,2 +1,2 @@
-'use strict';var l=class{constructor(e){this.value=e;}ok=true;error=void 0;map(e){return E(e(this.value))}mapErr(e){return this}match(e){return e.ok(this.value)}unwrap(){return this.value}unwrapOr(e){return this.value}unwrapOrElse(e){return this.value}},p=class{constructor(e){this.error=e;}ok=false;value=void 0;map(e){return this}mapErr(e){return T(e(this.error))}match(e){return e.err(this.error)}unwrap(){throw new Error(`Cannot unwrap Err: ${String(this.error)}`)}unwrapOr(e){return e}unwrapOrElse(e){return e(this.error)}};function E(r){return new l(r)}function T(r){return new p(r)}var c=(n=>(n.UNKNOWN="UNKNOWN",n.VALIDATION_ERROR="VALIDATION_ERROR",n.PLUGIN_ERROR="PLUGIN_ERROR",n.NOT_FOUND="NOT_FOUND",n.TIMEOUT="TIMEOUT",n.DEPENDENCY_ERROR="DEPENDENCY_ERROR",n))(c||{}),t=class extends Error{constructor(o,u,a){super(o);this.code=u;this.context=a;this.name="OxogError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},s=class extends t{constructor(o,u){super(o,"VALIDATION_ERROR",u);this.context=u;this.name="ValidationError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},i=class extends t{constructor(o,u,a){super(o,"PLUGIN_ERROR",a?{pluginName:u,...a}:void 0);this.pluginName=u;this.name="PluginError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name};function d(r){return r!==null&&typeof r=="object"&&typeof r.name=="string"&&typeof r.version=="string"&&typeof r.install=="function"}function m(r){return r!==null&&typeof r=="object"&&typeof r.use=="function"&&typeof r.unregister=="function"&&typeof r.getPlugin=="function"&&typeof r.listPlugins=="function"&&typeof r.hasPlugin=="function"&&typeof r.emit=="function"&&typeof r.on=="function"&&typeof r.getContext=="function"}function R(r){return r instanceof t}function x(r){return r instanceof s}function k(r){return r instanceof i}function f(r){return r!==null&&typeof r=="object"&&typeof r.ok=="boolean"&&("value"in r||"error"in r)}function U(r){return f(r)&&r.ok===true}function w(r){return f(r)&&r.ok===false}var N=Symbol.for("@oxog/plugin"),P=Symbol.for("@oxog/kernel"),b="1.0.0";exports.Err=T;exports.ErrorCodes=c;exports.OXOG_KERNEL=P;exports.OXOG_PLUGIN=N;exports.OXOG_VERSION=b;exports.Ok=E;exports.OxogError=t;exports.PluginError=i;exports.ValidationError=s;exports.isErr=w;exports.isKernel=m;exports.isOk=U;exports.isOxogError=R;exports.isPlugin=d;exports.isPluginError=k;exports.isResult=f;exports.isValidationError=x;//# sourceMappingURL=index.cjs.map
+'use strict';var i=class{constructor(e){this.value=e;}ok=true;error=void 0;map(e){return E(e(this.value))}mapErr(e){return this}match(e){return e.ok(this.value)}unwrap(){return this.value}unwrapOr(e){return this.value}unwrapOrElse(e){return this.value}},l=class{constructor(e){this.error=e;}ok=false;value=void 0;map(e){return this}mapErr(e){return T(e(this.error))}match(e){return e.err(this.error)}unwrap(){throw new Error(`Cannot unwrap Err: ${String(this.error)}`)}unwrapOr(e){return e}unwrapOrElse(e){return e(this.error)}};function E(r){return new i(r)}function T(r){return new l(r)}var c=(n=>(n.UNKNOWN="UNKNOWN",n.VALIDATION_ERROR="VALIDATION_ERROR",n.PLUGIN_ERROR="PLUGIN_ERROR",n.NOT_FOUND="NOT_FOUND",n.TIMEOUT="TIMEOUT",n.DEPENDENCY_ERROR="DEPENDENCY_ERROR",n))(c||{}),t=class extends Error{constructor(o,u,p){super(o);this.code=u;this.context=p;this.name="OxogError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},s=class extends t{constructor(o,u){super(o,"VALIDATION_ERROR",u);this.context=u;this.name="ValidationError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},a=class extends t{constructor(o,u,p){super(o,"PLUGIN_ERROR",{pluginName:u,...p});this.pluginName=u;this.name="PluginError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name};function m(r){return r!==null&&typeof r=="object"&&typeof r.name=="string"&&typeof r.version=="string"&&typeof r.install=="function"}function R(r){return r!==null&&typeof r=="object"&&typeof r.use=="function"&&typeof r.unregister=="function"&&typeof r.getPlugin=="function"&&typeof r.listPlugins=="function"&&typeof r.hasPlugin=="function"&&typeof r.emit=="function"&&typeof r.on=="function"&&typeof r.getContext=="function"}function d(r){return r instanceof t}function x(r){return r instanceof s}function k(r){return r instanceof a}function f(r){return r!==null&&typeof r=="object"&&typeof r.ok=="boolean"&&("value"in r||"error"in r)}function U(r){return f(r)&&r.ok===true}function w(r){return f(r)&&r.ok===false}var N=Symbol.for("@oxog/plugin"),P=Symbol.for("@oxog/kernel"),b="1.0.2";exports.Err=T;exports.ErrorCodes=c;exports.OXOG_KERNEL=P;exports.OXOG_PLUGIN=N;exports.OXOG_VERSION=b;exports.Ok=E;exports.OxogError=t;exports.PluginError=a;exports.ValidationError=s;exports.isErr=w;exports.isKernel=R;exports.isOk=U;exports.isOxogError=d;exports.isPlugin=m;exports.isPluginError=k;exports.isResult=f;exports.isValidationError=x;//# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/result.ts","../src/errors.ts","../src/guards.ts","../src/constants.ts"],"names":["OkImpl","value","fn","Ok","_fn","handlers","_defaultValue","ErrImpl","error","Err","defaultValue","ErrorCodes","OxogError","message","code","context","ValidationError","PluginError","pluginName","isPlugin","isKernel","isOxogError","isValidationError","isPluginError","isResult","isOk","isErr","OXOG_PLUGIN","OXOG_KERNEL","OXOG_VERSION"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @oxog/types - Result type for functional error handling\n * @version 1.0.0\n * @author Ersin Koç\n */\n\n/**\n * Represents a successful result.\n *\n * Contains a value and provides methods for transforming the value\n * or handling errors. Only available on successful results.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // 42\n * }\n * ```\n */\nexport interface Ok<T> {\n  readonly ok: true;\n  readonly value: T;\n  readonly error?: never;\n\n  /** Transform the value if successful */\n  map<U>(fn: (value: T) => U): Result<U, never>;\n\n  /** Transform the error (no-op for Ok) */\n  mapErr<F>(fn: (error: never) => F): Ok<T>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U;\n\n  /** Unwrap the value (asserts success) */\n  unwrap(): T;\n\n  /** Unwrap with default value */\n  unwrapOr(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse(fn: () => T): T;\n}\n\n/**\n * Represents a failed result.\n *\n * Contains an error and provides methods for transforming the error\n * or handling success cases. Only available on failed results.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * if (isErr(err)) {\n *   console.log(err.error); // 'Something went wrong'\n * }\n * ```\n */\nexport interface Err<E> {\n  readonly ok: false;\n  readonly value?: never;\n  readonly error: E;\n\n  /** Transform the value (no-op for Err) */\n  map<U>(fn: (value: never) => U): Err<E>;\n\n  /** Transform the error if failed */\n  mapErr<F>(fn: (error: E) => F): Result<never, F>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U;\n\n  /** Unwrap the value (asserts success, throws for Err) */\n  unwrap(): never;\n\n  /** Unwrap with default value */\n  unwrapOr<T>(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse<T>(fn: () => T): T;\n}\n\n/**\n * Result type - either Ok<T> or Err<E>.\n *\n * A type that represents either success (Ok) or failure (Err).\n * This is inspired by Rust's Result type and provides functional\n * error handling without exceptions.\n *\n * @example\n * ```typescript\n * function divide(a: number, b: number): Result<number, string> {\n *   if (b === 0) {\n *     return Err('Division by zero');\n *   }\n *   return Ok(a / b);\n * }\n *\n * const result = divide(10, 2);\n *\n * // Pattern matching\n * const message = result.match({\n *   ok: (value) => `Result: ${value}`,\n *   err: (error) => `Error: ${error}`\n * });\n *\n * // Chaining\n * const doubled = result\n *   .map(x => x * 2)\n *   .mapErr(e => `Calculation failed: ${e}`);\n * ```\n */\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/**\n * Internal implementation of Ok result.\n */\nclass OkImpl<T> implements Ok<T> {\n  readonly ok = true as const;\n  readonly error = undefined as never;\n\n  constructor(public readonly value: T) {}\n\n  map<U>(fn: (value: T) => U): Result<U, never> {\n    return Ok(fn(this.value));\n  }\n\n  mapErr<F>(_fn: (error: never) => F): Ok<T> {\n    return this;\n  }\n\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U {\n    return handlers.ok(this.value);\n  }\n\n  unwrap(): T {\n    return this.value;\n  }\n\n  unwrapOr(_defaultValue: T): T {\n    return this.value;\n  }\n\n  unwrapOrElse(_fn: () => T): T {\n    return this.value;\n  }\n}\n\n/**\n * Internal implementation of Err result.\n */\nclass ErrImpl<E> implements Err<E> {\n  readonly ok = false as const;\n  readonly value = undefined as never;\n\n  constructor(public readonly error: E) {}\n\n  map<U>(_fn: (value: never) => U): Err<E> {\n    return this;\n  }\n\n  mapErr<F>(fn: (error: E) => F): Result<never, F> {\n    return Err(fn(this.error));\n  }\n\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U {\n    return handlers.err(this.error);\n  }\n\n  unwrap(): never {\n    throw new Error(`Cannot unwrap Err: ${String(this.error)}`);\n  }\n\n  unwrapOr<T>(defaultValue: T): T {\n    return defaultValue;\n  }\n\n  unwrapOrElse<T>(fn: (error: E) => T): T {\n    return fn(this.error);\n  }\n}\n\n/**\n * Creates a successful Result containing a value.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * const okStr = Ok('hello');\n * const okObj = Ok({ id: 1 });\n * ```\n *\n * @param value - The value to wrap\n * @returns An Ok result containing the value\n */\nexport function Ok<T>(value: T): Ok<T> {\n  return new OkImpl(value);\n}\n\n/**\n * Creates a failed Result containing an error.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * const errNum = Err(404);\n * const errObj = Err({ code: 'NOT_FOUND' });\n * ```\n *\n * @param error - The error to wrap\n * @returns An Err result containing the error\n */\nexport function Err<E>(error: E): Err<E> {\n  return new ErrImpl(error);\n}\n","/**\n * @oxog/types - Standardized error classes\n * @version 1.0.0\n * @author Ersin Koç\n */\n\n/**\n * Standard error codes for @oxog ecosystem.\n *\n * These codes provide programmatic ways to identify and handle errors.\n */\nexport enum ErrorCodes {\n  /** Unknown error */\n  UNKNOWN = 'UNKNOWN',\n\n  /** Validation error */\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n\n  /** Plugin-related error */\n  PLUGIN_ERROR = 'PLUGIN_ERROR',\n\n  /** Resource not found */\n  NOT_FOUND = 'NOT_FOUND',\n\n  /** Operation timed out */\n  TIMEOUT = 'TIMEOUT',\n\n  /** Dependency error */\n  DEPENDENCY_ERROR = 'DEPENDENCY_ERROR',\n}\n\n/**\n * Base error class for all @oxog errors.\n *\n * Provides structured error information with code, message, and context.\n * All other @oxog errors inherit from this class.\n *\n * @example\n * ```typescript\n * throw new OxogError(\n *   'Database connection failed',\n *   ErrorCodes.DEPENDENCY_ERROR,\n *   { host: 'localhost', port: 5432 }\n * );\n * ```\n */\nexport class OxogError extends Error {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new OxogError.\n   *\n   * @param message - Human-readable error message\n   * @param code - Error code for programmatic handling\n   * @param context - Additional context about the error\n   */\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'OxogError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when validation fails.\n *\n * Used for input validation, schema validation, and type checking errors.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\n *   'Invalid email format',\n *   { field: 'email', value: 'not-an-email' }\n * );\n * ```\n */\nexport class ValidationError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new ValidationError.\n   *\n   * @param message - Human-readable error message\n   * @param context - Additional context about the validation failure\n   */\n  constructor(\n    message: string,\n    public override readonly context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.VALIDATION_ERROR, context);\n    this.name = 'ValidationError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when a plugin operation fails.\n *\n * Used for plugin initialization, dependency resolution, and runtime errors\n * specific to plugins.\n *\n * @example\n * ```typescript\n * throw new PluginError(\n *   'Failed to initialize cache plugin',\n *   'cache-plugin',\n *   { reason: 'Redis connection failed' }\n * );\n * ```\n */\nexport class PluginError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new PluginError.\n   *\n   * @param message - Human-readable error message\n   * @param pluginName - Name of the plugin that caused the error\n   * @param context - Additional context about the plugin error\n   */\n  constructor(\n    message: string,\n    public readonly pluginName: string,\n    context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.PLUGIN_ERROR, context ? { pluginName, ...context } : undefined);\n    this.name = 'PluginError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n","/**\n * @oxog/types - Type guard functions\n * @version 1.0.0\n * @author Ersin Koç\n */\n\nimport type { Plugin, Kernel } from './plugin.js';\nimport type { Result, Ok, Err } from './result.js';\nimport { OxogError, ValidationError, PluginError } from './errors.js';\n\n/**\n * Type guard for Plugin.\n *\n * Checks if a value is a valid Plugin instance.\n *\n * @example\n * ```typescript\n * const plugin = { name: 'test', version: '1.0.0', install: () => {} };\n * if (isPlugin(plugin)) {\n *   console.log(plugin.name); // TypeScript knows it's a Plugin\n * }\n * ```\n */\nexport function isPlugin<T>(value: unknown): value is Plugin<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Plugin<T>).name === 'string' &&\n    typeof (value as Plugin<T>).version === 'string' &&\n    typeof (value as Plugin<T>).install === 'function'\n  );\n}\n\n/**\n * Type guard for Kernel.\n *\n * Checks if a value is a valid Kernel instance.\n *\n * @example\n * ```typescript\n * const kernel = {\n *   use: (plugin) => kernel,\n *   unregister: () => true,\n *   getPlugin: () => undefined,\n *   listPlugins: () => [],\n *   hasPlugin: () => false,\n *   emit: () => {},\n *   on: () => () => {},\n *   getContext: () => null\n * };\n * if (isKernel(kernel)) {\n *   console.log(kernel.listPlugins()); // TypeScript knows it's a Kernel\n * }\n * ```\n */\nexport function isKernel<T>(value: unknown): value is Kernel<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Kernel<T>).use === 'function' &&\n    typeof (value as Kernel<T>).unregister === 'function' &&\n    typeof (value as Kernel<T>).getPlugin === 'function' &&\n    typeof (value as Kernel<T>).listPlugins === 'function' &&\n    typeof (value as Kernel<T>).hasPlugin === 'function' &&\n    typeof (value as Kernel<T>).emit === 'function' &&\n    typeof (value as Kernel<T>).on === 'function' &&\n    typeof (value as Kernel<T>).getContext === 'function'\n  );\n}\n\n/**\n * Type guard for OxogError.\n *\n * Checks if a value is an OxogError instance.\n *\n * @example\n * ```typescript\n * const error = new OxogError('Test', 'TEST');\n * if (isOxogError(error)) {\n *   console.log(error.code); // TypeScript knows it's an OxogError\n * }\n * ```\n */\nexport function isOxogError(value: unknown): value is OxogError {\n  return value instanceof OxogError;\n}\n\n/**\n * Type guard for ValidationError.\n *\n * Checks if a value is a ValidationError instance.\n *\n * @example\n * ```typescript\n * const error = new ValidationError('Invalid', { field: 'test' });\n * if (isValidationError(error)) {\n *   console.log(error.context); // TypeScript knows it's a ValidationError\n * }\n * ```\n */\nexport function isValidationError(value: unknown): value is ValidationError {\n  return value instanceof ValidationError;\n}\n\n/**\n * Type guard for PluginError.\n *\n * Checks if a value is a PluginError instance.\n *\n * @example\n * ```typescript\n * const error = new PluginError('Plugin failed', 'my-plugin');\n * if (isPluginError(error)) {\n *   console.log(error.pluginName); // TypeScript knows it's a PluginError\n * }\n * ```\n */\nexport function isPluginError(value: unknown): value is PluginError {\n  return value instanceof PluginError;\n}\n\n/**\n * Type guard for Result.\n *\n * Checks if a value is a Result instance (either Ok or Err).\n *\n * @example\n * ```typescript\n * const result = Ok(42);\n * if (isResult(result)) {\n *   // result is Ok<number, unknown>\n * }\n *\n * const err = Err('error');\n * if (isResult(err)) {\n *   // err is Err<unknown, string>\n * }\n * ```\n */\nexport function isResult<T, E>(value: unknown): value is Result<T, E> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Result<T, E>).ok === 'boolean' &&\n    (('value' in (value as object)) || ('error' in (value as object)))\n  );\n}\n\n/**\n * Type guard for Ok result.\n *\n * Checks if a Result is an Ok (success) instance.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // TypeScript knows it's Ok\n * }\n * ```\n */\nexport function isOk<T>(value: Result<T, unknown>): value is Ok<T> {\n  return isResult(value) && value.ok === true;\n}\n\n/**\n * Type guard for Err result.\n *\n * Checks if a Result is an Err (failure) instance.\n *\n * @example\n * ```typescript\n * const err = Err('error');\n * if (isErr(err)) {\n *   console.log(err.error); // TypeScript knows it's Err\n * }\n * ```\n */\nexport function isErr<E>(value: Result<unknown, E>): value is Err<E> {\n  return isResult(value) && value.ok === false;\n}\n","/**\n * @oxog/types - Well-known symbols and constants\n * @version 1.0.0\n * @author Ersin Koç\n */\n\nimport { ErrorCodes } from './errors.js';\n\n/**\n * Well-known symbol for @oxog plugins.\n *\n * Use this symbol to mark objects as @oxog plugins.\n * This enables runtime detection and validation.\n *\n * @example\n * ```typescript\n * const myPlugin = {\n *   [OXOG_PLUGIN]: true,\n *   name: 'my-plugin',\n *   version: '1.0.0',\n *   install: () => {}\n * };\n * ```\n */\nexport const OXOG_PLUGIN = Symbol.for('@oxog/plugin');\n\n/**\n * Well-known symbol for @oxog kernels.\n *\n * Use this symbol to mark objects as @oxog kernels.\n * This enables runtime detection and validation.\n *\n * @example\n * ```typescript\n * const myKernel = {\n *   [OXOG_KERNEL]: true,\n *   use: (plugin) => kernel,\n *   // ... other methods\n * };\n * ```\n */\nexport const OXOG_KERNEL = Symbol.for('@oxog/kernel');\n\n/**\n * @oxog/types package version.\n *\n * Current version of the @oxog/types package.\n *\n * @example\n * ```typescript\n * console.log(`Using @oxog/types v${OXOG_VERSION}`);\n * ```\n */\nexport const OXOG_VERSION = '1.0.0';\n\n/**\n * Standard error codes for @oxog ecosystem.\n *\n * Re-exported from errors module for convenience.\n *\n * @example\n * ```typescript\n * throw new OxogError('Not found', ErrorCodes.NOT_FOUND);\n * ```\n */\nexport { ErrorCodes };\n"]}
+{"version":3,"sources":["../src/result.ts","../src/errors.ts","../src/guards.ts","../src/constants.ts"],"names":["OkImpl","value","fn","Ok","_fn","handlers","_defaultValue","ErrImpl","error","Err","defaultValue","ErrorCodes","OxogError","message","code","context","ValidationError","PluginError","pluginName","isPlugin","isKernel","isOxogError","isValidationError","isPluginError","isResult","isOk","isErr","OXOG_PLUGIN","OXOG_KERNEL","OXOG_VERSION"],"mappings":"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","file":"index.cjs","sourcesContent":["/**\n * @oxog/types - Result type for functional error handling\n * @version 1.0.2\n * @author Ersin Koç\n */\n\n/**\n * Represents a successful result.\n *\n * Contains a value and provides methods for transforming the value\n * or handling errors. Only available on successful results.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // 42\n * }\n * ```\n */\nexport interface Ok<T> {\n  readonly ok: true;\n  readonly value: T;\n  readonly error?: never;\n\n  /** Transform the value if successful */\n  map<U>(fn: (value: T) => U): Result<U, never>;\n\n  /** Transform the error (no-op for Ok) */\n  mapErr<F>(fn: (error: never) => F): Ok<T>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U;\n\n  /** Unwrap the value (asserts success) */\n  unwrap(): T;\n\n  /** Unwrap with default value */\n  unwrapOr(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse(fn: () => T): T;\n}\n\n/**\n * Represents a failed result.\n *\n * Contains an error and provides methods for transforming the error\n * or handling success cases. Only available on failed results.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * if (isErr(err)) {\n *   console.log(err.error); // 'Something went wrong'\n * }\n * ```\n */\nexport interface Err<E> {\n  readonly ok: false;\n  readonly value?: never;\n  readonly error: E;\n\n  /** Transform the value (no-op for Err) */\n  map<U>(fn: (value: never) => U): Err<E>;\n\n  /** Transform the error if failed */\n  mapErr<F>(fn: (error: E) => F): Result<never, F>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U;\n\n  /** Unwrap the value (asserts success, throws for Err) */\n  unwrap(): never;\n\n  /** Unwrap with default value */\n  unwrapOr<T>(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse<T>(fn: () => T): T;\n}\n\n/**\n * Result type - either Ok<T> or Err<E>.\n *\n * A type that represents either success (Ok) or failure (Err).\n * This is inspired by Rust's Result type and provides functional\n * error handling without exceptions.\n *\n * @example\n * ```typescript\n * function divide(a: number, b: number): Result<number, string> {\n *   if (b === 0) {\n *     return Err('Division by zero');\n *   }\n *   return Ok(a / b);\n * }\n *\n * const result = divide(10, 2);\n *\n * // Pattern matching\n * const message = result.match({\n *   ok: (value) => `Result: ${value}`,\n *   err: (error) => `Error: ${error}`\n * });\n *\n * // Chaining\n * const doubled = result\n *   .map(x => x * 2)\n *   .mapErr(e => `Calculation failed: ${e}`);\n * ```\n */\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/**\n * Internal implementation of Ok result.\n */\nclass OkImpl<T> implements Ok<T> {\n  readonly ok = true as const;\n  readonly error = undefined as never;\n\n  constructor(public readonly value: T) {}\n\n  map<U>(fn: (value: T) => U): Result<U, never> {\n    return Ok(fn(this.value));\n  }\n\n  mapErr<F>(_fn: (error: never) => F): Ok<T> {\n    return this;\n  }\n\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U {\n    return handlers.ok(this.value);\n  }\n\n  unwrap(): T {\n    return this.value;\n  }\n\n  unwrapOr(_defaultValue: T): T {\n    return this.value;\n  }\n\n  unwrapOrElse(_fn: () => T): T {\n    return this.value;\n  }\n}\n\n/**\n * Internal implementation of Err result.\n */\nclass ErrImpl<E> implements Err<E> {\n  readonly ok = false as const;\n  readonly value = undefined as never;\n\n  constructor(public readonly error: E) {}\n\n  map<U>(_fn: (value: never) => U): Err<E> {\n    return this;\n  }\n\n  mapErr<F>(fn: (error: E) => F): Result<never, F> {\n    return Err(fn(this.error));\n  }\n\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U {\n    return handlers.err(this.error);\n  }\n\n  unwrap(): never {\n    throw new Error(`Cannot unwrap Err: ${String(this.error)}`);\n  }\n\n  unwrapOr<T>(defaultValue: T): T {\n    return defaultValue;\n  }\n\n  unwrapOrElse<T>(fn: (error: E) => T): T {\n    return fn(this.error);\n  }\n}\n\n/**\n * Creates a successful Result containing a value.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * const okStr = Ok('hello');\n * const okObj = Ok({ id: 1 });\n * ```\n *\n * @param value - The value to wrap\n * @returns An Ok result containing the value\n */\nexport function Ok<T>(value: T): Ok<T> {\n  return new OkImpl(value);\n}\n\n/**\n * Creates a failed Result containing an error.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * const errNum = Err(404);\n * const errObj = Err({ code: 'NOT_FOUND' });\n * ```\n *\n * @param error - The error to wrap\n * @returns An Err result containing the error\n */\nexport function Err<E>(error: E): Err<E> {\n  return new ErrImpl(error);\n}\n","/**\n * @oxog/types - Standardized error classes\n * @version 1.0.2\n * @author Ersin Koç\n */\n\n/**\n * Standard error codes for @oxog ecosystem.\n *\n * These codes provide programmatic ways to identify and handle errors.\n */\nexport enum ErrorCodes {\n  /** Unknown error */\n  UNKNOWN = 'UNKNOWN',\n\n  /** Validation error */\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n\n  /** Plugin-related error */\n  PLUGIN_ERROR = 'PLUGIN_ERROR',\n\n  /** Resource not found */\n  NOT_FOUND = 'NOT_FOUND',\n\n  /** Operation timed out */\n  TIMEOUT = 'TIMEOUT',\n\n  /** Dependency error */\n  DEPENDENCY_ERROR = 'DEPENDENCY_ERROR',\n}\n\n/**\n * Base error class for all @oxog errors.\n *\n * Provides structured error information with code, message, and context.\n * All other @oxog errors inherit from this class.\n *\n * @example\n * ```typescript\n * throw new OxogError(\n *   'Database connection failed',\n *   ErrorCodes.DEPENDENCY_ERROR,\n *   { host: 'localhost', port: 5432 }\n * );\n * ```\n */\nexport class OxogError extends Error {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new OxogError.\n   *\n   * @param message - Human-readable error message\n   * @param code - Error code for programmatic handling\n   * @param context - Additional context about the error\n   */\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'OxogError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when validation fails.\n *\n * Used for input validation, schema validation, and type checking errors.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\n *   'Invalid email format',\n *   { field: 'email', value: 'not-an-email' }\n * );\n * ```\n */\nexport class ValidationError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new ValidationError.\n   *\n   * @param message - Human-readable error message\n   * @param context - Additional context about the validation failure\n   */\n  constructor(\n    message: string,\n    public override readonly context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.VALIDATION_ERROR, context);\n    this.name = 'ValidationError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when a plugin operation fails.\n *\n * Used for plugin initialization, dependency resolution, and runtime errors\n * specific to plugins.\n *\n * @example\n * ```typescript\n * throw new PluginError(\n *   'Failed to initialize cache plugin',\n *   'cache-plugin',\n *   { reason: 'Redis connection failed' }\n * );\n * ```\n */\nexport class PluginError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new PluginError.\n   *\n   * @param message - Human-readable error message\n   * @param pluginName - Name of the plugin that caused the error\n   * @param context - Additional context about the plugin error\n   */\n  constructor(\n    message: string,\n    public readonly pluginName: string,\n    context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.PLUGIN_ERROR, { pluginName, ...context });\n    this.name = 'PluginError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n","/**\n * @oxog/types - Type guard functions\n * @version 1.0.2\n * @author Ersin Koç\n */\n\nimport type { Plugin, Kernel } from './plugin.js';\nimport type { Result, Ok, Err } from './result.js';\nimport { OxogError, ValidationError, PluginError } from './errors.js';\n\n/**\n * Type guard for Plugin.\n *\n * Checks if a value is a valid Plugin instance.\n *\n * @example\n * ```typescript\n * const plugin = { name: 'test', version: '1.0.0', install: () => {} };\n * if (isPlugin(plugin)) {\n *   console.log(plugin.name); // TypeScript knows it's a Plugin\n * }\n * ```\n */\nexport function isPlugin<T>(value: unknown): value is Plugin<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Plugin<T>).name === 'string' &&\n    typeof (value as Plugin<T>).version === 'string' &&\n    typeof (value as Plugin<T>).install === 'function'\n  );\n}\n\n/**\n * Type guard for Kernel.\n *\n * Checks if a value is a valid Kernel instance.\n *\n * @example\n * ```typescript\n * const kernel = {\n *   use: (plugin) => kernel,\n *   unregister: () => true,\n *   getPlugin: () => undefined,\n *   listPlugins: () => [],\n *   hasPlugin: () => false,\n *   emit: () => {},\n *   on: () => () => {},\n *   getContext: () => null\n * };\n * if (isKernel(kernel)) {\n *   console.log(kernel.listPlugins()); // TypeScript knows it's a Kernel\n * }\n * ```\n */\nexport function isKernel<T>(value: unknown): value is Kernel<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Kernel<T>).use === 'function' &&\n    typeof (value as Kernel<T>).unregister === 'function' &&\n    typeof (value as Kernel<T>).getPlugin === 'function' &&\n    typeof (value as Kernel<T>).listPlugins === 'function' &&\n    typeof (value as Kernel<T>).hasPlugin === 'function' &&\n    typeof (value as Kernel<T>).emit === 'function' &&\n    typeof (value as Kernel<T>).on === 'function' &&\n    typeof (value as Kernel<T>).getContext === 'function'\n  );\n}\n\n/**\n * Type guard for OxogError.\n *\n * Checks if a value is an OxogError instance.\n *\n * @example\n * ```typescript\n * const error = new OxogError('Test', 'TEST');\n * if (isOxogError(error)) {\n *   console.log(error.code); // TypeScript knows it's an OxogError\n * }\n * ```\n */\nexport function isOxogError(value: unknown): value is OxogError {\n  return value instanceof OxogError;\n}\n\n/**\n * Type guard for ValidationError.\n *\n * Checks if a value is a ValidationError instance.\n *\n * @example\n * ```typescript\n * const error = new ValidationError('Invalid', { field: 'test' });\n * if (isValidationError(error)) {\n *   console.log(error.context); // TypeScript knows it's a ValidationError\n * }\n * ```\n */\nexport function isValidationError(value: unknown): value is ValidationError {\n  return value instanceof ValidationError;\n}\n\n/**\n * Type guard for PluginError.\n *\n * Checks if a value is a PluginError instance.\n *\n * @example\n * ```typescript\n * const error = new PluginError('Plugin failed', 'my-plugin');\n * if (isPluginError(error)) {\n *   console.log(error.pluginName); // TypeScript knows it's a PluginError\n * }\n * ```\n */\nexport function isPluginError(value: unknown): value is PluginError {\n  return value instanceof PluginError;\n}\n\n/**\n * Type guard for Result.\n *\n * Checks if a value is a Result instance (either Ok or Err).\n *\n * @example\n * ```typescript\n * const result = Ok(42);\n * if (isResult(result)) {\n *   // result is Ok<number, unknown>\n * }\n *\n * const err = Err('error');\n * if (isResult(err)) {\n *   // err is Err<unknown, string>\n * }\n * ```\n */\nexport function isResult<T, E>(value: unknown): value is Result<T, E> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Result<T, E>).ok === 'boolean' &&\n    (('value' in (value as object)) || ('error' in (value as object)))\n  );\n}\n\n/**\n * Type guard for Ok result.\n *\n * Checks if a Result is an Ok (success) instance.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // TypeScript knows it's Ok\n * }\n * ```\n */\nexport function isOk<T>(value: Result<T, unknown>): value is Ok<T> {\n  return isResult(value) && value.ok === true;\n}\n\n/**\n * Type guard for Err result.\n *\n * Checks if a Result is an Err (failure) instance.\n *\n * @example\n * ```typescript\n * const err = Err('error');\n * if (isErr(err)) {\n *   console.log(err.error); // TypeScript knows it's Err\n * }\n * ```\n */\nexport function isErr<E>(value: Result<unknown, E>): value is Err<E> {\n  return isResult(value) && value.ok === false;\n}\n","/**\r\n * @oxog/types - Well-known symbols and constants\r\n * @version 1.0.2\r\n * @author Ersin Koç\r\n */\r\n\r\nimport { ErrorCodes } from './errors.js';\r\n\r\n/**\r\n * Well-known symbol for @oxog plugins.\r\n *\r\n * Use this symbol to mark objects as @oxog plugins.\r\n * This enables runtime detection and validation.\r\n *\r\n * @example\r\n * ```typescript\r\n * const myPlugin = {\r\n *   [OXOG_PLUGIN]: true,\r\n *   name: 'my-plugin',\r\n *   version: '1.0.0',\r\n *   install: () => {}\r\n * };\r\n * ```\r\n */\r\nexport const OXOG_PLUGIN = Symbol.for('@oxog/plugin');\r\n\r\n/**\r\n * Well-known symbol for @oxog kernels.\r\n *\r\n * Use this symbol to mark objects as @oxog kernels.\r\n * This enables runtime detection and validation.\r\n *\r\n * @example\r\n * ```typescript\r\n * const myKernel = {\r\n *   [OXOG_KERNEL]: true,\r\n *   use: (plugin) => kernel,\r\n *   // ... other methods\r\n * };\r\n * ```\r\n */\r\nexport const OXOG_KERNEL = Symbol.for('@oxog/kernel');\r\n\r\n/**\r\n * @oxog/types package version.\r\n *\r\n * Current version of the @oxog/types package.\r\n *\r\n * @example\r\n * ```typescript\r\n * console.log(`Using @oxog/types v${OXOG_VERSION}`);\r\n * ```\r\n */\r\nexport const OXOG_VERSION = '1.0.2';\r\n\r\n/**\r\n * Standard error codes for @oxog ecosystem.\r\n *\r\n * Re-exported from errors module for convenience.\r\n *\r\n * @example\r\n * ```typescript\r\n * throw new OxogError('Not found', ErrorCodes.NOT_FOUND);\r\n * ```\r\n */\r\nexport { ErrorCodes };\r\n"]}

package/dist/index.d.cts

@@ -1,6 +1,6 @@
 /**
  * @oxog/types - Common TypeScript utility types
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 /** Brand symbol for branded types */
@@ -294,10 +294,150 @@ type Optional<T> = T | undefined;
  * ```
  */
 type Unsubscribe = () => void;
+/**
+ * Extract the value types from an object type.
+ *
+ * @example
+ * ```typescript
+ * const colors = { red: '#ff0000', green: '#00ff00' } as const;
+ * type ColorValue = ValueOf<typeof colors>; // '#ff0000' | '#00ff00'
+ * ```
+ */
+type ValueOf<T> = T[keyof T];
+/**
+ * Make specified keys required while keeping others optional.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id?: string;
+ *   name?: string;
+ *   email?: string;
+ * }
+ *
+ * type UserWithId = RequireKeys<User, 'id'>;
+ * // { id: string; name?: string; email?: string }
+ * ```
+ */
+type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * Make specified keys optional while keeping others required.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: string;
+ *   name: string;
+ *   email: string;
+ * }
+ *
+ * type UserDraft = OptionalKeys<User, 'id'>;
+ * // { id?: string; name: string; email: string }
+ * ```
+ */
+type OptionalKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Extract keys of T that have values assignable to V.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number;
+ *   name: string;
+ *   email: string;
+ *   age: number;
+ * }
+ *
+ * type StringKeys = KeysOfType<User, string>; // 'name' | 'email'
+ * ```
+ */
+type KeysOfType<T, V> = {
+    [K in keyof T]: T[K] extends V ? K : never;
+}[keyof T];
+/**
+ * Type that excludes null and undefined from T.
+ *
+ * @example
+ * ```typescript
+ * type MaybeString = string | null | undefined;
+ * type DefinitelyString = NonNullish<MaybeString>; // string
+ * ```
+ */
+type NonNullish<T> = Exclude<T, null | undefined>;
+/**
+ * Makes all properties of T mutable (removes readonly).
+ *
+ * @example
+ * ```typescript
+ * interface ReadonlyUser {
+ *   readonly id: string;
+ *   readonly name: string;
+ * }
+ *
+ * type MutableUser = Mutable<ReadonlyUser>;
+ * // { id: string; name: string }
+ * ```
+ */
+type Mutable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+/**
+ * Deep mutable - removes readonly from all nested properties.
+ *
+ * @example
+ * ```typescript
+ * interface ReadonlyConfig {
+ *   readonly api: {
+ *     readonly url: string;
+ *   };
+ * }
+ *
+ * type MutableConfig = DeepMutable<ReadonlyConfig>;
+ * // { api: { url: string } }
+ * ```
+ */
+type DeepMutable<T> = T extends object ? {
+    -readonly [P in keyof T]: DeepMutable<T[P]>;
+} : T;
+/**
+ * Tuple type with exact length.
+ *
+ * @example
+ * ```typescript
+ * type Point2D = Tuple<number, 2>; // [number, number]
+ * type RGB = Tuple<number, 3>; // [number, number, number]
+ * ```
+ */
+type Tuple<T, N extends number, R extends T[] = []> = R['length'] extends N ? R : Tuple<T, N, [T, ...R]>;
+/**
+ * Get the element type of an array.
+ *
+ * @example
+ * ```typescript
+ * type Numbers = number[];
+ * type Num = ArrayElement<Numbers>; // number
+ *
+ * const tuple = ['a', 1, true] as const;
+ * type TupleElement = ArrayElement<typeof tuple>; // 'a' | 1 | true
+ * ```
+ */
+type ArrayElement<T extends readonly unknown[]> = T[number];
+/**
+ * Literal union type helper for better autocomplete.
+ *
+ * @example
+ * ```typescript
+ * type Color = LiteralUnion<'red' | 'green' | 'blue', string>;
+ * // Allows 'red', 'green', 'blue' with autocomplete, but accepts any string
+ * ```
+ */
+type LiteralUnion<T extends U, U = string> = T | (U & {
+    _brand?: never;
+});
 
 /**
  * @oxog/types - Plugin and Kernel interfaces
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -468,7 +608,7 @@ interface PluginLogger {
 type Result<T, E> = Ok<T> | Err<E>;
 /**
  * @oxog/types - Result type for functional error handling
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 /**
@@ -570,7 +710,7 @@ declare function Err<E>(error: E): Err<E>;
 
 /**
  * @oxog/types - Standardized error classes
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 /**
@@ -677,7 +817,7 @@ declare class PluginError extends OxogError {
 
 /**
  * @oxog/types - Type guard functions
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -810,7 +950,7 @@ declare function isErr<E>(value: Result<unknown, E>): value is Err<E>;
 
 /**
  * @oxog/types - Event system types
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -893,7 +1033,7 @@ interface TypedEventEmitter<TEvents extends EventMap> {
 
 /**
  * @oxog/types - Well-known symbols and constants
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -940,6 +1080,6 @@ declare const OXOG_KERNEL: unique symbol;
  * console.log(`Using @oxog/types v${OXOG_VERSION}`);
  * ```
  */
-declare const OXOG_VERSION = "1.0.0";
+declare const OXOG_VERSION = "1.0.2";
 
-export { type AnyFunction, type AsyncFunction, type Brand, type Branded, type DeepPartial, type DeepReadonly, type DeepRequired, Err, ErrorCodes, type EventHandler, type EventMap, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type Kernel, type MaybePromise, type NonEmptyArray, type Nullable, OXOG_KERNEL, OXOG_PLUGIN, OXOG_VERSION, Ok, type Optional, OxogError, type Plugin, PluginError, type PluginLogger, type PluginOptions, type Prettify, type Result, type StrictOmit, type StrictPick, type SyncFunction, type TypedEventEmitter, type Unsubscribe, ValidationError, isErr, isKernel, isOk, isOxogError, isPlugin, isPluginError, isResult, isValidationError };
+export { type AnyFunction, type ArrayElement, type AsyncFunction, type Brand, type Branded, type DeepMutable, type DeepPartial, type DeepReadonly, type DeepRequired, Err, ErrorCodes, type EventHandler, type EventMap, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type Kernel, type KeysOfType, type LiteralUnion, type MaybePromise, type Mutable, type NonEmptyArray, type NonNullish, type Nullable, OXOG_KERNEL, OXOG_PLUGIN, OXOG_VERSION, Ok, type Optional, type OptionalKeys, OxogError, type Plugin, PluginError, type PluginLogger, type PluginOptions, type Prettify, type RequireKeys, type Result, type StrictOmit, type StrictPick, type SyncFunction, type Tuple, type TypedEventEmitter, type Unsubscribe, ValidationError, type ValueOf, isErr, isKernel, isOk, isOxogError, isPlugin, isPluginError, isResult, isValidationError };

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 /**
  * @oxog/types - Common TypeScript utility types
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 /** Brand symbol for branded types */
@@ -294,10 +294,150 @@ type Optional<T> = T | undefined;
  * ```
  */
 type Unsubscribe = () => void;
+/**
+ * Extract the value types from an object type.
+ *
+ * @example
+ * ```typescript
+ * const colors = { red: '#ff0000', green: '#00ff00' } as const;
+ * type ColorValue = ValueOf<typeof colors>; // '#ff0000' | '#00ff00'
+ * ```
+ */
+type ValueOf<T> = T[keyof T];
+/**
+ * Make specified keys required while keeping others optional.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id?: string;
+ *   name?: string;
+ *   email?: string;
+ * }
+ *
+ * type UserWithId = RequireKeys<User, 'id'>;
+ * // { id: string; name?: string; email?: string }
+ * ```
+ */
+type RequireKeys<T, K extends keyof T> = Omit<T, K> & Required<Pick<T, K>>;
+/**
+ * Make specified keys optional while keeping others required.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: string;
+ *   name: string;
+ *   email: string;
+ * }
+ *
+ * type UserDraft = OptionalKeys<User, 'id'>;
+ * // { id?: string; name: string; email: string }
+ * ```
+ */
+type OptionalKeys<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>;
+/**
+ * Extract keys of T that have values assignable to V.
+ *
+ * @example
+ * ```typescript
+ * interface User {
+ *   id: number;
+ *   name: string;
+ *   email: string;
+ *   age: number;
+ * }
+ *
+ * type StringKeys = KeysOfType<User, string>; // 'name' | 'email'
+ * ```
+ */
+type KeysOfType<T, V> = {
+    [K in keyof T]: T[K] extends V ? K : never;
+}[keyof T];
+/**
+ * Type that excludes null and undefined from T.
+ *
+ * @example
+ * ```typescript
+ * type MaybeString = string | null | undefined;
+ * type DefinitelyString = NonNullish<MaybeString>; // string
+ * ```
+ */
+type NonNullish<T> = Exclude<T, null | undefined>;
+/**
+ * Makes all properties of T mutable (removes readonly).
+ *
+ * @example
+ * ```typescript
+ * interface ReadonlyUser {
+ *   readonly id: string;
+ *   readonly name: string;
+ * }
+ *
+ * type MutableUser = Mutable<ReadonlyUser>;
+ * // { id: string; name: string }
+ * ```
+ */
+type Mutable<T> = {
+    -readonly [P in keyof T]: T[P];
+};
+/**
+ * Deep mutable - removes readonly from all nested properties.
+ *
+ * @example
+ * ```typescript
+ * interface ReadonlyConfig {
+ *   readonly api: {
+ *     readonly url: string;
+ *   };
+ * }
+ *
+ * type MutableConfig = DeepMutable<ReadonlyConfig>;
+ * // { api: { url: string } }
+ * ```
+ */
+type DeepMutable<T> = T extends object ? {
+    -readonly [P in keyof T]: DeepMutable<T[P]>;
+} : T;
+/**
+ * Tuple type with exact length.
+ *
+ * @example
+ * ```typescript
+ * type Point2D = Tuple<number, 2>; // [number, number]
+ * type RGB = Tuple<number, 3>; // [number, number, number]
+ * ```
+ */
+type Tuple<T, N extends number, R extends T[] = []> = R['length'] extends N ? R : Tuple<T, N, [T, ...R]>;
+/**
+ * Get the element type of an array.
+ *
+ * @example
+ * ```typescript
+ * type Numbers = number[];
+ * type Num = ArrayElement<Numbers>; // number
+ *
+ * const tuple = ['a', 1, true] as const;
+ * type TupleElement = ArrayElement<typeof tuple>; // 'a' | 1 | true
+ * ```
+ */
+type ArrayElement<T extends readonly unknown[]> = T[number];
+/**
+ * Literal union type helper for better autocomplete.
+ *
+ * @example
+ * ```typescript
+ * type Color = LiteralUnion<'red' | 'green' | 'blue', string>;
+ * // Allows 'red', 'green', 'blue' with autocomplete, but accepts any string
+ * ```
+ */
+type LiteralUnion<T extends U, U = string> = T | (U & {
+    _brand?: never;
+});
 
 /**
  * @oxog/types - Plugin and Kernel interfaces
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -468,7 +608,7 @@ interface PluginLogger {
 type Result<T, E> = Ok<T> | Err<E>;
 /**
  * @oxog/types - Result type for functional error handling
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 /**
@@ -570,7 +710,7 @@ declare function Err<E>(error: E): Err<E>;
 
 /**
  * @oxog/types - Standardized error classes
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 /**
@@ -677,7 +817,7 @@ declare class PluginError extends OxogError {
 
 /**
  * @oxog/types - Type guard functions
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -810,7 +950,7 @@ declare function isErr<E>(value: Result<unknown, E>): value is Err<E>;
 
 /**
  * @oxog/types - Event system types
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -893,7 +1033,7 @@ interface TypedEventEmitter<TEvents extends EventMap> {
 
 /**
  * @oxog/types - Well-known symbols and constants
- * @version 1.0.0
+ * @version 1.0.2
  * @author Ersin Koç
  */
 
@@ -940,6 +1080,6 @@ declare const OXOG_KERNEL: unique symbol;
  * console.log(`Using @oxog/types v${OXOG_VERSION}`);
  * ```
  */
-declare const OXOG_VERSION = "1.0.0";
+declare const OXOG_VERSION = "1.0.2";
 
-export { type AnyFunction, type AsyncFunction, type Brand, type Branded, type DeepPartial, type DeepReadonly, type DeepRequired, Err, ErrorCodes, type EventHandler, type EventMap, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type Kernel, type MaybePromise, type NonEmptyArray, type Nullable, OXOG_KERNEL, OXOG_PLUGIN, OXOG_VERSION, Ok, type Optional, OxogError, type Plugin, PluginError, type PluginLogger, type PluginOptions, type Prettify, type Result, type StrictOmit, type StrictPick, type SyncFunction, type TypedEventEmitter, type Unsubscribe, ValidationError, isErr, isKernel, isOk, isOxogError, isPlugin, isPluginError, isResult, isValidationError };
+export { type AnyFunction, type ArrayElement, type AsyncFunction, type Brand, type Branded, type DeepMutable, type DeepPartial, type DeepReadonly, type DeepRequired, Err, ErrorCodes, type EventHandler, type EventMap, type JsonArray, type JsonObject, type JsonPrimitive, type JsonValue, type Kernel, type KeysOfType, type LiteralUnion, type MaybePromise, type Mutable, type NonEmptyArray, type NonNullish, type Nullable, OXOG_KERNEL, OXOG_PLUGIN, OXOG_VERSION, Ok, type Optional, type OptionalKeys, OxogError, type Plugin, PluginError, type PluginLogger, type PluginOptions, type Prettify, type RequireKeys, type Result, type StrictOmit, type StrictPick, type SyncFunction, type Tuple, type TypedEventEmitter, type Unsubscribe, ValidationError, type ValueOf, isErr, isKernel, isOk, isOxogError, isPlugin, isPluginError, isResult, isValidationError };

package/dist/index.js

@@ -1,2 +1,2 @@
-var l=class{constructor(e){this.value=e;}ok=true;error=void 0;map(e){return E(e(this.value))}mapErr(e){return this}match(e){return e.ok(this.value)}unwrap(){return this.value}unwrapOr(e){return this.value}unwrapOrElse(e){return this.value}},p=class{constructor(e){this.error=e;}ok=false;value=void 0;map(e){return this}mapErr(e){return T(e(this.error))}match(e){return e.err(this.error)}unwrap(){throw new Error(`Cannot unwrap Err: ${String(this.error)}`)}unwrapOr(e){return e}unwrapOrElse(e){return e(this.error)}};function E(r){return new l(r)}function T(r){return new p(r)}var c=(n=>(n.UNKNOWN="UNKNOWN",n.VALIDATION_ERROR="VALIDATION_ERROR",n.PLUGIN_ERROR="PLUGIN_ERROR",n.NOT_FOUND="NOT_FOUND",n.TIMEOUT="TIMEOUT",n.DEPENDENCY_ERROR="DEPENDENCY_ERROR",n))(c||{}),t=class extends Error{constructor(o,u,a){super(o);this.code=u;this.context=a;this.name="OxogError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},s=class extends t{constructor(o,u){super(o,"VALIDATION_ERROR",u);this.context=u;this.name="ValidationError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},i=class extends t{constructor(o,u,a){super(o,"PLUGIN_ERROR",a?{pluginName:u,...a}:void 0);this.pluginName=u;this.name="PluginError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name};function d(r){return r!==null&&typeof r=="object"&&typeof r.name=="string"&&typeof r.version=="string"&&typeof r.install=="function"}function m(r){return r!==null&&typeof r=="object"&&typeof r.use=="function"&&typeof r.unregister=="function"&&typeof r.getPlugin=="function"&&typeof r.listPlugins=="function"&&typeof r.hasPlugin=="function"&&typeof r.emit=="function"&&typeof r.on=="function"&&typeof r.getContext=="function"}function R(r){return r instanceof t}function x(r){return r instanceof s}function k(r){return r instanceof i}function f(r){return r!==null&&typeof r=="object"&&typeof r.ok=="boolean"&&("value"in r||"error"in r)}function U(r){return f(r)&&r.ok===true}function w(r){return f(r)&&r.ok===false}var N=Symbol.for("@oxog/plugin"),P=Symbol.for("@oxog/kernel"),b="1.0.0";export{T as Err,c as ErrorCodes,P as OXOG_KERNEL,N as OXOG_PLUGIN,b as OXOG_VERSION,E as Ok,t as OxogError,i as PluginError,s as ValidationError,w as isErr,m as isKernel,U as isOk,R as isOxogError,d as isPlugin,k as isPluginError,f as isResult,x as isValidationError};//# sourceMappingURL=index.js.map
+var i=class{constructor(e){this.value=e;}ok=true;error=void 0;map(e){return E(e(this.value))}mapErr(e){return this}match(e){return e.ok(this.value)}unwrap(){return this.value}unwrapOr(e){return this.value}unwrapOrElse(e){return this.value}},l=class{constructor(e){this.error=e;}ok=false;value=void 0;map(e){return this}mapErr(e){return T(e(this.error))}match(e){return e.err(this.error)}unwrap(){throw new Error(`Cannot unwrap Err: ${String(this.error)}`)}unwrapOr(e){return e}unwrapOrElse(e){return e(this.error)}};function E(r){return new i(r)}function T(r){return new l(r)}var c=(n=>(n.UNKNOWN="UNKNOWN",n.VALIDATION_ERROR="VALIDATION_ERROR",n.PLUGIN_ERROR="PLUGIN_ERROR",n.NOT_FOUND="NOT_FOUND",n.TIMEOUT="TIMEOUT",n.DEPENDENCY_ERROR="DEPENDENCY_ERROR",n))(c||{}),t=class extends Error{constructor(o,u,p){super(o);this.code=u;this.context=p;this.name="OxogError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},s=class extends t{constructor(o,u){super(o,"VALIDATION_ERROR",u);this.context=u;this.name="ValidationError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name},a=class extends t{constructor(o,u,p){super(o,"PLUGIN_ERROR",{pluginName:u,...p});this.pluginName=u;this.name="PluginError",Object.setPrototypeOf(this,new.target.prototype),Error.captureStackTrace(this,new.target);}name};function m(r){return r!==null&&typeof r=="object"&&typeof r.name=="string"&&typeof r.version=="string"&&typeof r.install=="function"}function R(r){return r!==null&&typeof r=="object"&&typeof r.use=="function"&&typeof r.unregister=="function"&&typeof r.getPlugin=="function"&&typeof r.listPlugins=="function"&&typeof r.hasPlugin=="function"&&typeof r.emit=="function"&&typeof r.on=="function"&&typeof r.getContext=="function"}function d(r){return r instanceof t}function x(r){return r instanceof s}function k(r){return r instanceof a}function f(r){return r!==null&&typeof r=="object"&&typeof r.ok=="boolean"&&("value"in r||"error"in r)}function U(r){return f(r)&&r.ok===true}function w(r){return f(r)&&r.ok===false}var N=Symbol.for("@oxog/plugin"),P=Symbol.for("@oxog/kernel"),b="1.0.2";export{T as Err,c as ErrorCodes,P as OXOG_KERNEL,N as OXOG_PLUGIN,b as OXOG_VERSION,E as Ok,t as OxogError,a as PluginError,s as ValidationError,w as isErr,R as isKernel,U as isOk,d as isOxogError,m as isPlugin,k as isPluginError,f as isResult,x as isValidationError};//# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/result.ts","../src/errors.ts","../src/guards.ts","../src/constants.ts"],"names":["OkImpl","value","fn","Ok","_fn","handlers","_defaultValue","ErrImpl","error","Err","defaultValue","ErrorCodes","OxogError","message","code","context","ValidationError","PluginError","pluginName","isPlugin","isKernel","isOxogError","isValidationError","isPluginError","isResult","isOk","isErr","OXOG_PLUGIN","OXOG_KERNEL","OXOG_VERSION"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @oxog/types - Result type for functional error handling\n * @version 1.0.0\n * @author Ersin Koç\n */\n\n/**\n * Represents a successful result.\n *\n * Contains a value and provides methods for transforming the value\n * or handling errors. Only available on successful results.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // 42\n * }\n * ```\n */\nexport interface Ok<T> {\n  readonly ok: true;\n  readonly value: T;\n  readonly error?: never;\n\n  /** Transform the value if successful */\n  map<U>(fn: (value: T) => U): Result<U, never>;\n\n  /** Transform the error (no-op for Ok) */\n  mapErr<F>(fn: (error: never) => F): Ok<T>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U;\n\n  /** Unwrap the value (asserts success) */\n  unwrap(): T;\n\n  /** Unwrap with default value */\n  unwrapOr(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse(fn: () => T): T;\n}\n\n/**\n * Represents a failed result.\n *\n * Contains an error and provides methods for transforming the error\n * or handling success cases. Only available on failed results.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * if (isErr(err)) {\n *   console.log(err.error); // 'Something went wrong'\n * }\n * ```\n */\nexport interface Err<E> {\n  readonly ok: false;\n  readonly value?: never;\n  readonly error: E;\n\n  /** Transform the value (no-op for Err) */\n  map<U>(fn: (value: never) => U): Err<E>;\n\n  /** Transform the error if failed */\n  mapErr<F>(fn: (error: E) => F): Result<never, F>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U;\n\n  /** Unwrap the value (asserts success, throws for Err) */\n  unwrap(): never;\n\n  /** Unwrap with default value */\n  unwrapOr<T>(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse<T>(fn: () => T): T;\n}\n\n/**\n * Result type - either Ok<T> or Err<E>.\n *\n * A type that represents either success (Ok) or failure (Err).\n * This is inspired by Rust's Result type and provides functional\n * error handling without exceptions.\n *\n * @example\n * ```typescript\n * function divide(a: number, b: number): Result<number, string> {\n *   if (b === 0) {\n *     return Err('Division by zero');\n *   }\n *   return Ok(a / b);\n * }\n *\n * const result = divide(10, 2);\n *\n * // Pattern matching\n * const message = result.match({\n *   ok: (value) => `Result: ${value}`,\n *   err: (error) => `Error: ${error}`\n * });\n *\n * // Chaining\n * const doubled = result\n *   .map(x => x * 2)\n *   .mapErr(e => `Calculation failed: ${e}`);\n * ```\n */\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/**\n * Internal implementation of Ok result.\n */\nclass OkImpl<T> implements Ok<T> {\n  readonly ok = true as const;\n  readonly error = undefined as never;\n\n  constructor(public readonly value: T) {}\n\n  map<U>(fn: (value: T) => U): Result<U, never> {\n    return Ok(fn(this.value));\n  }\n\n  mapErr<F>(_fn: (error: never) => F): Ok<T> {\n    return this;\n  }\n\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U {\n    return handlers.ok(this.value);\n  }\n\n  unwrap(): T {\n    return this.value;\n  }\n\n  unwrapOr(_defaultValue: T): T {\n    return this.value;\n  }\n\n  unwrapOrElse(_fn: () => T): T {\n    return this.value;\n  }\n}\n\n/**\n * Internal implementation of Err result.\n */\nclass ErrImpl<E> implements Err<E> {\n  readonly ok = false as const;\n  readonly value = undefined as never;\n\n  constructor(public readonly error: E) {}\n\n  map<U>(_fn: (value: never) => U): Err<E> {\n    return this;\n  }\n\n  mapErr<F>(fn: (error: E) => F): Result<never, F> {\n    return Err(fn(this.error));\n  }\n\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U {\n    return handlers.err(this.error);\n  }\n\n  unwrap(): never {\n    throw new Error(`Cannot unwrap Err: ${String(this.error)}`);\n  }\n\n  unwrapOr<T>(defaultValue: T): T {\n    return defaultValue;\n  }\n\n  unwrapOrElse<T>(fn: (error: E) => T): T {\n    return fn(this.error);\n  }\n}\n\n/**\n * Creates a successful Result containing a value.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * const okStr = Ok('hello');\n * const okObj = Ok({ id: 1 });\n * ```\n *\n * @param value - The value to wrap\n * @returns An Ok result containing the value\n */\nexport function Ok<T>(value: T): Ok<T> {\n  return new OkImpl(value);\n}\n\n/**\n * Creates a failed Result containing an error.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * const errNum = Err(404);\n * const errObj = Err({ code: 'NOT_FOUND' });\n * ```\n *\n * @param error - The error to wrap\n * @returns An Err result containing the error\n */\nexport function Err<E>(error: E): Err<E> {\n  return new ErrImpl(error);\n}\n","/**\n * @oxog/types - Standardized error classes\n * @version 1.0.0\n * @author Ersin Koç\n */\n\n/**\n * Standard error codes for @oxog ecosystem.\n *\n * These codes provide programmatic ways to identify and handle errors.\n */\nexport enum ErrorCodes {\n  /** Unknown error */\n  UNKNOWN = 'UNKNOWN',\n\n  /** Validation error */\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n\n  /** Plugin-related error */\n  PLUGIN_ERROR = 'PLUGIN_ERROR',\n\n  /** Resource not found */\n  NOT_FOUND = 'NOT_FOUND',\n\n  /** Operation timed out */\n  TIMEOUT = 'TIMEOUT',\n\n  /** Dependency error */\n  DEPENDENCY_ERROR = 'DEPENDENCY_ERROR',\n}\n\n/**\n * Base error class for all @oxog errors.\n *\n * Provides structured error information with code, message, and context.\n * All other @oxog errors inherit from this class.\n *\n * @example\n * ```typescript\n * throw new OxogError(\n *   'Database connection failed',\n *   ErrorCodes.DEPENDENCY_ERROR,\n *   { host: 'localhost', port: 5432 }\n * );\n * ```\n */\nexport class OxogError extends Error {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new OxogError.\n   *\n   * @param message - Human-readable error message\n   * @param code - Error code for programmatic handling\n   * @param context - Additional context about the error\n   */\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'OxogError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when validation fails.\n *\n * Used for input validation, schema validation, and type checking errors.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\n *   'Invalid email format',\n *   { field: 'email', value: 'not-an-email' }\n * );\n * ```\n */\nexport class ValidationError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new ValidationError.\n   *\n   * @param message - Human-readable error message\n   * @param context - Additional context about the validation failure\n   */\n  constructor(\n    message: string,\n    public override readonly context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.VALIDATION_ERROR, context);\n    this.name = 'ValidationError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when a plugin operation fails.\n *\n * Used for plugin initialization, dependency resolution, and runtime errors\n * specific to plugins.\n *\n * @example\n * ```typescript\n * throw new PluginError(\n *   'Failed to initialize cache plugin',\n *   'cache-plugin',\n *   { reason: 'Redis connection failed' }\n * );\n * ```\n */\nexport class PluginError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new PluginError.\n   *\n   * @param message - Human-readable error message\n   * @param pluginName - Name of the plugin that caused the error\n   * @param context - Additional context about the plugin error\n   */\n  constructor(\n    message: string,\n    public readonly pluginName: string,\n    context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.PLUGIN_ERROR, context ? { pluginName, ...context } : undefined);\n    this.name = 'PluginError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n","/**\n * @oxog/types - Type guard functions\n * @version 1.0.0\n * @author Ersin Koç\n */\n\nimport type { Plugin, Kernel } from './plugin.js';\nimport type { Result, Ok, Err } from './result.js';\nimport { OxogError, ValidationError, PluginError } from './errors.js';\n\n/**\n * Type guard for Plugin.\n *\n * Checks if a value is a valid Plugin instance.\n *\n * @example\n * ```typescript\n * const plugin = { name: 'test', version: '1.0.0', install: () => {} };\n * if (isPlugin(plugin)) {\n *   console.log(plugin.name); // TypeScript knows it's a Plugin\n * }\n * ```\n */\nexport function isPlugin<T>(value: unknown): value is Plugin<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Plugin<T>).name === 'string' &&\n    typeof (value as Plugin<T>).version === 'string' &&\n    typeof (value as Plugin<T>).install === 'function'\n  );\n}\n\n/**\n * Type guard for Kernel.\n *\n * Checks if a value is a valid Kernel instance.\n *\n * @example\n * ```typescript\n * const kernel = {\n *   use: (plugin) => kernel,\n *   unregister: () => true,\n *   getPlugin: () => undefined,\n *   listPlugins: () => [],\n *   hasPlugin: () => false,\n *   emit: () => {},\n *   on: () => () => {},\n *   getContext: () => null\n * };\n * if (isKernel(kernel)) {\n *   console.log(kernel.listPlugins()); // TypeScript knows it's a Kernel\n * }\n * ```\n */\nexport function isKernel<T>(value: unknown): value is Kernel<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Kernel<T>).use === 'function' &&\n    typeof (value as Kernel<T>).unregister === 'function' &&\n    typeof (value as Kernel<T>).getPlugin === 'function' &&\n    typeof (value as Kernel<T>).listPlugins === 'function' &&\n    typeof (value as Kernel<T>).hasPlugin === 'function' &&\n    typeof (value as Kernel<T>).emit === 'function' &&\n    typeof (value as Kernel<T>).on === 'function' &&\n    typeof (value as Kernel<T>).getContext === 'function'\n  );\n}\n\n/**\n * Type guard for OxogError.\n *\n * Checks if a value is an OxogError instance.\n *\n * @example\n * ```typescript\n * const error = new OxogError('Test', 'TEST');\n * if (isOxogError(error)) {\n *   console.log(error.code); // TypeScript knows it's an OxogError\n * }\n * ```\n */\nexport function isOxogError(value: unknown): value is OxogError {\n  return value instanceof OxogError;\n}\n\n/**\n * Type guard for ValidationError.\n *\n * Checks if a value is a ValidationError instance.\n *\n * @example\n * ```typescript\n * const error = new ValidationError('Invalid', { field: 'test' });\n * if (isValidationError(error)) {\n *   console.log(error.context); // TypeScript knows it's a ValidationError\n * }\n * ```\n */\nexport function isValidationError(value: unknown): value is ValidationError {\n  return value instanceof ValidationError;\n}\n\n/**\n * Type guard for PluginError.\n *\n * Checks if a value is a PluginError instance.\n *\n * @example\n * ```typescript\n * const error = new PluginError('Plugin failed', 'my-plugin');\n * if (isPluginError(error)) {\n *   console.log(error.pluginName); // TypeScript knows it's a PluginError\n * }\n * ```\n */\nexport function isPluginError(value: unknown): value is PluginError {\n  return value instanceof PluginError;\n}\n\n/**\n * Type guard for Result.\n *\n * Checks if a value is a Result instance (either Ok or Err).\n *\n * @example\n * ```typescript\n * const result = Ok(42);\n * if (isResult(result)) {\n *   // result is Ok<number, unknown>\n * }\n *\n * const err = Err('error');\n * if (isResult(err)) {\n *   // err is Err<unknown, string>\n * }\n * ```\n */\nexport function isResult<T, E>(value: unknown): value is Result<T, E> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Result<T, E>).ok === 'boolean' &&\n    (('value' in (value as object)) || ('error' in (value as object)))\n  );\n}\n\n/**\n * Type guard for Ok result.\n *\n * Checks if a Result is an Ok (success) instance.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // TypeScript knows it's Ok\n * }\n * ```\n */\nexport function isOk<T>(value: Result<T, unknown>): value is Ok<T> {\n  return isResult(value) && value.ok === true;\n}\n\n/**\n * Type guard for Err result.\n *\n * Checks if a Result is an Err (failure) instance.\n *\n * @example\n * ```typescript\n * const err = Err('error');\n * if (isErr(err)) {\n *   console.log(err.error); // TypeScript knows it's Err\n * }\n * ```\n */\nexport function isErr<E>(value: Result<unknown, E>): value is Err<E> {\n  return isResult(value) && value.ok === false;\n}\n","/**\n * @oxog/types - Well-known symbols and constants\n * @version 1.0.0\n * @author Ersin Koç\n */\n\nimport { ErrorCodes } from './errors.js';\n\n/**\n * Well-known symbol for @oxog plugins.\n *\n * Use this symbol to mark objects as @oxog plugins.\n * This enables runtime detection and validation.\n *\n * @example\n * ```typescript\n * const myPlugin = {\n *   [OXOG_PLUGIN]: true,\n *   name: 'my-plugin',\n *   version: '1.0.0',\n *   install: () => {}\n * };\n * ```\n */\nexport const OXOG_PLUGIN = Symbol.for('@oxog/plugin');\n\n/**\n * Well-known symbol for @oxog kernels.\n *\n * Use this symbol to mark objects as @oxog kernels.\n * This enables runtime detection and validation.\n *\n * @example\n * ```typescript\n * const myKernel = {\n *   [OXOG_KERNEL]: true,\n *   use: (plugin) => kernel,\n *   // ... other methods\n * };\n * ```\n */\nexport const OXOG_KERNEL = Symbol.for('@oxog/kernel');\n\n/**\n * @oxog/types package version.\n *\n * Current version of the @oxog/types package.\n *\n * @example\n * ```typescript\n * console.log(`Using @oxog/types v${OXOG_VERSION}`);\n * ```\n */\nexport const OXOG_VERSION = '1.0.0';\n\n/**\n * Standard error codes for @oxog ecosystem.\n *\n * Re-exported from errors module for convenience.\n *\n * @example\n * ```typescript\n * throw new OxogError('Not found', ErrorCodes.NOT_FOUND);\n * ```\n */\nexport { ErrorCodes };\n"]}
+{"version":3,"sources":["../src/result.ts","../src/errors.ts","../src/guards.ts","../src/constants.ts"],"names":["OkImpl","value","fn","Ok","_fn","handlers","_defaultValue","ErrImpl","error","Err","defaultValue","ErrorCodes","OxogError","message","code","context","ValidationError","PluginError","pluginName","isPlugin","isKernel","isOxogError","isValidationError","isPluginError","isResult","isOk","isErr","OXOG_PLUGIN","OXOG_KERNEL","OXOG_VERSION"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * @oxog/types - Result type for functional error handling\n * @version 1.0.2\n * @author Ersin Koç\n */\n\n/**\n * Represents a successful result.\n *\n * Contains a value and provides methods for transforming the value\n * or handling errors. Only available on successful results.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // 42\n * }\n * ```\n */\nexport interface Ok<T> {\n  readonly ok: true;\n  readonly value: T;\n  readonly error?: never;\n\n  /** Transform the value if successful */\n  map<U>(fn: (value: T) => U): Result<U, never>;\n\n  /** Transform the error (no-op for Ok) */\n  mapErr<F>(fn: (error: never) => F): Ok<T>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U;\n\n  /** Unwrap the value (asserts success) */\n  unwrap(): T;\n\n  /** Unwrap with default value */\n  unwrapOr(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse(fn: () => T): T;\n}\n\n/**\n * Represents a failed result.\n *\n * Contains an error and provides methods for transforming the error\n * or handling success cases. Only available on failed results.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * if (isErr(err)) {\n *   console.log(err.error); // 'Something went wrong'\n * }\n * ```\n */\nexport interface Err<E> {\n  readonly ok: false;\n  readonly value?: never;\n  readonly error: E;\n\n  /** Transform the value (no-op for Err) */\n  map<U>(fn: (value: never) => U): Err<E>;\n\n  /** Transform the error if failed */\n  mapErr<F>(fn: (error: E) => F): Result<never, F>;\n\n  /** Pattern matching for both cases */\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U;\n\n  /** Unwrap the value (asserts success, throws for Err) */\n  unwrap(): never;\n\n  /** Unwrap with default value */\n  unwrapOr<T>(defaultValue: T): T;\n\n  /** Unwrap using a fallback function */\n  unwrapOrElse<T>(fn: () => T): T;\n}\n\n/**\n * Result type - either Ok<T> or Err<E>.\n *\n * A type that represents either success (Ok) or failure (Err).\n * This is inspired by Rust's Result type and provides functional\n * error handling without exceptions.\n *\n * @example\n * ```typescript\n * function divide(a: number, b: number): Result<number, string> {\n *   if (b === 0) {\n *     return Err('Division by zero');\n *   }\n *   return Ok(a / b);\n * }\n *\n * const result = divide(10, 2);\n *\n * // Pattern matching\n * const message = result.match({\n *   ok: (value) => `Result: ${value}`,\n *   err: (error) => `Error: ${error}`\n * });\n *\n * // Chaining\n * const doubled = result\n *   .map(x => x * 2)\n *   .mapErr(e => `Calculation failed: ${e}`);\n * ```\n */\nexport type Result<T, E> = Ok<T> | Err<E>;\n\n/**\n * Internal implementation of Ok result.\n */\nclass OkImpl<T> implements Ok<T> {\n  readonly ok = true as const;\n  readonly error = undefined as never;\n\n  constructor(public readonly value: T) {}\n\n  map<U>(fn: (value: T) => U): Result<U, never> {\n    return Ok(fn(this.value));\n  }\n\n  mapErr<F>(_fn: (error: never) => F): Ok<T> {\n    return this;\n  }\n\n  match<U>(handlers: { ok: (value: T) => U; err: (error: never) => U }): U {\n    return handlers.ok(this.value);\n  }\n\n  unwrap(): T {\n    return this.value;\n  }\n\n  unwrapOr(_defaultValue: T): T {\n    return this.value;\n  }\n\n  unwrapOrElse(_fn: () => T): T {\n    return this.value;\n  }\n}\n\n/**\n * Internal implementation of Err result.\n */\nclass ErrImpl<E> implements Err<E> {\n  readonly ok = false as const;\n  readonly value = undefined as never;\n\n  constructor(public readonly error: E) {}\n\n  map<U>(_fn: (value: never) => U): Err<E> {\n    return this;\n  }\n\n  mapErr<F>(fn: (error: E) => F): Result<never, F> {\n    return Err(fn(this.error));\n  }\n\n  match<U>(handlers: { ok: (value: never) => U; err: (error: E) => U }): U {\n    return handlers.err(this.error);\n  }\n\n  unwrap(): never {\n    throw new Error(`Cannot unwrap Err: ${String(this.error)}`);\n  }\n\n  unwrapOr<T>(defaultValue: T): T {\n    return defaultValue;\n  }\n\n  unwrapOrElse<T>(fn: (error: E) => T): T {\n    return fn(this.error);\n  }\n}\n\n/**\n * Creates a successful Result containing a value.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * const okStr = Ok('hello');\n * const okObj = Ok({ id: 1 });\n * ```\n *\n * @param value - The value to wrap\n * @returns An Ok result containing the value\n */\nexport function Ok<T>(value: T): Ok<T> {\n  return new OkImpl(value);\n}\n\n/**\n * Creates a failed Result containing an error.\n *\n * @example\n * ```typescript\n * const err = Err('Something went wrong');\n * const errNum = Err(404);\n * const errObj = Err({ code: 'NOT_FOUND' });\n * ```\n *\n * @param error - The error to wrap\n * @returns An Err result containing the error\n */\nexport function Err<E>(error: E): Err<E> {\n  return new ErrImpl(error);\n}\n","/**\n * @oxog/types - Standardized error classes\n * @version 1.0.2\n * @author Ersin Koç\n */\n\n/**\n * Standard error codes for @oxog ecosystem.\n *\n * These codes provide programmatic ways to identify and handle errors.\n */\nexport enum ErrorCodes {\n  /** Unknown error */\n  UNKNOWN = 'UNKNOWN',\n\n  /** Validation error */\n  VALIDATION_ERROR = 'VALIDATION_ERROR',\n\n  /** Plugin-related error */\n  PLUGIN_ERROR = 'PLUGIN_ERROR',\n\n  /** Resource not found */\n  NOT_FOUND = 'NOT_FOUND',\n\n  /** Operation timed out */\n  TIMEOUT = 'TIMEOUT',\n\n  /** Dependency error */\n  DEPENDENCY_ERROR = 'DEPENDENCY_ERROR',\n}\n\n/**\n * Base error class for all @oxog errors.\n *\n * Provides structured error information with code, message, and context.\n * All other @oxog errors inherit from this class.\n *\n * @example\n * ```typescript\n * throw new OxogError(\n *   'Database connection failed',\n *   ErrorCodes.DEPENDENCY_ERROR,\n *   { host: 'localhost', port: 5432 }\n * );\n * ```\n */\nexport class OxogError extends Error {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new OxogError.\n   *\n   * @param message - Human-readable error message\n   * @param code - Error code for programmatic handling\n   * @param context - Additional context about the error\n   */\n  constructor(\n    message: string,\n    public readonly code: string,\n    public readonly context?: Record<string, unknown>\n  ) {\n    super(message);\n    this.name = 'OxogError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when validation fails.\n *\n * Used for input validation, schema validation, and type checking errors.\n *\n * @example\n * ```typescript\n * throw new ValidationError(\n *   'Invalid email format',\n *   { field: 'email', value: 'not-an-email' }\n * );\n * ```\n */\nexport class ValidationError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new ValidationError.\n   *\n   * @param message - Human-readable error message\n   * @param context - Additional context about the validation failure\n   */\n  constructor(\n    message: string,\n    public override readonly context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.VALIDATION_ERROR, context);\n    this.name = 'ValidationError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n\n/**\n * Error thrown when a plugin operation fails.\n *\n * Used for plugin initialization, dependency resolution, and runtime errors\n * specific to plugins.\n *\n * @example\n * ```typescript\n * throw new PluginError(\n *   'Failed to initialize cache plugin',\n *   'cache-plugin',\n *   { reason: 'Redis connection failed' }\n * );\n * ```\n */\nexport class PluginError extends OxogError {\n  /** Error name */\n  public override readonly name: string;\n\n  /**\n   * Creates a new PluginError.\n   *\n   * @param message - Human-readable error message\n   * @param pluginName - Name of the plugin that caused the error\n   * @param context - Additional context about the plugin error\n   */\n  constructor(\n    message: string,\n    public readonly pluginName: string,\n    context?: Record<string, unknown>\n  ) {\n    super(message, ErrorCodes.PLUGIN_ERROR, { pluginName, ...context });\n    this.name = 'PluginError';\n    Object.setPrototypeOf(this, new.target.prototype);\n    Error.captureStackTrace(this, new.target);\n  }\n}\n","/**\n * @oxog/types - Type guard functions\n * @version 1.0.2\n * @author Ersin Koç\n */\n\nimport type { Plugin, Kernel } from './plugin.js';\nimport type { Result, Ok, Err } from './result.js';\nimport { OxogError, ValidationError, PluginError } from './errors.js';\n\n/**\n * Type guard for Plugin.\n *\n * Checks if a value is a valid Plugin instance.\n *\n * @example\n * ```typescript\n * const plugin = { name: 'test', version: '1.0.0', install: () => {} };\n * if (isPlugin(plugin)) {\n *   console.log(plugin.name); // TypeScript knows it's a Plugin\n * }\n * ```\n */\nexport function isPlugin<T>(value: unknown): value is Plugin<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Plugin<T>).name === 'string' &&\n    typeof (value as Plugin<T>).version === 'string' &&\n    typeof (value as Plugin<T>).install === 'function'\n  );\n}\n\n/**\n * Type guard for Kernel.\n *\n * Checks if a value is a valid Kernel instance.\n *\n * @example\n * ```typescript\n * const kernel = {\n *   use: (plugin) => kernel,\n *   unregister: () => true,\n *   getPlugin: () => undefined,\n *   listPlugins: () => [],\n *   hasPlugin: () => false,\n *   emit: () => {},\n *   on: () => () => {},\n *   getContext: () => null\n * };\n * if (isKernel(kernel)) {\n *   console.log(kernel.listPlugins()); // TypeScript knows it's a Kernel\n * }\n * ```\n */\nexport function isKernel<T>(value: unknown): value is Kernel<T> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Kernel<T>).use === 'function' &&\n    typeof (value as Kernel<T>).unregister === 'function' &&\n    typeof (value as Kernel<T>).getPlugin === 'function' &&\n    typeof (value as Kernel<T>).listPlugins === 'function' &&\n    typeof (value as Kernel<T>).hasPlugin === 'function' &&\n    typeof (value as Kernel<T>).emit === 'function' &&\n    typeof (value as Kernel<T>).on === 'function' &&\n    typeof (value as Kernel<T>).getContext === 'function'\n  );\n}\n\n/**\n * Type guard for OxogError.\n *\n * Checks if a value is an OxogError instance.\n *\n * @example\n * ```typescript\n * const error = new OxogError('Test', 'TEST');\n * if (isOxogError(error)) {\n *   console.log(error.code); // TypeScript knows it's an OxogError\n * }\n * ```\n */\nexport function isOxogError(value: unknown): value is OxogError {\n  return value instanceof OxogError;\n}\n\n/**\n * Type guard for ValidationError.\n *\n * Checks if a value is a ValidationError instance.\n *\n * @example\n * ```typescript\n * const error = new ValidationError('Invalid', { field: 'test' });\n * if (isValidationError(error)) {\n *   console.log(error.context); // TypeScript knows it's a ValidationError\n * }\n * ```\n */\nexport function isValidationError(value: unknown): value is ValidationError {\n  return value instanceof ValidationError;\n}\n\n/**\n * Type guard for PluginError.\n *\n * Checks if a value is a PluginError instance.\n *\n * @example\n * ```typescript\n * const error = new PluginError('Plugin failed', 'my-plugin');\n * if (isPluginError(error)) {\n *   console.log(error.pluginName); // TypeScript knows it's a PluginError\n * }\n * ```\n */\nexport function isPluginError(value: unknown): value is PluginError {\n  return value instanceof PluginError;\n}\n\n/**\n * Type guard for Result.\n *\n * Checks if a value is a Result instance (either Ok or Err).\n *\n * @example\n * ```typescript\n * const result = Ok(42);\n * if (isResult(result)) {\n *   // result is Ok<number, unknown>\n * }\n *\n * const err = Err('error');\n * if (isResult(err)) {\n *   // err is Err<unknown, string>\n * }\n * ```\n */\nexport function isResult<T, E>(value: unknown): value is Result<T, E> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    typeof (value as Result<T, E>).ok === 'boolean' &&\n    (('value' in (value as object)) || ('error' in (value as object)))\n  );\n}\n\n/**\n * Type guard for Ok result.\n *\n * Checks if a Result is an Ok (success) instance.\n *\n * @example\n * ```typescript\n * const ok = Ok(42);\n * if (isOk(ok)) {\n *   console.log(ok.value); // TypeScript knows it's Ok\n * }\n * ```\n */\nexport function isOk<T>(value: Result<T, unknown>): value is Ok<T> {\n  return isResult(value) && value.ok === true;\n}\n\n/**\n * Type guard for Err result.\n *\n * Checks if a Result is an Err (failure) instance.\n *\n * @example\n * ```typescript\n * const err = Err('error');\n * if (isErr(err)) {\n *   console.log(err.error); // TypeScript knows it's Err\n * }\n * ```\n */\nexport function isErr<E>(value: Result<unknown, E>): value is Err<E> {\n  return isResult(value) && value.ok === false;\n}\n","/**\r\n * @oxog/types - Well-known symbols and constants\r\n * @version 1.0.2\r\n * @author Ersin Koç\r\n */\r\n\r\nimport { ErrorCodes } from './errors.js';\r\n\r\n/**\r\n * Well-known symbol for @oxog plugins.\r\n *\r\n * Use this symbol to mark objects as @oxog plugins.\r\n * This enables runtime detection and validation.\r\n *\r\n * @example\r\n * ```typescript\r\n * const myPlugin = {\r\n *   [OXOG_PLUGIN]: true,\r\n *   name: 'my-plugin',\r\n *   version: '1.0.0',\r\n *   install: () => {}\r\n * };\r\n * ```\r\n */\r\nexport const OXOG_PLUGIN = Symbol.for('@oxog/plugin');\r\n\r\n/**\r\n * Well-known symbol for @oxog kernels.\r\n *\r\n * Use this symbol to mark objects as @oxog kernels.\r\n * This enables runtime detection and validation.\r\n *\r\n * @example\r\n * ```typescript\r\n * const myKernel = {\r\n *   [OXOG_KERNEL]: true,\r\n *   use: (plugin) => kernel,\r\n *   // ... other methods\r\n * };\r\n * ```\r\n */\r\nexport const OXOG_KERNEL = Symbol.for('@oxog/kernel');\r\n\r\n/**\r\n * @oxog/types package version.\r\n *\r\n * Current version of the @oxog/types package.\r\n *\r\n * @example\r\n * ```typescript\r\n * console.log(`Using @oxog/types v${OXOG_VERSION}`);\r\n * ```\r\n */\r\nexport const OXOG_VERSION = '1.0.2';\r\n\r\n/**\r\n * Standard error codes for @oxog ecosystem.\r\n *\r\n * Re-exported from errors module for convenience.\r\n *\r\n * @example\r\n * ```typescript\r\n * throw new OxogError('Not found', ErrorCodes.NOT_FOUND);\r\n * ```\r\n */\r\nexport { ErrorCodes };\r\n"]}

package/dist/metafile-cjs.json

@@ -1 +1 @@
-{"inputs":{"src/plugin.ts":{"bytes":4156,"imports":[],"format":"esm"},"src/result.ts":{"bytes":4793,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":3454,"imports":[],"format":"esm"},"src/guards.ts":{"bytes":4507,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/events.ts":{"bytes":2467,"imports":[],"format":"esm"},"src/utils.ts":{"bytes":6788,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":1323,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/index.ts":{"bytes":981,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin.js"},{"path":"src/result.ts","kind":"import-statement","original":"./result.js"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"},{"path":"src/guards.ts","kind":"import-statement","original":"./guards.js"},{"path":"src/events.ts","kind":"import-statement","original":"./events.js"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants.js"}],"format":"esm"}},"outputs":{"dist/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":17704},"dist/index.cjs":{"imports":[],"exports":["Err","ErrorCodes","OXOG_KERNEL","OXOG_PLUGIN","OXOG_VERSION","Ok","OxogError","PluginError","ValidationError","isErr","isKernel","isOk","isOxogError","isPlugin","isPluginError","isResult","isValidationError"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":0},"src/result.ts":{"bytesInOutput":569},"src/errors.ts":{"bytesInOutput":819},"src/guards.ts":{"bytesInOutput":709},"src/constants.ts":{"bytesInOutput":72}},"bytes":2438}}}
+{"inputs":{"src/plugin.ts":{"bytes":4156,"imports":[],"format":"esm"},"src/result.ts":{"bytes":4793,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":3432,"imports":[],"format":"esm"},"src/guards.ts":{"bytes":4507,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/events.ts":{"bytes":2467,"imports":[],"format":"esm"},"src/utils.ts":{"bytes":10153,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":1389,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/index.ts":{"bytes":981,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin.js"},{"path":"src/result.ts","kind":"import-statement","original":"./result.js"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"},{"path":"src/guards.ts","kind":"import-statement","original":"./guards.js"},{"path":"src/events.ts","kind":"import-statement","original":"./events.js"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants.js"}],"format":"esm"}},"outputs":{"dist/index.cjs.map":{"imports":[],"exports":[],"inputs":{},"bytes":17803},"dist/index.cjs":{"imports":[],"exports":["Err","ErrorCodes","OXOG_KERNEL","OXOG_PLUGIN","OXOG_VERSION","Ok","OxogError","PluginError","ValidationError","isErr","isKernel","isOk","isOxogError","isPlugin","isPluginError","isResult","isValidationError"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":0},"src/result.ts":{"bytesInOutput":569},"src/errors.ts":{"bytesInOutput":810},"src/guards.ts":{"bytesInOutput":709},"src/constants.ts":{"bytesInOutput":72}},"bytes":2429}}}

package/dist/metafile-esm.json

@@ -1 +1 @@
-{"inputs":{"src/plugin.ts":{"bytes":4156,"imports":[],"format":"esm"},"src/result.ts":{"bytes":4793,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":3454,"imports":[],"format":"esm"},"src/guards.ts":{"bytes":4507,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/events.ts":{"bytes":2467,"imports":[],"format":"esm"},"src/utils.ts":{"bytes":6788,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":1323,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/index.ts":{"bytes":981,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin.js"},{"path":"src/result.ts","kind":"import-statement","original":"./result.js"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"},{"path":"src/guards.ts","kind":"import-statement","original":"./guards.js"},{"path":"src/events.ts","kind":"import-statement","original":"./events.js"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants.js"}],"format":"esm"}},"outputs":{"dist/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":17704},"dist/index.js":{"imports":[],"exports":["Err","ErrorCodes","OXOG_KERNEL","OXOG_PLUGIN","OXOG_VERSION","Ok","OxogError","PluginError","ValidationError","isErr","isKernel","isOk","isOxogError","isPlugin","isPluginError","isResult","isValidationError"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":0},"src/result.ts":{"bytesInOutput":569},"src/errors.ts":{"bytesInOutput":819},"src/guards.ts":{"bytesInOutput":709},"src/constants.ts":{"bytesInOutput":72}},"bytes":2438}}}
+{"inputs":{"src/plugin.ts":{"bytes":4156,"imports":[],"format":"esm"},"src/result.ts":{"bytes":4793,"imports":[],"format":"esm"},"src/errors.ts":{"bytes":3432,"imports":[],"format":"esm"},"src/guards.ts":{"bytes":4507,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/events.ts":{"bytes":2467,"imports":[],"format":"esm"},"src/utils.ts":{"bytes":10153,"imports":[],"format":"esm"},"src/constants.ts":{"bytes":1389,"imports":[{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"}],"format":"esm"},"src/index.ts":{"bytes":981,"imports":[{"path":"src/plugin.ts","kind":"import-statement","original":"./plugin.js"},{"path":"src/result.ts","kind":"import-statement","original":"./result.js"},{"path":"src/errors.ts","kind":"import-statement","original":"./errors.js"},{"path":"src/guards.ts","kind":"import-statement","original":"./guards.js"},{"path":"src/events.ts","kind":"import-statement","original":"./events.js"},{"path":"src/utils.ts","kind":"import-statement","original":"./utils.js"},{"path":"src/constants.ts","kind":"import-statement","original":"./constants.js"}],"format":"esm"}},"outputs":{"dist/index.js.map":{"imports":[],"exports":[],"inputs":{},"bytes":17803},"dist/index.js":{"imports":[],"exports":["Err","ErrorCodes","OXOG_KERNEL","OXOG_PLUGIN","OXOG_VERSION","Ok","OxogError","PluginError","ValidationError","isErr","isKernel","isOk","isOxogError","isPlugin","isPluginError","isResult","isValidationError"],"entryPoint":"src/index.ts","inputs":{"src/index.ts":{"bytesInOutput":0},"src/result.ts":{"bytesInOutput":569},"src/errors.ts":{"bytesInOutput":810},"src/guards.ts":{"bytesInOutput":709},"src/constants.ts":{"bytesInOutput":72}},"bytes":2429}}}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@oxog/types",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Shared TypeScript types, interfaces, and utilities for the @oxog ecosystem",
   "author": "Ersin Koç",
   "license": "MIT",
@@ -13,6 +13,41 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.cjs"
+    },
+    "./plugin": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./result": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./errors": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./guards": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./events": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./utils": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    },
+    "./constants": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
     }
   },
   "files": [
@@ -44,13 +79,13 @@
     "prepare": "npm run build"
   },
   "devDependencies": {
-    "typescript": "^5.0.0",
-    "vitest": "^2.0.0",
-    "@vitest/coverage-v8": "^2.0.0",
-    "tsup": "^8.0.0",
     "@types/node": "^20.0.0",
+    "@vitest/coverage-v8": "^2.0.0",
+    "eslint": "^9.0.0",
     "prettier": "^3.0.0",
-    "eslint": "^9.0.0"
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^2.0.0"
   },
   "publishConfig": {
     "access": "public"