promidas 2.0.0

package/dist/repository/utils/convert-fetch-result.d.ts

@@ -0,0 +1,46 @@
+import type { FetchPrototypesResult, FetchPrototypesSuccess } from '../../fetcher/types/result.types.js';
+import type { SnapshotOperationResult } from '../types/snapshot-operation.types.js';
+/**
+ * Convert FetchPrototypesResult to SnapshotOperationResult.
+ *
+ * For success cases, returns the result as-is (type-compatible).
+ * For failure cases, preserves all error information (origin, kind, code, message, status, details)
+ * from the fetcher layer for use in the repository layer.
+ *
+ * @param result - Fetch result to convert
+ * @returns Snapshot operation result (success pass-through or converted failure)
+ *
+ * @example
+ * ```typescript
+ * // Success case - pass through
+ * const fetchSuccess: FetchPrototypesSuccess = {
+ *   ok: true,
+ *   data: [{ id: 1, ... }]
+ * };
+ * const snapshotResult = convertFetchResult(fetchSuccess);
+ * // { ok: true, data: [{ id: 1, ... }] } - same object
+ *
+ * // Failure case - convert
+ * const fetchFailure: FetchPrototypesFailure = {
+ *   ok: false,
+ *   origin: 'fetcher',
+ *   kind: 'http',
+ *   error: 'Not Found',
+ *   code: 'CLIENT_NOT_FOUND',
+ *   status: 404,
+ *   details: { res: { code: 'RESOURCE_NOT_FOUND' } }
+ * };
+ * const snapshotFailure = convertFetchResult(fetchFailure);
+ * // {
+ * //   ok: false,
+ * //   origin: 'fetcher',
+ * //   kind: 'http',
+ * //   code: 'CLIENT_NOT_FOUND',
+ * //   message: 'Not Found',
+ * //   status: 404,
+ * //   details: { res: { code: 'RESOURCE_NOT_FOUND' } }
+ * // }
+ * ```
+ */
+export declare function convertFetchResult(result: FetchPrototypesResult): SnapshotOperationResult | FetchPrototypesSuccess;
+//# sourceMappingURL=convert-fetch-result.d.ts.map

package/dist/repository/utils/convert-fetch-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-fetch-result.d.ts","sourceRoot":"","sources":["../../../lib/repository/utils/convert-fetch-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,qBAAqB,EACrB,sBAAsB,EACvB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAEV,uBAAuB,EACxB,MAAM,sCAAsC,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,kBAAkB,CAChC,MAAM,EAAE,qBAAqB,GAC5B,uBAAuB,GAAG,sBAAsB,CAgBlD"}

package/dist/repository/utils/convert-fetch-result.js

@@ -0,0 +1,59 @@
+/**
+ * Convert FetchPrototypesResult to SnapshotOperationResult.
+ *
+ * For success cases, returns the result as-is (type-compatible).
+ * For failure cases, preserves all error information (origin, kind, code, message, status, details)
+ * from the fetcher layer for use in the repository layer.
+ *
+ * @param result - Fetch result to convert
+ * @returns Snapshot operation result (success pass-through or converted failure)
+ *
+ * @example
+ * ```typescript
+ * // Success case - pass through
+ * const fetchSuccess: FetchPrototypesSuccess = {
+ *   ok: true,
+ *   data: [{ id: 1, ... }]
+ * };
+ * const snapshotResult = convertFetchResult(fetchSuccess);
+ * // { ok: true, data: [{ id: 1, ... }] } - same object
+ *
+ * // Failure case - convert
+ * const fetchFailure: FetchPrototypesFailure = {
+ *   ok: false,
+ *   origin: 'fetcher',
+ *   kind: 'http',
+ *   error: 'Not Found',
+ *   code: 'CLIENT_NOT_FOUND',
+ *   status: 404,
+ *   details: { res: { code: 'RESOURCE_NOT_FOUND' } }
+ * };
+ * const snapshotFailure = convertFetchResult(fetchFailure);
+ * // {
+ * //   ok: false,
+ * //   origin: 'fetcher',
+ * //   kind: 'http',
+ * //   code: 'CLIENT_NOT_FOUND',
+ * //   message: 'Not Found',
+ * //   status: 404,
+ * //   details: { res: { code: 'RESOURCE_NOT_FOUND' } }
+ * // }
+ * ```
+ */
+export function convertFetchResult(result) {
+    if (result.ok) {
+        // Success case: pass through as-is for caller to access data field
+        return result;
+    }
+    const failure = {
+        ok: false,
+        origin: 'fetcher',
+        kind: result.kind,
+        code: result.code,
+        message: result.error,
+        ...(result.status !== undefined && { status: result.status }),
+        details: result.details,
+    };
+    return failure;
+}
+//# sourceMappingURL=convert-fetch-result.js.map

