@s-hirano-ist/s-core 1.1.6 → 1.3.0

package/dist/common/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../common/index.ts"],"names":[],"mappings":"AACA,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAGH,cAAc,0BAA0B,CAAC;AAGzC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAG9C,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAGxC,cAAc,sBAAsB,CAAC"}

package/dist/common/index.js

@@ -1,3 +1,26 @@
+/**
+ * @packageDocumentation
+ *
+ * Common utilities shared across all domains.
+ *
+ * @remarks
+ * Provides foundational building blocks including:
+ *
+ * - **Entities** - Common value objects (Id, UserId, CreatedAt, Status)
+ * - **Events** - Domain event infrastructure (BaseDomainEvent, SystemEvents)
+ * - **Services** - Shared services (ID generation, entity factory)
+ * - **Types** - Common type definitions
+ *
+ * @example
+ * ```typescript
+ * import { makeId, makeUserId, makeCreatedAt, UnexportedStatus } from "@repo/core/common";
+ *
+ * const id = makeId();
+ * const userId = makeUserId("user-123");
+ * const createdAt = makeCreatedAt();
+ * const status = UnexportedStatus;
+ * ```
+ */
 // Entities
 export * from "./entities/common-entity";
 // Events

package/dist/common/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../common/index.ts"],"names":[],"mappings":"AAAA,WAAW;AACX,cAAc,0BAA0B,CAAC;AAEzC,SAAS;AACT,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAE9C,WAAW;AACX,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAExC,QAAQ;AACR,cAAc,sBAAsB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../common/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,WAAW;AACX,cAAc,0BAA0B,CAAC;AAEzC,SAAS;AACT,cAAc,4BAA4B,CAAC;AAC3C,cAAc,iCAAiC,CAAC;AAChD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,+BAA+B,CAAC;AAE9C,WAAW;AACX,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AAExC,QAAQ;AACR,cAAc,sBAAsB,CAAC"}

package/dist/common/services/entity-factory.d.ts

@@ -1,2 +1,29 @@
+/**
+ * Wraps entity creation with standardized error handling.
+ *
+ * @remarks
+ * This utility function provides consistent error handling across all entity factories.
+ * It catches Zod validation errors and converts them to domain-specific error types.
+ *
+ * @typeParam T - The type of entity being created
+ * @param factory - A function that creates the entity
+ * @returns The created entity
+ * @throws {InvalidFormatError} When Zod validation fails
+ * @throws {UnexpectedError} For any other unexpected errors
+ *
+ * @example
+ * ```typescript
+ * const article = createEntityWithErrorHandling(() =>
+ *   Object.freeze({
+ *     id: makeId(),
+ *     title: makeArticleTitle(rawTitle),
+ *     // ... other fields
+ *   })
+ * );
+ * ```
+ *
+ * @see {@link InvalidFormatError} for validation error handling
+ * @see {@link UnexpectedError} for unexpected error handling
+ */
 export declare const createEntityWithErrorHandling: <T>(factory: () => T) => T;
 //# sourceMappingURL=entity-factory.d.ts.map

