@astralibx/core 1.1.0

package/README.md

@@ -0,0 +1,80 @@
+# @astralibx/core
+
+Shared foundation for all @astralibx packages -- base errors, types, and validation helpers.
+
+## Install
+
+```bash
+npm install @astralibx/core
+```
+
+`zod` is included as a dependency -- no need to install it separately.
+
+## Quick Start
+
+```ts
+import { z } from 'zod';
+import {
+  AlxError,
+  createConfigValidator,
+  baseDbSchema,
+  loggerSchema,
+} from '@astralibx/core';
+
+// 1. Extend AlxError for your package
+class QueueError extends AlxError {
+  constructor(message: string) {
+    super(message, 'QUEUE_ERROR');
+    this.name = 'QueueError';
+  }
+}
+
+// 2. Compose a config schema from core fragments + your own fields
+const queueConfigSchema = z.object({
+  db: baseDbSchema,
+  logger: loggerSchema.optional(),
+  concurrency: z.number().int().positive().default(5),
+});
+
+// 3. Validate config -- throws ConfigValidationError on invalid input
+const validate = createConfigValidator(queueConfigSchema);
+
+validate({
+  db: { connection: mongoClient.db() },
+  concurrency: 10,
+});
+```
+
+## What's Included
+
+**Error classes**
+
+- `AlxError` -- Base error for the ecosystem. Carries a `code` string.
+- `ConfigValidationError` -- Thrown on invalid config. Adds a `field` property.
+
+**Type contracts**
+
+- `LogAdapter` -- Logger-agnostic interface (`info`, `warn`, `error` methods).
+- `BaseDbConfig` -- Database connection + optional `collectionPrefix`.
+- `BaseRedisConfig` -- Redis connection + optional `keyPrefix`.
+
+**Zod schemas**
+
+- `loggerSchema` -- Validates a `LogAdapter`-shaped object.
+- `baseDbSchema` -- Validates `BaseDbConfig` (connection must be non-null).
+- `baseRedisSchema` -- Validates `BaseRedisConfig` (connection must be non-null).
+
+**Helpers**
+
+- `createConfigValidator` -- Takes a Zod schema, returns a validate function that throws `ConfigValidationError` on failure.
+
+## Documentation
+
+- [Error Classes](docs/errors.md) -- AlxError, ConfigValidationError, extending for your package
+- [Type Contracts](docs/types.md) -- LogAdapter, BaseDbConfig, BaseRedisConfig
+- [Validation](docs/validation.md) -- Zod schemas, createConfigValidator, composing schemas
+- [Package Author Guide](docs/package-author-guide.md) -- Building new @astralibx packages on top of core
+
+## License
+
+MIT

package/dist/index.d.mts

@@ -0,0 +1,61 @@
+import { z, ZodSchema } from 'zod';
+
+declare class AlxError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+declare class ConfigValidationError extends AlxError {
+    readonly field: string;
+    constructor(message: string, field: string);
+}
+
+interface LogAdapter {
+    info: (msg: string, meta?: Record<string, unknown>) => void;
+    warn: (msg: string, meta?: Record<string, unknown>) => void;
+    error: (msg: string, meta?: Record<string, unknown>) => void;
+}
+interface BaseDbConfig {
+    connection: unknown;
+    collectionPrefix?: string;
+}
+interface BaseRedisConfig {
+    connection: unknown;
+    keyPrefix?: string;
+}
+
+declare const loggerSchema: z.ZodObject<{
+    info: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    warn: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    error: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    info: (...args: unknown[]) => unknown;
+    warn: (...args: unknown[]) => unknown;
+    error: (...args: unknown[]) => unknown;
+}, {
+    info: (...args: unknown[]) => unknown;
+    warn: (...args: unknown[]) => unknown;
+    error: (...args: unknown[]) => unknown;
+}>;
+declare const baseDbSchema: z.ZodObject<{
+    connection: z.ZodEffects<z.ZodAny, any, any>;
+    collectionPrefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    connection?: any;
+    collectionPrefix?: string | undefined;
+}, {
+    connection?: any;
+    collectionPrefix?: string | undefined;
+}>;
+declare const baseRedisSchema: z.ZodObject<{
+    connection: z.ZodEffects<z.ZodAny, any, any>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    connection?: any;
+    keyPrefix?: string | undefined;
+}, {
+    connection?: any;
+    keyPrefix?: string | undefined;
+}>;
+declare function createConfigValidator(configSchema: ZodSchema, ErrorClass?: typeof ConfigValidationError): (raw: unknown) => void;
+
+export { AlxError, type BaseDbConfig, type BaseRedisConfig, ConfigValidationError, type LogAdapter, baseDbSchema, baseRedisSchema, createConfigValidator, loggerSchema };