package/dist/repository/utils/convert-fetch-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-fetch-result.js","sourceRoot":"","sources":["../../../lib/repository/utils/convert-fetch-result.ts"],"names":[],"mappings":"AASA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,MAAM,UAAU,kBAAkB,CAChC,MAA6B;IAE7B,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,mEAAmE;QACnE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,OAAO,GAA2B;QACtC,EAAE,EAAE,KAAK;QACT,MAAM,EAAE,SAAS;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,OAAO,EAAE,MAAM,CAAC,KAAK;QACrB,GAAG,CAAC,MAAM,CAAC,MAAM,KAAK,SAAS,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC;QAC7D,OAAO,EAAE,MAAM,CAAC,OAAO;KACxB,CAAC;IACF,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/repository/utils/convert-store-result.d.ts

@@ -0,0 +1,36 @@
+import type { SetResult } from '../../store/types/result.types.js';
+import type { SnapshotOperationResult } from '../types/snapshot-operation.types.js';
+/**
+ * Convert SetResult to SnapshotOperationResult.
+ *
+ * SetResult and SnapshotOperationResult are type-compatible,
+ * so this function simply returns the input result without transformation.
+ *
+ * @param result - Store operation result to convert
+ * @returns Snapshot operation result (same as input)
+ *
+ * @example
+ * ```typescript
+ * // Success case
+ * const storeSuccess: SetResult = {
+ *   ok: true,
+ *   stats: { size: 100, cachedAt: new Date(), ... }
+ * };
+ * const snapshotResult = convertStoreResult(storeSuccess);
+ * // { ok: true, stats: { size: 100, cachedAt: ..., ... } } - same object
+ *
+ * // Failure case
+ * const storeFailure: SetResult = {
+ *   ok: false,
+ *   origin: 'store',
+ *   kind: 'storage_limit',
+ *   code: 'STORE_CAPACITY_EXCEEDED',
+ *   message: 'Data size exceeds limit',
+ *   dataState: 'UNCHANGED'
+ * };
+ * const snapshotFailure = convertStoreResult(storeFailure);
+ * // { ok: false, origin: 'store', kind: 'storage_limit', ... } - same object
+ * ```
+ */
+export declare function convertStoreResult(result: SetResult): SnapshotOperationResult;
+//# sourceMappingURL=convert-store-result.d.ts.map

package/dist/repository/utils/convert-store-result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-store-result.d.ts","sourceRoot":"","sources":["../../../lib/repository/utils/convert-store-result.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,mCAAmC,CAAC;AACnE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,sCAAsC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,uBAAuB,CAE7E"}

package/dist/repository/utils/convert-store-result.js

@@ -0,0 +1,36 @@
+/**
+ * Convert SetResult to SnapshotOperationResult.
+ *
+ * SetResult and SnapshotOperationResult are type-compatible,
+ * so this function simply returns the input result without transformation.
+ *
+ * @param result - Store operation result to convert
+ * @returns Snapshot operation result (same as input)
+ *
+ * @example
+ * ```typescript
+ * // Success case
+ * const storeSuccess: SetResult = {
+ *   ok: true,
+ *   stats: { size: 100, cachedAt: new Date(), ... }
+ * };
+ * const snapshotResult = convertStoreResult(storeSuccess);
+ * // { ok: true, stats: { size: 100, cachedAt: ..., ... } } - same object
+ *
+ * // Failure case
+ * const storeFailure: SetResult = {
+ *   ok: false,
+ *   origin: 'store',
+ *   kind: 'storage_limit',
+ *   code: 'STORE_CAPACITY_EXCEEDED',
+ *   message: 'Data size exceeds limit',
+ *   dataState: 'UNCHANGED'
+ * };
+ * const snapshotFailure = convertStoreResult(storeFailure);
+ * // { ok: false, origin: 'store', kind: 'storage_limit', ... } - same object
+ * ```
+ */
+export function convertStoreResult(result) {
+    return result;
+}
+//# sourceMappingURL=convert-store-result.js.map