package/dist/common/services/entity-factory.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"entity-factory.d.ts","sourceRoot":"","sources":["../../../common/services/entity-factory.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,6BAA6B,GAAI,CAAC,EAAE,SAAS,MAAM,CAAC,KAAG,CAOnE,CAAC"}
+{"version":3,"file":"entity-factory.d.ts","sourceRoot":"","sources":["../../../common/services/entity-factory.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,6BAA6B,GAAI,CAAC,EAAE,SAAS,MAAM,CAAC,KAAG,CAOnE,CAAC"}

package/dist/common/services/entity-factory.js

@@ -1,5 +1,32 @@
 import { ZodError } from "zod";
 import { InvalidFormatError, UnexpectedError, } from "../../errors/error-classes";
+/**
+ * Wraps entity creation with standardized error handling.
+ *
+ * @remarks
+ * This utility function provides consistent error handling across all entity factories.
+ * It catches Zod validation errors and converts them to domain-specific error types.
+ *
+ * @typeParam T - The type of entity being created
+ * @param factory - A function that creates the entity
+ * @returns The created entity
+ * @throws {InvalidFormatError} When Zod validation fails
+ * @throws {UnexpectedError} For any other unexpected errors
+ *
+ * @example
+ * ```typescript
+ * const article = createEntityWithErrorHandling(() =>
+ *   Object.freeze({
+ *     id: makeId(),
+ *     title: makeArticleTitle(rawTitle),
+ *     // ... other fields
+ *   })
+ * );
+ * ```
+ *
+ * @see {@link InvalidFormatError} for validation error handling
+ * @see {@link UnexpectedError} for unexpected error handling
+ */
 export const createEntityWithErrorHandling = (factory) => {
     try {
         return factory();

package/dist/common/services/entity-factory.js.map

@@ -1 +1 @@
-{"version":3,"file":"entity-factory.js","sourceRoot":"","sources":["../../../common/services/entity-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EACN,kBAAkB,EAClB,eAAe,GACf,MAAM,4BAA4B,CAAC;AAEpC,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAI,OAAgB,EAAK,EAAE;IACvE,IAAI,CAAC;QACJ,OAAO,OAAO,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,QAAQ;YAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;QAC9D,MAAM,IAAI,eAAe,EAAE,CAAC;IAC7B,CAAC;AACF,CAAC,CAAC"}
+{"version":3,"file":"entity-factory.js","sourceRoot":"","sources":["../../../common/services/entity-factory.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAC/B,OAAO,EACN,kBAAkB,EAClB,eAAe,GACf,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAAG,CAAI,OAAgB,EAAK,EAAE;IACvE,IAAI,CAAC;QACJ,OAAO,OAAO,EAAE,CAAC;IAClB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QAChB,IAAI,KAAK,YAAY,QAAQ;YAAE,MAAM,IAAI,kBAAkB,EAAE,CAAC;QAC9D,MAAM,IAAI,eAAe,EAAE,CAAC;IAC7B,CAAC;AACF,CAAC,CAAC"}

package/dist/common/services/id-generator.d.ts

@@ -1,4 +1,36 @@
+/**
+ * Generates a new UUIDv7 identifier.
+ *
+ * @remarks
+ * UUIDv7 is a time-ordered UUID that provides both uniqueness and sortability.
+ * The timestamp is embedded in the first 48 bits, making it suitable for
+ * database primary keys where insertion order matters.
+ *
+ * @returns A new UUIDv7 string
+ *
+ * @example
+ * ```typescript
+ * const id = uuidv7();
+ * // "01912c9a-5e8a-7b5c-8a1b-2c3d4e5f6a7b"
+ * ```
+ *
+ * @see {@link https://www.rfc-editor.org/rfc/rfc9562#section-5.7 | RFC 9562 - UUIDv7}
+ */
 export declare const uuidv7: () => string;
+/**
+ * ID generator service for creating unique identifiers.
+ *
+ * @remarks
+ * Provides a centralized service for generating identifiers.
+ * Currently only supports UUIDv7.
+ *
+ * @example
+ * ```typescript
+ * import { idGenerator } from "@s-hirano-ist/s-core";
+ *
+ * const id = idGenerator.uuidv7();
+ * ```
+ */
 export declare const idGenerator: {
     uuidv7: () => string;
 };

package/dist/common/services/id-generator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../common/services/id-generator.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,MAAM,QAAO,MAAc,CAAC;AAEzC,eAAO,MAAM,WAAW;kBAFE,MAAM;CAEK,CAAC"}
+{"version":3,"file":"id-generator.d.ts","sourceRoot":"","sources":["../../../common/services/id-generator.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,MAAM,QAAO,MAAc,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,eAAO,MAAM,WAAW;kBAhBE,MAAM;CAgBK,CAAC"}

package/dist/common/services/id-generator.js

@@ -1,4 +1,36 @@
 import { v7 } from "uuid";
+/**
+ * Generates a new UUIDv7 identifier.
+ *
+ * @remarks
+ * UUIDv7 is a time-ordered UUID that provides both uniqueness and sortability.
+ * The timestamp is embedded in the first 48 bits, making it suitable for
+ * database primary keys where insertion order matters.
+ *
+ * @returns A new UUIDv7 string
+ *
+ * @example
+ * ```typescript
+ * const id = uuidv7();
+ * // "01912c9a-5e8a-7b5c-8a1b-2c3d4e5f6a7b"
+ * ```
+ *
+ * @see {@link https://www.rfc-editor.org/rfc/rfc9562#section-5.7 | RFC 9562 - UUIDv7}
+ */
 export const uuidv7 = () => v7();
+/**
+ * ID generator service for creating unique identifiers.
+ *
+ * @remarks
+ * Provides a centralized service for generating identifiers.
+ * Currently only supports UUIDv7.
+ *
+ * @example
+ * ```typescript
+ * import { idGenerator } from "@s-hirano-ist/s-core";
+ *
+ * const id = idGenerator.uuidv7();
+ * ```
+ */
 export const idGenerator = { uuidv7 };
 //# sourceMappingURL=id-generator.js.map

package/dist/common/services/id-generator.js.map

@@ -1 +1 @@
-{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../../common/services/id-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B,MAAM,CAAC,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,EAAE,EAAE,CAAC;AAEzC,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"id-generator.js","sourceRoot":"","sources":["../../../common/services/id-generator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,EAAE,EAAE,MAAM,MAAM,CAAC;AAE1B;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,GAAW,EAAE,CAAC,EAAE,EAAE,CAAC;AAEzC;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,EAAE,MAAM,EAAE,CAAC"}

package/dist/errors/error-classes.d.ts

@@ -1,15 +1,95 @@
-export declare class PushoverError extends Error {
-    constructor();
-}
+/**
+ * Error thrown when an unexpected error occurs.
+ *
+ * @remarks
+ * Used as a catch-all for errors that shouldn't happen under normal conditions.
+ * The message "unexpected" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   // Some operation that should never fail
+ * } catch (error) {
+ *   throw new UnexpectedError();
+ * }
+ * ```
+ *
+ * @see {@link InvalidFormatError} for validation errors
+ * @see {@link DuplicateError} for uniqueness constraint violations
+ */
 export declare class UnexpectedError extends Error {
     constructor();
 }
+/**
+ * Error thrown when input validation fails.
+ *
+ * @remarks
+ * Used by domain entities when Zod validation fails.
+ * The message "invalidFormat" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * // In entity factory
+ * try {
+ *   return ArticleTitle.parse(value);
+ * } catch (zodError) {
+ *   throw new InvalidFormatError();
+ * }
+ * ```
+ *
+ * @see {@link UnexpectedError} for unexpected errors
+ * @see {@link DuplicateError} for uniqueness constraint violations
+ */
 export declare class InvalidFormatError extends Error {
     constructor();
 }
+/**
+ * Error thrown when a duplicate entity is detected.
+ *
+ * @remarks
+ * Used by domain services to enforce uniqueness constraints.
+ * The message "duplicate" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * // In domain service
+ * if (await repository.exists(key)) {
+ *   throw new DuplicateError();
+ * }
+ *
+ * // In application service
+ * try {
+ *   await domainService.ensureNoDuplicate(key, userId);
+ * } catch (error) {
+ *   if (error instanceof DuplicateError) {
+ *     return { success: false, message: t("errors.duplicate") };
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link InvalidFormatError} for validation errors
+ * @see {@link UnexpectedError} for unexpected errors
+ */
 export declare class DuplicateError extends Error {
     constructor();
 }
+/**
+ * Error thrown when a file type is not allowed.
+ *
+ * @remarks
+ * Used by the images domain when an unsupported file format is uploaded.
+ * The message "invalidFileFormat" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * const allowedTypes = ["image/jpeg", "image/png", "image/webp"];
+ * if (!allowedTypes.includes(file.type)) {
+ *   throw new FileNotAllowedError();
+ * }
+ * ```
+ *
+ * @see {@link InvalidFormatError} for general validation errors
+ */
 export declare class FileNotAllowedError extends Error {
     constructor();
 }

package/dist/errors/error-classes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"error-classes.d.ts","sourceRoot":"","sources":["../../errors/error-classes.ts"],"names":[],"mappings":"AAAA,qBAAa,aAAc,SAAQ,KAAK;;CAKvC;AAED,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED,qBAAa,cAAe,SAAQ,KAAK;;CAKxC;AAED,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C"}
+{"version":3,"file":"error-classes.d.ts","sourceRoot":"","sources":["../../errors/error-classes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,eAAgB,SAAQ,KAAK;;CAKzC;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;;CAK5C;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,qBAAa,cAAe,SAAQ,KAAK;;CAKxC;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;;CAK7C"}

package/dist/errors/error-classes.js

@@ -1,27 +1,104 @@
-export class PushoverError extends Error {
-    constructor() {
-        super("pushoverSend");
-        this.name = "PushoverError";
-    }
-}
+/**
+ * Error thrown when an unexpected error occurs.
+ *
+ * @remarks
+ * Used as a catch-all for errors that shouldn't happen under normal conditions.
+ * The message "unexpected" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * try {
+ *   // Some operation that should never fail
+ * } catch (error) {
+ *   throw new UnexpectedError();
+ * }
+ * ```
+ *
+ * @see {@link InvalidFormatError} for validation errors
+ * @see {@link DuplicateError} for uniqueness constraint violations
+ */
 export class UnexpectedError extends Error {
     constructor() {
         super("unexpected");
         this.name = "UnexpectedError";
     }
 }
+/**
+ * Error thrown when input validation fails.
+ *
+ * @remarks
+ * Used by domain entities when Zod validation fails.
+ * The message "invalidFormat" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * // In entity factory
+ * try {
+ *   return ArticleTitle.parse(value);
+ * } catch (zodError) {
+ *   throw new InvalidFormatError();
+ * }
+ * ```
+ *
+ * @see {@link UnexpectedError} for unexpected errors
+ * @see {@link DuplicateError} for uniqueness constraint violations
+ */
 export class InvalidFormatError extends Error {
     constructor() {
         super("invalidFormat");
         this.name = "InvalidFormatError";
     }
 }
+/**
+ * Error thrown when a duplicate entity is detected.
+ *
+ * @remarks
+ * Used by domain services to enforce uniqueness constraints.
+ * The message "duplicate" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * // In domain service
+ * if (await repository.exists(key)) {
+ *   throw new DuplicateError();
+ * }
+ *
+ * // In application service
+ * try {
+ *   await domainService.ensureNoDuplicate(key, userId);
+ * } catch (error) {
+ *   if (error instanceof DuplicateError) {
+ *     return { success: false, message: t("errors.duplicate") };
+ *   }
+ * }
+ * ```
+ *
+ * @see {@link InvalidFormatError} for validation errors
+ * @see {@link UnexpectedError} for unexpected errors
+ */
 export class DuplicateError extends Error {
     constructor() {
         super("duplicate");
         this.name = "DuplicateError";
     }
 }
+/**
+ * Error thrown when a file type is not allowed.
+ *
+ * @remarks
+ * Used by the images domain when an unsupported file format is uploaded.
+ * The message "invalidFileFormat" can be used for i18n lookups.
+ *
+ * @example
+ * ```typescript
+ * const allowedTypes = ["image/jpeg", "image/png", "image/webp"];
+ * if (!allowedTypes.includes(file.type)) {
+ *   throw new FileNotAllowedError();
+ * }
+ * ```
+ *
+ * @see {@link InvalidFormatError} for general validation errors
+ */
 export class FileNotAllowedError extends Error {
     constructor() {
         super("invalidFileFormat");

package/dist/errors/error-classes.js.map

@@ -1 +1 @@
-{"version":3,"file":"error-classes.js","sourceRoot":"","sources":["../../errors/error-classes.ts"],"names":[],"mappings":"AAAA,MAAM,OAAO,aAAc,SAAQ,KAAK;IACvC;QACC,KAAK,CAAC,cAAc,CAAC,CAAC;QACtB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;IAC7B,CAAC;CACD;AAED,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC;QACC,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C;QACC,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED,MAAM,OAAO,cAAe,SAAQ,KAAK;IACxC;QACC,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C;QACC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD"}
+{"version":3,"file":"error-classes.js","sourceRoot":"","sources":["../../errors/error-classes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,OAAO,eAAgB,SAAQ,KAAK;IACzC;QACC,KAAK,CAAC,YAAY,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAC/B,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,OAAO,kBAAmB,SAAQ,KAAK;IAC5C;QACC,KAAK,CAAC,eAAe,CAAC,CAAC;QACvB,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;IAClC,CAAC;CACD;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,OAAO,cAAe,SAAQ,KAAK;IACxC;QACC,KAAK,CAAC,WAAW,CAAC,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,gBAAgB,CAAC;IAC9B,CAAC;CACD;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,OAAO,mBAAoB,SAAQ,KAAK;IAC7C;QACC,KAAK,CAAC,mBAAmB,CAAC,CAAC;QAC3B,IAAI,CAAC,IAAI,GAAG,qBAAqB,CAAC;IACnC,CAAC;CACD"}

package/dist/errors/index.d.ts

@@ -1,2 +1,31 @@
+/**
+ * @packageDocumentation
+ *
+ * Domain-specific error classes for error handling.
+ *
+ * @remarks
+ * Provides typed error classes for common domain scenarios:
+ *
+ * - **UnexpectedError** - For unexpected runtime errors
+ * - **InvalidFormatError** - For validation failures
+ * - **DuplicateError** - For uniqueness constraint violations
+ * - **FileNotAllowedError** - For forbidden file types
+ *
+ * All error classes extend the base Error class and include
+ * descriptive messages for logging and user feedback.
+ *
+ * @example
+ * ```typescript
+ * import { DuplicateError, InvalidFormatError } from "@repo/core/errors";
+ *
+ * if (exists) {
+ *   throw new DuplicateError("Article already exists");
+ * }
+ *
+ * if (!isValid) {
+ *   throw new InvalidFormatError("Invalid ISBN format");
+ * }
+ * ```
+ */
 export * from "./error-classes";
 //# sourceMappingURL=index.d.ts.map

package/dist/errors/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AACA,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAGH,cAAc,iBAAiB,CAAC"}

package/dist/errors/index.js

@@ -1,3 +1,32 @@
+/**
+ * @packageDocumentation
+ *
+ * Domain-specific error classes for error handling.
+ *
+ * @remarks
+ * Provides typed error classes for common domain scenarios:
+ *
+ * - **UnexpectedError** - For unexpected runtime errors
+ * - **InvalidFormatError** - For validation failures
+ * - **DuplicateError** - For uniqueness constraint violations
+ * - **FileNotAllowedError** - For forbidden file types
+ *
+ * All error classes extend the base Error class and include
+ * descriptive messages for logging and user feedback.
+ *
+ * @example
+ * ```typescript
+ * import { DuplicateError, InvalidFormatError } from "@repo/core/errors";
+ *
+ * if (exists) {
+ *   throw new DuplicateError("Article already exists");
+ * }
+ *
+ * if (!isValid) {
+ *   throw new InvalidFormatError("Invalid ISBN format");
+ * }
+ * ```
+ */
 // Error classes
 export * from "./error-classes";
 //# sourceMappingURL=index.js.map

package/dist/errors/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA,gBAAgB;AAChB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../errors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,gBAAgB;AAChB,cAAc,iBAAiB,CAAC"}