package/dist/index.d.ts

@@ -0,0 +1,61 @@
+import { z, ZodSchema } from 'zod';
+
+declare class AlxError extends Error {
+    readonly code: string;
+    constructor(message: string, code: string);
+}
+declare class ConfigValidationError extends AlxError {
+    readonly field: string;
+    constructor(message: string, field: string);
+}
+
+interface LogAdapter {
+    info: (msg: string, meta?: Record<string, unknown>) => void;
+    warn: (msg: string, meta?: Record<string, unknown>) => void;
+    error: (msg: string, meta?: Record<string, unknown>) => void;
+}
+interface BaseDbConfig {
+    connection: unknown;
+    collectionPrefix?: string;
+}
+interface BaseRedisConfig {
+    connection: unknown;
+    keyPrefix?: string;
+}
+
+declare const loggerSchema: z.ZodObject<{
+    info: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    warn: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+    error: z.ZodFunction<z.ZodTuple<[], z.ZodUnknown>, z.ZodUnknown>;
+}, "strip", z.ZodTypeAny, {
+    info: (...args: unknown[]) => unknown;
+    warn: (...args: unknown[]) => unknown;
+    error: (...args: unknown[]) => unknown;
+}, {
+    info: (...args: unknown[]) => unknown;
+    warn: (...args: unknown[]) => unknown;
+    error: (...args: unknown[]) => unknown;
+}>;
+declare const baseDbSchema: z.ZodObject<{
+    connection: z.ZodEffects<z.ZodAny, any, any>;
+    collectionPrefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    connection?: any;
+    collectionPrefix?: string | undefined;
+}, {
+    connection?: any;
+    collectionPrefix?: string | undefined;
+}>;
+declare const baseRedisSchema: z.ZodObject<{
+    connection: z.ZodEffects<z.ZodAny, any, any>;
+    keyPrefix: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    connection?: any;
+    keyPrefix?: string | undefined;
+}, {
+    connection?: any;
+    keyPrefix?: string | undefined;
+}>;
+declare function createConfigValidator(configSchema: ZodSchema, ErrorClass?: typeof ConfigValidationError): (raw: unknown) => void;
+
+export { AlxError, type BaseDbConfig, type BaseRedisConfig, ConfigValidationError, type LogAdapter, baseDbSchema, baseRedisSchema, createConfigValidator, loggerSchema };

package/dist/index.js