package/dist/repository/utils/convert-store-result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"convert-store-result.js","sourceRoot":"","sources":["../../../lib/repository/utils/convert-store-result.ts"],"names":[],"mappings":"AAGA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA+BG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAiB;IAClD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/repository/utils/emit-repository-event-safely.d.ts

@@ -0,0 +1,5 @@
+import type { EventEmitter } from 'events';
+import type { Logger } from '../../logger/index.js';
+import type { RepositoryEvents } from '../types/index.js';
+export declare const emitRepositoryEventSafely: <EventName extends keyof RepositoryEvents>(events: EventEmitter | undefined, logger: Logger, eventName: EventName, ...args: Parameters<RepositoryEvents[EventName]>) => void;
+//# sourceMappingURL=emit-repository-event-safely.d.ts.map

package/dist/repository/utils/emit-repository-event-safely.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-repository-event-safely.d.ts","sourceRoot":"","sources":["../../../lib/repository/utils/emit-repository-event-safely.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,QAAQ,CAAC;AAE3C,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAEpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,eAAO,MAAM,yBAAyB,GACpC,SAAS,SAAS,MAAM,gBAAgB,EAExC,QAAQ,YAAY,GAAG,SAAS,EAChC,QAAQ,MAAM,EACd,WAAW,SAAS,EACpB,GAAG,MAAM,UAAU,CAAC,gBAAgB,CAAC,SAAS,CAAC,CAAC,KAC/C,IAcF,CAAC"}

package/dist/repository/utils/emit-repository-event-safely.js

@@ -0,0 +1,17 @@
+import { sanitizeDataForLogging } from '../../utils/logger-utils.js';
+export const emitRepositoryEventSafely = (events, logger, eventName, ...args) => {
+    if (!events) {
+        return;
+    }
+    try {
+        events.emit(eventName, ...args);
+    }
+    catch (error) {
+        logger.error('Repository event emission failed', {
+            eventName,
+            error: sanitizeDataForLogging(error),
+            args: sanitizeDataForLogging(args),
+        });
+    }
+};
+//# sourceMappingURL=emit-repository-event-safely.js.map

package/dist/repository/utils/emit-repository-event-safely.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"emit-repository-event-safely.js","sourceRoot":"","sources":["../../../lib/repository/utils/emit-repository-event-safely.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,sBAAsB,EAAE,MAAM,6BAA6B,CAAC;AAGrE,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAGvC,MAAgC,EAChC,MAAc,EACd,SAAoB,EACpB,GAAG,IAA6C,EAC1C,EAAE;IACR,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,IAAI,CAAC,CAAC;IAClC,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,CAAC,KAAK,CAAC,kCAAkC,EAAE;YAC/C,SAAS;YACT,KAAK,EAAE,sBAAsB,CAAC,KAAK,CAAC;YACpC,IAAI,EAAE,sBAAsB,CAAC,IAAI,CAAC;SACnC,CAAC,CAAC;IACL,CAAC;AACH,CAAC,CAAC"}

package/dist/repository/utils/index.d.ts

@@ -0,0 +1,3 @@
+export { convertFetchResult } from './convert-fetch-result.js';
+export { convertStoreResult } from './convert-store-result.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/repository/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/repository/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/repository/utils/index.js

@@ -0,0 +1,3 @@
+export { convertFetchResult } from './convert-fetch-result.js';
+export { convertStoreResult } from './convert-store-result.js';
+//# sourceMappingURL=index.js.map

package/dist/repository/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/repository/utils/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/repository/validation/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Validation utilities for repository operations.
+ *
+ * This module provides validation functions and schemas for repository data
+ * and method parameters.
+ */
+export { RepositoryParamsValidator } from './params-validators.js';
+export { validateSerializableSnapshot } from './serializable-snapshot.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/repository/validation/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/repository/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/repository/validation/index.js

@@ -0,0 +1,10 @@
+/**
+ * Validation utilities for repository operations.
+ *
+ * This module provides validation functions and schemas for repository data
+ * and method parameters.
+ */
+// Validators
+export { RepositoryParamsValidator } from './params-validators.js';
+export { validateSerializableSnapshot } from './serializable-snapshot.js';
+//# sourceMappingURL=index.js.map

package/dist/repository/validation/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/repository/validation/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,aAAa;AACb,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC"}

package/dist/repository/validation/params-validators.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Validator class for repository operations.
+ *
+ * Provides centralized static validation methods for method parameters.
+ * All methods throw {@link ValidationError} on invalid input.
+ *
+ * @remarks
+ * This class separates validation concerns from business logic in
+ * ProtopediaInMemoryRepositoryImpl, improving testability and maintainability.
+ * All methods are static and stateless.
+ *
+ * For snapshot validation, use {@link validateSerializableSnapshot} directly
+ * from './validation/index.js'.
+ */
+export declare class RepositoryParamsValidator {
+    /**
+     * Validate prototype ID parameter.
+     *
+     * @param id - Prototype ID to validate
+     * @throws {ValidationError} If ID is invalid
+     *
+     * @example
+     * ```ts
+     * RepositoryParamsValidator.validatePrototypeId(123); // OK
+     * RepositoryParamsValidator.validatePrototypeId(0);   // throws ValidationError
+     * RepositoryParamsValidator.validatePrototypeId(-1);  // throws ValidationError
+     * ```
+     */
+    static validatePrototypeId(id: number): void;
+    /**
+     * Validate sample size parameter.
+     *
+     * @param size - Sample size to validate
+     * @throws {ValidationError} If size is invalid
+     *
+     * @example
+     * ```ts
+     * RepositoryParamsValidator.validateSampleSize(10);  // OK
+     * RepositoryParamsValidator.validateSampleSize(0);   // OK
+     * RepositoryParamsValidator.validateSampleSize(-5);  // OK (handled by caller)
+     * RepositoryParamsValidator.validateSampleSize(1.5); // throws ValidationError
+     * ```
+     */
+    static validateSampleSize(size: number): void;
+}
+//# sourceMappingURL=params-validators.d.ts.map

package/dist/repository/validation/params-validators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-validators.d.ts","sourceRoot":"","sources":["../../../lib/repository/validation/params-validators.ts"],"names":[],"mappings":"AAaA;;;;;;;;;;;;;GAaG;AACH,qBAAa,yBAAyB;IACpC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,mBAAmB,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI;IAW5C;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;CAU9C"}

package/dist/repository/validation/params-validators.js

@@ -0,0 +1,68 @@
+/**
+ * Repository validator utilities.
+ *
+ * This module provides the RepositoryParamsValidator class for validating
+ * repository method parameters in a centralized manner.
+ *
+ * @remarks
+ * For snapshot validation, use {@link validateSerializableSnapshot} directly
+ * from './validation/index.js' instead of methods in this class.
+ */
+import { ValidationError } from '../errors/validation-error.js';
+import { prototypeIdSchema, sampleSizeSchema } from '../schemas/params.js';
+/**
+ * Validator class for repository operations.
+ *
+ * Provides centralized static validation methods for method parameters.
+ * All methods throw {@link ValidationError} on invalid input.
+ *
+ * @remarks
+ * This class separates validation concerns from business logic in
+ * ProtopediaInMemoryRepositoryImpl, improving testability and maintainability.
+ * All methods are static and stateless.
+ *
+ * For snapshot validation, use {@link validateSerializableSnapshot} directly
+ * from './validation/index.js'.
+ */
+export class RepositoryParamsValidator {
+    /**
+     * Validate prototype ID parameter.
+     *
+     * @param id - Prototype ID to validate
+     * @throws {ValidationError} If ID is invalid
+     *
+     * @example
+     * ```ts
+     * RepositoryParamsValidator.validatePrototypeId(123); // OK
+     * RepositoryParamsValidator.validatePrototypeId(0);   // throws ValidationError
+     * RepositoryParamsValidator.validatePrototypeId(-1);  // throws ValidationError
+     * ```
+     */
+    static validatePrototypeId(id) {
+        const validation = prototypeIdSchema.safeParse(id);
+        if (!validation.success) {
+            throw new ValidationError('Invalid prototype ID: must be a positive integer', 'prototypeId', { cause: validation.error });
+        }
+    }
+    /**
+     * Validate sample size parameter.
+     *
+     * @param size - Sample size to validate
+     * @throws {ValidationError} If size is invalid
+     *
+     * @example
+     * ```ts
+     * RepositoryParamsValidator.validateSampleSize(10);  // OK
+     * RepositoryParamsValidator.validateSampleSize(0);   // OK
+     * RepositoryParamsValidator.validateSampleSize(-5);  // OK (handled by caller)
+     * RepositoryParamsValidator.validateSampleSize(1.5); // throws ValidationError
+     * ```
+     */
+    static validateSampleSize(size) {
+        const validation = sampleSizeSchema.safeParse(size);
+        if (!validation.success) {
+            throw new ValidationError('Invalid sample size: must be an integer', 'size', { cause: validation.error });
+        }
+    }
+}
+//# sourceMappingURL=params-validators.js.map