@@ -0,0 +1,59 @@
+'use strict';
+
+var zod = require('zod');
+
+// src/errors.ts
+var AlxError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = "AlxError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+};
+var ConfigValidationError = class extends AlxError {
+  constructor(message, field) {
+    super(message, "CONFIG_VALIDATION_ERROR");
+    this.field = field;
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = "ConfigValidationError";
+  }
+};
+var loggerSchema = zod.z.object({
+  info: zod.z.function(),
+  warn: zod.z.function(),
+  error: zod.z.function()
+});
+var baseDbSchema = zod.z.object({
+  connection: zod.z.any().refine((val) => val != null, "db.connection is required"),
+  collectionPrefix: zod.z.string().optional()
+});
+var baseRedisSchema = zod.z.object({
+  connection: zod.z.any().refine((val) => val != null, "redis.connection is required"),
+  keyPrefix: zod.z.string().optional()
+});
+function createConfigValidator(configSchema, ErrorClass = ConfigValidationError) {
+  return function validateConfig(raw) {
+    const result = configSchema.safeParse(raw);
+    if (!result.success) {
+      const issues = result.error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`).join("\n");
+      throw new ErrorClass(
+        `Invalid config:
+${issues}`,
+        result.error.issues[0]?.path.join(".") ?? ""
+      );
+    }
+  };
+}
+
+exports.AlxError = AlxError;
+exports.ConfigValidationError = ConfigValidationError;
+exports.baseDbSchema = baseDbSchema;
+exports.baseRedisSchema = baseRedisSchema;
+exports.createConfigValidator = createConfigValidator;
+exports.loggerSchema = loggerSchema;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/validation.ts"],"names":["z"],"mappings":";;;;;AAAO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClC,WAAA,CAAY,SAAiC,IAAA,EAAc;AACzD,IAAA,KAAA,CAAM,OAAO,CAAA;AAD8B,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAE3C,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAChD,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AACZ,IAAA,IAAI,MAAM,iBAAA,EAAmB;AAC3B,MAAA,KAAA,CAAM,iBAAA,CAAkB,IAAA,EAAM,IAAA,CAAK,WAAW,CAAA;AAAA,IAChD;AAAA,EACF;AACF;AAEO,IAAM,qBAAA,GAAN,cAAoC,QAAA,CAAS;AAAA,EAClD,WAAA,CAAY,SAAiC,KAAA,EAAe;AAC1D,IAAA,KAAA,CAAM,SAAS,yBAAyB,CAAA;AADG,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAE3C,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAChD,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AAAA,EACd;AACF;ACdO,IAAM,YAAA,GAAeA,MAAE,MAAA,CAAO;AAAA,EACnC,IAAA,EAAMA,MAAE,QAAA,EAAS;AAAA,EACjB,IAAA,EAAMA,MAAE,QAAA,EAAS;AAAA,EACjB,KAAA,EAAOA,MAAE,QAAA;AACX,CAAC;AAEM,IAAM,YAAA,GAAeA,MAAE,MAAA,CAAO;AAAA,EACnC,UAAA,EAAYA,MAAE,GAAA,EAAI,CAAE,OAAO,CAAC,GAAA,KAAQ,GAAA,IAAO,IAAA,EAAM,2BAA2B,CAAA;AAAA,EAC5E,gBAAA,EAAkBA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAC/B,CAAC;AAEM,IAAM,eAAA,GAAkBA,MAAE,MAAA,CAAO;AAAA,EACtC,UAAA,EAAYA,MAAE,GAAA,EAAI,CAAE,OAAO,CAAC,GAAA,KAAQ,GAAA,IAAO,IAAA,EAAM,8BAA8B,CAAA;AAAA,EAC/E,SAAA,EAAWA,KAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACxB,CAAC;AAEM,SAAS,qBAAA,CACd,YAAA,EACA,UAAA,GAA2C,qBAAA,EACnB;AACxB,EAAA,OAAO,SAAS,eAAe,GAAA,EAAoB;AACjD,IAAA,MAAM,MAAA,GAAS,YAAA,CAAa,SAAA,CAAU,GAAG,CAAA;AACzC,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,MAAM,SAAS,MAAA,CAAO,KAAA,CAAM,OACzB,GAAA,CAAI,CAAC,MAAM,CAAA,EAAA,EAAK,CAAA,CAAE,KAAK,IAAA,CAAK,GAAG,CAAC,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAChD,KAAK,IAAI,CAAA;AACZ,MAAA,MAAM,IAAI,UAAA;AAAA,QACR,CAAA;AAAA,EAAoB,MAAM,CAAA,CAAA;AAAA,QAC1B,MAAA,CAAO,MAAM,MAAA,CAAO,CAAC,GAAG,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA,IAAK;AAAA,OAC5C;AAAA,IACF;AAAA,EACF,CAAA;AACF","file":"index.js","sourcesContent":["export class AlxError extends Error {\n  constructor(message: string, public readonly code: string) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n    this.name = 'AlxError';\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\nexport class ConfigValidationError extends AlxError {\n  constructor(message: string, public readonly field: string) {\n    super(message, 'CONFIG_VALIDATION_ERROR');\n    Object.setPrototypeOf(this, new.target.prototype);\n    this.name = 'ConfigValidationError';\n  }\n}\n","import { z, type ZodSchema } from 'zod';\nimport { ConfigValidationError } from './errors';\n\nexport const loggerSchema = z.object({\n  info: z.function(),\n  warn: z.function(),\n  error: z.function(),\n});\n\nexport const baseDbSchema = z.object({\n  connection: z.any().refine((val) => val != null, 'db.connection is required'),\n  collectionPrefix: z.string().optional(),\n});\n\nexport const baseRedisSchema = z.object({\n  connection: z.any().refine((val) => val != null, 'redis.connection is required'),\n  keyPrefix: z.string().optional(),\n});\n\nexport function createConfigValidator(\n  configSchema: ZodSchema,\n  ErrorClass: typeof ConfigValidationError = ConfigValidationError,\n): (raw: unknown) => void {\n  return function validateConfig(raw: unknown): void {\n    const result = configSchema.safeParse(raw);\n    if (!result.success) {\n      const issues = result.error.issues\n        .map((i) => `  ${i.path.join('.')}: ${i.message}`)\n        .join('\\n');\n      throw new ErrorClass(\n        `Invalid config:\\n${issues}`,\n        result.error.issues[0]?.path.join('.') ?? '',\n      );\n    }\n  };\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,52 @@
+import { z } from 'zod';
+
+// src/errors.ts
+var AlxError = class extends Error {
+  constructor(message, code) {
+    super(message);
+    this.code = code;
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = "AlxError";
+    if (Error.captureStackTrace) {
+      Error.captureStackTrace(this, this.constructor);
+    }
+  }
+};
+var ConfigValidationError = class extends AlxError {
+  constructor(message, field) {
+    super(message, "CONFIG_VALIDATION_ERROR");
+    this.field = field;
+    Object.setPrototypeOf(this, new.target.prototype);
+    this.name = "ConfigValidationError";
+  }
+};
+var loggerSchema = z.object({
+  info: z.function(),
+  warn: z.function(),
+  error: z.function()
+});
+var baseDbSchema = z.object({
+  connection: z.any().refine((val) => val != null, "db.connection is required"),
+  collectionPrefix: z.string().optional()
+});
+var baseRedisSchema = z.object({
+  connection: z.any().refine((val) => val != null, "redis.connection is required"),
+  keyPrefix: z.string().optional()
+});
+function createConfigValidator(configSchema, ErrorClass = ConfigValidationError) {
+  return function validateConfig(raw) {
+    const result = configSchema.safeParse(raw);
+    if (!result.success) {
+      const issues = result.error.issues.map((i) => `  ${i.path.join(".")}: ${i.message}`).join("\n");
+      throw new ErrorClass(
+        `Invalid config:
+${issues}`,
+        result.error.issues[0]?.path.join(".") ?? ""
+      );
+    }
+  };
+}
+
+export { AlxError, ConfigValidationError, baseDbSchema, baseRedisSchema, createConfigValidator, loggerSchema };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/errors.ts","../src/validation.ts"],"names":[],"mappings":";;;AAAO,IAAM,QAAA,GAAN,cAAuB,KAAA,CAAM;AAAA,EAClC,WAAA,CAAY,SAAiC,IAAA,EAAc;AACzD,IAAA,KAAA,CAAM,OAAO,CAAA;AAD8B,IAAA,IAAA,CAAA,IAAA,GAAA,IAAA;AAE3C,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAChD,IAAA,IAAA,CAAK,IAAA,GAAO,UAAA;AACZ,IAAA,IAAI,MAAM,iBAAA,EAAmB;AAC3B,MAAA,KAAA,CAAM,iBAAA,CAAkB,IAAA,EAAM,IAAA,CAAK,WAAW,CAAA;AAAA,IAChD;AAAA,EACF;AACF;AAEO,IAAM,qBAAA,GAAN,cAAoC,QAAA,CAAS;AAAA,EAClD,WAAA,CAAY,SAAiC,KAAA,EAAe;AAC1D,IAAA,KAAA,CAAM,SAAS,yBAAyB,CAAA;AADG,IAAA,IAAA,CAAA,KAAA,GAAA,KAAA;AAE3C,IAAA,MAAA,CAAO,cAAA,CAAe,IAAA,EAAM,GAAA,CAAA,MAAA,CAAW,SAAS,CAAA;AAChD,IAAA,IAAA,CAAK,IAAA,GAAO,uBAAA;AAAA,EACd;AACF;ACdO,IAAM,YAAA,GAAe,EAAE,MAAA,CAAO;AAAA,EACnC,IAAA,EAAM,EAAE,QAAA,EAAS;AAAA,EACjB,IAAA,EAAM,EAAE,QAAA,EAAS;AAAA,EACjB,KAAA,EAAO,EAAE,QAAA;AACX,CAAC;AAEM,IAAM,YAAA,GAAe,EAAE,MAAA,CAAO;AAAA,EACnC,UAAA,EAAY,EAAE,GAAA,EAAI,CAAE,OAAO,CAAC,GAAA,KAAQ,GAAA,IAAO,IAAA,EAAM,2BAA2B,CAAA;AAAA,EAC5E,gBAAA,EAAkB,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AAC/B,CAAC;AAEM,IAAM,eAAA,GAAkB,EAAE,MAAA,CAAO;AAAA,EACtC,UAAA,EAAY,EAAE,GAAA,EAAI,CAAE,OAAO,CAAC,GAAA,KAAQ,GAAA,IAAO,IAAA,EAAM,8BAA8B,CAAA;AAAA,EAC/E,SAAA,EAAW,CAAA,CAAE,MAAA,EAAO,CAAE,QAAA;AACxB,CAAC;AAEM,SAAS,qBAAA,CACd,YAAA,EACA,UAAA,GAA2C,qBAAA,EACnB;AACxB,EAAA,OAAO,SAAS,eAAe,GAAA,EAAoB;AACjD,IAAA,MAAM,MAAA,GAAS,YAAA,CAAa,SAAA,CAAU,GAAG,CAAA;AACzC,IAAA,IAAI,CAAC,OAAO,OAAA,EAAS;AACnB,MAAA,MAAM,SAAS,MAAA,CAAO,KAAA,CAAM,OACzB,GAAA,CAAI,CAAC,MAAM,CAAA,EAAA,EAAK,CAAA,CAAE,KAAK,IAAA,CAAK,GAAG,CAAC,CAAA,EAAA,EAAK,CAAA,CAAE,OAAO,CAAA,CAAE,CAAA,CAChD,KAAK,IAAI,CAAA;AACZ,MAAA,MAAM,IAAI,UAAA;AAAA,QACR,CAAA;AAAA,EAAoB,MAAM,CAAA,CAAA;AAAA,QAC1B,MAAA,CAAO,MAAM,MAAA,CAAO,CAAC,GAAG,IAAA,CAAK,IAAA,CAAK,GAAG,CAAA,IAAK;AAAA,OAC5C;AAAA,IACF;AAAA,EACF,CAAA;AACF","file":"index.mjs","sourcesContent":["export class AlxError extends Error {\n  constructor(message: string, public readonly code: string) {\n    super(message);\n    Object.setPrototypeOf(this, new.target.prototype);\n    this.name = 'AlxError';\n    if (Error.captureStackTrace) {\n      Error.captureStackTrace(this, this.constructor);\n    }\n  }\n}\n\nexport class ConfigValidationError extends AlxError {\n  constructor(message: string, public readonly field: string) {\n    super(message, 'CONFIG_VALIDATION_ERROR');\n    Object.setPrototypeOf(this, new.target.prototype);\n    this.name = 'ConfigValidationError';\n  }\n}\n","import { z, type ZodSchema } from 'zod';\nimport { ConfigValidationError } from './errors';\n\nexport const loggerSchema = z.object({\n  info: z.function(),\n  warn: z.function(),\n  error: z.function(),\n});\n\nexport const baseDbSchema = z.object({\n  connection: z.any().refine((val) => val != null, 'db.connection is required'),\n  collectionPrefix: z.string().optional(),\n});\n\nexport const baseRedisSchema = z.object({\n  connection: z.any().refine((val) => val != null, 'redis.connection is required'),\n  keyPrefix: z.string().optional(),\n});\n\nexport function createConfigValidator(\n  configSchema: ZodSchema,\n  ErrorClass: typeof ConfigValidationError = ConfigValidationError,\n): (raw: unknown) => void {\n  return function validateConfig(raw: unknown): void {\n    const result = configSchema.safeParse(raw);\n    if (!result.success) {\n      const issues = result.error.issues\n        .map((i) => `  ${i.path.join('.')}: ${i.message}`)\n        .join('\\n');\n      throw new ErrorClass(\n        `Invalid config:\\n${issues}`,\n        result.error.issues[0]?.path.join('.') ?? '',\n      );\n    }\n  };\n}\n"]}

package/package.json

@@ -0,0 +1,43 @@
+{
+  "name": "@astralibx/core",
+  "version": "1.1.0",
+  "description": "Shared foundation for all @astralibx packages — base errors, types, and validation helpers",
+  "main": "dist/index.cjs",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.cjs"
+      }
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "lint": "eslint src/",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "astralibx",
+    "core",
+    "errors",
+    "validation",
+    "zod"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "zod": "^3.23.0"
+  }
+}