package/dist/repository/validation/params-validators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"params-validators.js","sourceRoot":"","sources":["../../../lib/repository/validation/params-validators.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAE3E;;;;;;;;;;;;;GAaG;AACH,MAAM,OAAO,yBAAyB;IACpC;;;;;;;;;;;;OAYG;IACH,MAAM,CAAC,mBAAmB,CAAC,EAAU;QACnC,MAAM,UAAU,GAAG,iBAAiB,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CACvB,kDAAkD,EAClD,aAAa,EACb,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAC5B,CAAC;QACJ,CAAC;IACH,CAAC;IAED;;;;;;;;;;;;;OAaG;IACH,MAAM,CAAC,kBAAkB,CAAC,IAAY;QACpC,MAAM,UAAU,GAAG,gBAAgB,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;YACxB,MAAM,IAAI,eAAe,CACvB,yCAAyC,EACzC,MAAM,EACN,EAAE,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,CAC5B,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/repository/validation/serializable-snapshot.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Repository data validators.
+ *
+ * This module provides validation utilities for repository operations,
+ * primarily for validating external data before processing (e.g., snapshot imports).
+ *
+ * These validators return Result types (ValidationResult) instead of throwing errors.
+ * For parameter validation at repository API boundaries, use ValidationError with Zod schemas.
+ */
+import type { Logger } from '../../logger/logger.types.js';
+import type { ValidationResult } from '../../utils/validation/types.js';
+import type { SerializableSnapshot } from '../types/index.js';
+/**
+ * Serializable snapshot validation error code.
+ */
+type SerializableSnapshotValidationErrorCode = 'SERIALIZABLE_SNAPSHOT_VALIDATION_ERROR';
+/**
+ * Validate a SerializableSnapshot object.
+ *
+ * Validates the structure of snapshot data for import operations,
+ * ensuring version compatibility and data integrity.
+ *
+ * Validation steps:
+ * 1. Check data is a plain object
+ * 2. Validate version field (semver format: x.y.z)
+ * 3. Validate serializedAt field (ISO-8601 UTC timestamp)
+ * 4. Validate prototypes array using {@link validateNormalizedPrototypeArray}
+ *
+ * @param data - Data to validate
+ * @param logger - Optional logger for validation events
+ * @returns Validation result with typed data or error details
+ *
+ * @example
+ * ```ts
+ * const result = validateSerializableSnapshot(data, logger);
+ * if (result.ok) {
+ *   // data is SerializableSnapshot
+ *   console.log(`Version: ${result.data.version}`);
+ *   console.log(`Prototypes: ${result.data.prototypes.length}`);
+ * } else {
+ *   console.error(`Invalid snapshot: ${result.message}`);
+ * }
+ * ```
+ */
+export declare function validateSerializableSnapshot(data: unknown, logger?: Logger): ValidationResult<SerializableSnapshot, SerializableSnapshotValidationErrorCode>;
+export {};
+//# sourceMappingURL=serializable-snapshot.d.ts.map

package/dist/repository/validation/serializable-snapshot.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-snapshot.d.ts","sourceRoot":"","sources":["../../../lib/repository/validation/serializable-snapshot.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAE3D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iCAAiC,CAAC;AAKxE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D;;GAEG;AACH,KAAK,uCAAuC,GAC1C,wCAAwC,CAAC;AAS3C;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,wBAAgB,4BAA4B,CAC1C,IAAI,EAAE,OAAO,EACb,MAAM,CAAC,EAAE,MAAM,GACd,gBAAgB,CACjB,oBAAoB,EACpB,uCAAuC,CACxC,CAkFA"}

package/dist/repository/validation/serializable-snapshot.js

@@ -0,0 +1,104 @@
+import { validateNormalizedPrototypeArray } from '../../utils/validation/index.js';
+import { serializedAtSchema, versionSchema, } from '../schemas/serializable-snapshot.js';
+/**
+ * Check if value is a plain object.
+ */
+function isPlainObject(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * Validate a SerializableSnapshot object.
+ *
+ * Validates the structure of snapshot data for import operations,
+ * ensuring version compatibility and data integrity.
+ *
+ * Validation steps:
+ * 1. Check data is a plain object
+ * 2. Validate version field (semver format: x.y.z)
+ * 3. Validate serializedAt field (ISO-8601 UTC timestamp)
+ * 4. Validate prototypes array using {@link validateNormalizedPrototypeArray}
+ *
+ * @param data - Data to validate
+ * @param logger - Optional logger for validation events
+ * @returns Validation result with typed data or error details
+ *
+ * @example
+ * ```ts
+ * const result = validateSerializableSnapshot(data, logger);
+ * if (result.ok) {
+ *   // data is SerializableSnapshot
+ *   console.log(`Version: ${result.data.version}`);
+ *   console.log(`Prototypes: ${result.data.prototypes.length}`);
+ * } else {
+ *   console.error(`Invalid snapshot: ${result.message}`);
+ * }
+ * ```
+ */
+export function validateSerializableSnapshot(data, logger) {
+    // Step 1: Check data is a plain object
+    if (!isPlainObject(data)) {
+        logger?.warn('Snapshot data validation failed', {
+            reason: 'not a plain object',
+            type: typeof data,
+        });
+        return {
+            ok: false,
+            code: 'SERIALIZABLE_SNAPSHOT_VALIDATION_ERROR',
+            message: 'Invalid input: expected object, received ' + typeof data,
+        };
+    }
+    // Step 2: Validate version field using Zod schema
+    const versionValidation = versionSchema.safeParse(data.version);
+    if (!versionValidation.success) {
+        logger?.warn('Snapshot data validation failed', {
+            reason: 'invalid version format',
+            version: data.version,
+        });
+        return {
+            ok: false,
+            code: 'SERIALIZABLE_SNAPSHOT_VALIDATION_ERROR',
+            message: data.version === undefined
+                ? 'version: Invalid input: expected string, received undefined'
+                : 'version: ' + versionValidation.error.issues[0].message,
+        };
+    }
+    // Step 3: Validate serializedAt field using Zod schema
+    const serializedAtValidation = serializedAtSchema.safeParse(data.serializedAt);
+    if (!serializedAtValidation.success) {
+        logger?.warn('Snapshot data validation failed', {
+            reason: 'invalid serializedAt format',
+            serializedAt: data.serializedAt,
+        });
+        return {
+            ok: false,
+            code: 'SERIALIZABLE_SNAPSHOT_VALIDATION_ERROR',
+            message: data.serializedAt === undefined
+                ? 'serializedAt: Invalid input: expected string, received undefined'
+                : 'serializedAt: ' + serializedAtValidation.error.issues[0].message,
+        };
+    }
+    // Step 4: Validate prototypes array using shared validation
+    const prototypesValidation = validateNormalizedPrototypeArray(data.prototypes, logger);
+    if (!prototypesValidation.ok) {
+        // Logger already called by validateNormalizedPrototypeArray
+        return {
+            ok: false,
+            code: 'SERIALIZABLE_SNAPSHOT_VALIDATION_ERROR',
+            message: 'prototypes: ' + prototypesValidation.message,
+        };
+    }
+    logger?.info('Snapshot data validated successfully', {
+        version: versionValidation.data,
+        serializedAt: serializedAtValidation.data,
+        prototypeCount: prototypesValidation.data.length,
+    });
+    return {
+        ok: true,
+        data: {
+            version: versionValidation.data,
+            serializedAt: serializedAtValidation.data,
+            prototypes: prototypesValidation.data,
+        },
+    };
+}
+//# sourceMappingURL=serializable-snapshot.js.map

package/dist/repository/validation/serializable-snapshot.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serializable-snapshot.js","sourceRoot":"","sources":["../../../lib/repository/validation/serializable-snapshot.ts"],"names":[],"mappings":"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"}

package/dist/schemas/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Common validation schemas.
+ *
+ * This module provides Zod schemas for validating common data structures
+ * used across multiple modules (fetcher, repository, store).
+ */
+export { normalizedPrototypeSchema } from './normalized-prototype.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../lib/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/schemas/index.js

@@ -0,0 +1,8 @@
+/**
+ * Common validation schemas.
+ *
+ * This module provides Zod schemas for validating common data structures
+ * used across multiple modules (fetcher, repository, store).
+ */
+export { normalizedPrototypeSchema } from './normalized-prototype.js';
+//# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/schemas/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,yBAAyB,EAAE,MAAM,2BAA2B,CAAC"}

package/dist/schemas/normalized-prototype.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Validation schema for NormalizedPrototype.
+ *
+ * This module provides a Zod schema for validating the structure
+ * of normalized prototype objects.
+ */
+import { z } from 'zod';
+/**
+ * Validation schema for NormalizedPrototype.
+ *
+ * This schema validates the structure of a single prototype object.
+ * Used internally for validating deserialized snapshot data.
+ *
+ * @remarks
+ * This is a comprehensive schema covering all fields of NormalizedPrototype.
+ * Optional fields are marked with .optional() and must be undefined (not null)
+ * due to exactOptionalPropertyTypes: true.
+ */
+export declare const normalizedPrototypeSchema: z.ZodObject<{
+    id: z.ZodNumber;
+    createDate: z.ZodString;
+    updateDate: z.ZodOptional<z.ZodString>;
+    releaseDate: z.ZodOptional<z.ZodString>;
+    createId: z.ZodOptional<z.ZodNumber>;
+    updateId: z.ZodOptional<z.ZodNumber>;
+    releaseFlg: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>]>;
+    status: z.ZodUnion<readonly [z.ZodLiteral<1>, z.ZodLiteral<2>, z.ZodLiteral<3>, z.ZodLiteral<4>]>;
+    prototypeNm: z.ZodString;
+    summary: z.ZodString;
+    freeComment: z.ZodString;
+    systemDescription: z.ZodString;
+    users: z.ZodArray<z.ZodString>;
+    teamNm: z.ZodString;
+    tags: z.ZodArray<z.ZodString>;
+    materials: z.ZodArray<z.ZodString>;
+    events: z.ZodArray<z.ZodString>;
+    awards: z.ZodArray<z.ZodString>;
+    officialLink: z.ZodOptional<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodString>;
+    mainUrl: z.ZodString;
+    relatedLink: z.ZodOptional<z.ZodString>;
+    relatedLink2: z.ZodOptional<z.ZodString>;
+    relatedLink3: z.ZodOptional<z.ZodString>;
+    relatedLink4: z.ZodOptional<z.ZodString>;
+    relatedLink5: z.ZodOptional<z.ZodString>;
+    viewCount: z.ZodNumber;
+    goodCount: z.ZodNumber;
+    commentCount: z.ZodNumber;
+    uuid: z.ZodOptional<z.ZodString>;
+    nid: z.ZodOptional<z.ZodString>;
+    revision: z.ZodOptional<z.ZodNumber>;
+    licenseType: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    thanksFlg: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<0>, z.ZodLiteral<1>]>>;
+    slideMode: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+//# sourceMappingURL=normalized-prototype.d.ts.map

package/dist/schemas/normalized-prototype.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalized-prototype.d.ts","sourceRoot":"","sources":["../../lib/schemas/normalized-prototype.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB;;;;;;;;;;GAUG;AACH,eAAO,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAoHpC,CAAC"}