promidas 2.0.0

package/dist/types/index.js

@@ -0,0 +1,60 @@
+/**
+ * Shared type definitions for the library.
+ *
+ * This module provides the core data structures used throughout the library.
+ * It serves as the single source of truth for type definitions, ensuring
+ * consistency across all layers (Fetcher, Store, Repository).
+ *
+ * ## Main Exports
+ *
+ * - {@link NormalizedPrototype} — The standardized shape of a prototype
+ *   after normalization from ProtoPedia API responses.
+ * - {@link StatusCode} — Type for prototype status codes (1-4)
+ * - {@link ReleaseFlagCode} — Type for release flag codes (1-3)
+ * - {@link LicenseTypeCode} — Type for license type codes (0-1)
+ * - {@link ThanksFlagCode} — Type for thanks flag codes (0, 1, or undefined)
+ *
+ * ## Type Characteristics
+ *
+ * - **Type Safety**: Strongly typed with clear required/optional field distinction
+ * - **Normalization**: Pipe-separated strings converted to arrays, timestamps to UTC ISO 8601
+ * - **Strict Typing**: Compatible with TypeScript's `exactOptionalPropertyTypes: true`
+ * - **Cross-Layer Consistency**: Used uniformly across Fetcher, Store, and Repository
+ *
+ * ## Usage
+ *
+ * @example
+ * ```typescript
+ * import type { NormalizedPrototype, StatusCode } from 'promidas/types';
+ *
+ * function processPrototype(prototype: NormalizedPrototype) {
+ *   // Required fields are always accessible
+ *   console.log(prototype.id, prototype.prototypeNm);
+ *
+ *   // Array fields are type-safe
+ *   prototype.tags.forEach(tag => console.log(tag)); // tag is string
+ *
+ *   // Optional fields require undefined checks
+ *   if (prototype.releaseDate !== undefined) {
+ *     console.log(new Date(prototype.releaseDate));
+ *   }
+ *
+ *   // Code types are available
+ *   const status: StatusCode = prototype.status as StatusCode;
+ * }
+ * ```
+ *
+ * ## Data Transformation
+ *
+ * This type represents data after normalization:
+ *
+ * - **Raw API data** (`UpstreamPrototype`) → `normalizePrototype()` → **Normalized data** (`NormalizedPrototype`)
+ * - Pipe-separated strings (`"tag1|tag2"`) → Arrays (`["tag1", "tag2"]`)
+ * - JST timestamps (`"2025-12-12 09:00:00.0"`) → UTC ISO 8601 (`"2025-12-12T00:00:00.000Z"`)
+ *
+ * @module
+ * @see {@link NormalizedPrototype} for detailed field documentation
+ * @see {@link ../fetcher/index.js} for normalization utilities
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../lib/types/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG"}

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

@@ -0,0 +1,95 @@
+/**
+ * Normalized prototype type definition.
+ *
+ * This module defines the canonical {@link NormalizedPrototype} type used
+ * throughout the library to represent ProtoPedia prototype data in a
+ * standardized, type-safe format.
+ *
+ * ## Purpose
+ *
+ * The {@link NormalizedPrototype} type serves as the universal data model
+ * for prototype information across all layers of this library:
+ *
+ * - **Fetcher layer** - Normalizes raw API responses into this type
+ * - **Store layer** - Manages snapshots of this type in memory
+ * - **Repository layer** - Provides access methods returning this type
+ *
+ * ## Key Features
+ *
+ * - **Type safety** - All fields are strongly typed with appropriate nullability
+ * - **Consistency** - Ensures uniform data structure across the application
+ * - **API compatibility** - Handles optional fields from protopedia-api-v2-client v3.0.0+
+ * - **Strict typing** - Uses `exactOptionalPropertyTypes: true` for maximum safety
+ *
+ * ## Related Components
+ *
+ * - {@link normalizePrototype} - Function that transforms raw API data into this type
+ * - {@link PrototypeInMemoryStore} - Store implementation using this type
+ * - {@link ProtopediaApiCustomClient.fetchPrototypes} - Method that fetches and returns this type
+ *
+ * @module
+ */
+import type { StatusCode, ReleaseFlagCode, LicenseTypeCode, ThanksFlagCode } from './codes.js';
+/**
+ * Normalized prototype data structure.
+ *
+ * This type represents a ProtoPedia prototype in a standardized format,
+ * with all upstream API fields normalized and transformed for consistent
+ * use throughout the library.
+ *
+ * ## Field Transformations
+ *
+ * - **Pipe-separated strings** (tags, users, awards, events, materials)
+ *   are converted to arrays
+ * - **Date strings** (createDate, updateDate, releaseDate) are converted
+ *   from JST to UTC ISO 8601 format
+ * - **Optional fields** have appropriate default values applied when missing
+ *
+ * ## Type Safety
+ *
+ * This type uses TypeScript's `exactOptionalPropertyTypes: true` setting.
+ * Optional properties are explicitly typed as `Type?: undefined | Type`
+ * to ensure proper handling of undefined values.
+ *
+ * @see {@link normalizePrototype} for the transformation logic
+ */
+export type NormalizedPrototype = {
+    id: number;
+    createDate: string;
+    updateDate?: undefined | string;
+    releaseDate?: undefined | string;
+    createId?: undefined | number;
+    updateId?: undefined | number;
+    releaseFlg: ReleaseFlagCode;
+    status: StatusCode;
+    prototypeNm: string;
+    summary: string;
+    freeComment: string;
+    systemDescription: string;
+    /** Users and Team */
+    users: string[];
+    teamNm: string;
+    /** Tags, Materials, Events, and Awards */
+    tags: string[];
+    materials: string[];
+    events: string[];
+    awards: string[];
+    officialLink?: undefined | string;
+    videoUrl?: undefined | string;
+    mainUrl: string;
+    relatedLink?: undefined | string;
+    relatedLink2?: undefined | string;
+    relatedLink3?: undefined | string;
+    relatedLink4?: undefined | string;
+    relatedLink5?: undefined | string;
+    viewCount: number;
+    goodCount: number;
+    commentCount: number;
+    uuid?: undefined | string;
+    nid?: undefined | string;
+    revision?: undefined | number;
+    licenseType?: undefined | LicenseTypeCode;
+    thanksFlg?: undefined | ThanksFlagCode;
+    slideMode?: undefined | number;
+};
+//# sourceMappingURL=normalized-prototype.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalized-prototype.d.ts","sourceRoot":"","sources":["../../lib/types/normalized-prototype.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,eAAe,EACf,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAEhC,EAAE,EAAE,MAAM,CAAC;IAGX,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,UAAU,EAAE,eAAe,CAAC;IAG5B,MAAM,EAAE,UAAU,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAE1B,qBAAqB;IACrB,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IAEf,0CAA0C;IAC1C,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,EAAE,CAAC;IAIjB,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAElC,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAE9B,OAAO,EAAE,MAAM,CAAC;IAEhB,WAAW,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACjC,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAClC,YAAY,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAElC,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,EAAE,MAAM,CAAC;IAGrB,IAAI,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC1B,GAAG,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IACzB,QAAQ,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;IAC9B,WAAW,CAAC,EAAE,SAAS,GAAG,eAAe,CAAC;IAC1C,SAAS,CAAC,EAAE,SAAS,GAAG,cAAc,CAAC;IACvC,SAAS,CAAC,EAAE,SAAS,GAAG,MAAM,CAAC;CAChC,CAAC"}

package/dist/types/normalized-prototype.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=normalized-prototype.js.map

package/dist/types/normalized-prototype.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalized-prototype.js","sourceRoot":"","sources":["../../lib/types/normalized-prototype.ts"],"names":[],"mappings":""}

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

@@ -0,0 +1,15 @@
+/**
+ * Value-to-label converters for ProtoPedia fields.
+ *
+ * These converters transform numeric codes from the ProtoPedia API
+ * into human-readable labels.
+ *
+ * @module utils/converters
+ *
+ * @see https://protopedia.gitbook.io/helpcenter/info/2022.05.23
+ */
+export * from './status.js';
+export * from './release-flag.js';
+export * from './thanks-flag.js';
+export * from './license-type.js';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../lib/utils/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/utils/converters/index.js

@@ -0,0 +1,15 @@
+/**
+ * Value-to-label converters for ProtoPedia fields.
+ *
+ * These converters transform numeric codes from the ProtoPedia API
+ * into human-readable labels.
+ *
+ * @module utils/converters
+ *
+ * @see https://protopedia.gitbook.io/helpcenter/info/2022.05.23
+ */
+export * from './status.js';
+export * from './release-flag.js';
+export * from './thanks-flag.js';
+export * from './license-type.js';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../lib/utils/converters/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,mBAAmB,CAAC;AAClC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/utils/converters/license-type.d.ts

@@ -0,0 +1,23 @@
+/**
+ * License type value to label converter.
+ *
+ * Converts numeric license type codes from the ProtoPedia API to Japanese labels.
+ *
+ * @module utils/converters/license-type
+ */
+import type { LicenseTypeCode } from '../../types/codes.js';
+/**
+ * Convert license type code to label.
+ *
+ * @param licenseType - License type from NormalizedPrototype.licenseType
+ * @returns Japanese label or the numeric value as string if unknown
+ *
+ * @example
+ * ```typescript
+ * getPrototypeLicenseTypeLabel(0); // => 'なし'
+ * getPrototypeLicenseTypeLabel(1); // => '表示(CC:BY)'
+ * getPrototypeLicenseTypeLabel(99); // => '99'
+ * ```
+ */
+export declare const getPrototypeLicenseTypeLabel: (licenseType: LicenseTypeCode) => string;
+//# sourceMappingURL=license-type.d.ts.map

package/dist/utils/converters/license-type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-type.d.ts","sourceRoot":"","sources":["../../../lib/utils/converters/license-type.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAiB5D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,4BAA4B,GACvC,aAAa,eAAe,KAC3B,MAEF,CAAC"}

package/dist/utils/converters/license-type.js

@@ -0,0 +1,38 @@
+/**
+ * License type value to label converter.
+ *
+ * Converts numeric license type codes from the ProtoPedia API to Japanese labels.
+ *
+ * @module utils/converters/license-type
+ */
+/**
+ * License type labels mapping.
+ *
+ * - 0: 'なし' (None) - **Not observed in API responses**
+ * - 1: '表示(CC:BY)' (Display with Creative Commons Attribution license) - **All API responses have this value**
+ *
+ * Note: In practice, all prototypes accessible via the public API have licenseType=1.
+ *
+ * @see https://protopedia.gitbook.io/helpcenter/info/2022.05.23
+ */
+const LICENSE_TYPE_LABELS = {
+    0: 'なし',
+    1: '表示(CC:BY)',
+};
+/**
+ * Convert license type code to label.
+ *
+ * @param licenseType - License type from NormalizedPrototype.licenseType
+ * @returns Japanese label or the numeric value as string if unknown
+ *
+ * @example
+ * ```typescript
+ * getPrototypeLicenseTypeLabel(0); // => 'なし'
+ * getPrototypeLicenseTypeLabel(1); // => '表示(CC:BY)'
+ * getPrototypeLicenseTypeLabel(99); // => '99'
+ * ```
+ */
+export const getPrototypeLicenseTypeLabel = (licenseType) => {
+    return LICENSE_TYPE_LABELS[licenseType] ?? `${licenseType}`;
+};
+//# sourceMappingURL=license-type.js.map

package/dist/utils/converters/license-type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"license-type.js","sourceRoot":"","sources":["../../../lib/utils/converters/license-type.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAoC;IAC3D,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,WAAW;CACf,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,WAA4B,EACpB,EAAE;IACV,OAAO,mBAAmB,CAAC,WAAW,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;AAC9D,CAAC,CAAC"}

package/dist/utils/converters/release-flag.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Release flag value to label converter.
+ *
+ * Converts numeric release flag codes from the ProtoPedia API to Japanese labels.
+ *
+ * **Note**: API typically only returns prototypes with `releaseFlg: 2` (publicly released).
+ *
+ * @module utils/converters/release-flag
+ */
+import type { ReleaseFlagCode } from '../../types/codes.js';
+/**
+ * Convert release flag code to label.
+ *
+ * @param releaseFlag - Release flag from NormalizedPrototype.releaseFlg
+ * @returns Japanese label or the numeric value as string if unknown
+ *
+ * @example
+ * ```typescript
+ * getPrototypeReleaseFlagLabel(2); // => '一般公開'
+ * getPrototypeReleaseFlagLabel(0); // => '0'
+ * ```
+ */
+export declare const getPrototypeReleaseFlagLabel: (releaseFlag: ReleaseFlagCode) => string;
+//# sourceMappingURL=release-flag.d.ts.map

package/dist/utils/converters/release-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-flag.d.ts","sourceRoot":"","sources":["../../../lib/utils/converters/release-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAkB5D;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,4BAA4B,GACvC,aAAa,eAAe,KAC3B,MAEF,CAAC"}

package/dist/utils/converters/release-flag.js

@@ -0,0 +1,40 @@
+/**
+ * Release flag value to label converter.
+ *
+ * Converts numeric release flag codes from the ProtoPedia API to Japanese labels.
+ *
+ * **Note**: API typically only returns prototypes with `releaseFlg: 2` (publicly released).
+ *
+ * @module utils/converters/release-flag
+ */
+/**
+ * Release flag labels mapping.
+ *
+ * - 1: '下書き保存' (Draft) - **Not accessible via public API**
+ * - 2: '一般公開' (Public) - **Only this value appears in API responses**
+ * - 3: '限定共有' (Limited Sharing) - **Not accessible via public API**
+ *
+ * Note: The public API only returns publicly released prototypes (releaseFlg=2).
+ * Draft and limited sharing prototypes are not included in API responses.
+ */
+const RELEASE_FLAG_LABELS = {
+    1: '下書き保存',
+    2: '一般公開',
+    3: '限定共有',
+};
+/**
+ * Convert release flag code to label.
+ *
+ * @param releaseFlag - Release flag from NormalizedPrototype.releaseFlg
+ * @returns Japanese label or the numeric value as string if unknown
+ *
+ * @example
+ * ```typescript
+ * getPrototypeReleaseFlagLabel(2); // => '一般公開'
+ * getPrototypeReleaseFlagLabel(0); // => '0'
+ * ```
+ */
+export const getPrototypeReleaseFlagLabel = (releaseFlag) => {
+    return RELEASE_FLAG_LABELS[releaseFlag] ?? `${releaseFlag}`;
+};
+//# sourceMappingURL=release-flag.js.map

package/dist/utils/converters/release-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"release-flag.js","sourceRoot":"","sources":["../../../lib/utils/converters/release-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;;GASG;AACH,MAAM,mBAAmB,GAAoC;IAC3D,CAAC,EAAE,OAAO;IACV,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,MAAM;CACV,CAAC;AAEF;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,4BAA4B,GAAG,CAC1C,WAA4B,EACpB,EAAE;IACV,OAAO,mBAAmB,CAAC,WAAW,CAAC,IAAI,GAAG,WAAW,EAAE,CAAC;AAC9D,CAAC,CAAC"}

package/dist/utils/converters/status.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Status value to label converter.
+ *
+ * Converts numeric status codes from the ProtoPedia API to Japanese labels.
+ *
+ * @module utils/converters/status
+ */
+import type { StatusCode } from '../../types/codes.js';
+/**
+ * Convert status code to label.
+ *
+ * @param status - Status code from NormalizedPrototype.status
+ * @returns Japanese label or the numeric value as string if unknown
+ *
+ * @example
+ * ```typescript
+ * getPrototypeStatusLabel(1); // => 'アイデア'
+ * getPrototypeStatusLabel(3); // => '完成'
+ * getPrototypeStatusLabel(99); // => '99'
+ * ```
+ */
+export declare const getPrototypeStatusLabel: (status: StatusCode) => string;
+//# sourceMappingURL=status.d.ts.map

package/dist/utils/converters/status.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.d.ts","sourceRoot":"","sources":["../../../lib/utils/converters/status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAmBvD;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,uBAAuB,GAAI,QAAQ,UAAU,KAAG,MAE5D,CAAC"}

package/dist/utils/converters/status.js

@@ -0,0 +1,40 @@
+/**
+ * Status value to label converter.
+ *
+ * Converts numeric status codes from the ProtoPedia API to Japanese labels.
+ *
+ * @module utils/converters/status
+ */
+/**
+ * Status labels mapping.
+ *
+ * - 1: 'アイデア' (Idea) - ~6% of API responses
+ * - 2: '開発中' (In Development) - ~35% of API responses
+ * - 3: '完成' (Completed) - ~57% of API responses (most common)
+ * - 4: '供養' (Retired/Memorial) - ~2% of API responses
+ *
+ * All four status values appear in public API responses.
+ */
+const STATUS_LABELS = {
+    1: 'アイデア',
+    2: '開発中',
+    3: '完成',
+    4: '供養',
+};
+/**
+ * Convert status code to label.
+ *
+ * @param status - Status code from NormalizedPrototype.status
+ * @returns Japanese label or the numeric value as string if unknown
+ *
+ * @example
+ * ```typescript
+ * getPrototypeStatusLabel(1); // => 'アイデア'
+ * getPrototypeStatusLabel(3); // => '完成'
+ * getPrototypeStatusLabel(99); // => '99'
+ * ```
+ */
+export const getPrototypeStatusLabel = (status) => {
+    return STATUS_LABELS[status] ?? `${status}`;
+};
+//# sourceMappingURL=status.js.map

package/dist/utils/converters/status.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"status.js","sourceRoot":"","sources":["../../../lib/utils/converters/status.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;;;;;;;;;GASG;AACH,MAAM,aAAa,GAA+B;IAChD,CAAC,EAAE,MAAM;IACT,CAAC,EAAE,KAAK;IACR,CAAC,EAAE,IAAI;IACP,CAAC,EAAE,IAAI;CACR,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,MAAkB,EAAU,EAAE;IACpE,OAAO,aAAa,CAAC,MAAM,CAAC,IAAI,GAAG,MAAM,EAAE,CAAC;AAC9C,CAAC,CAAC"}

package/dist/utils/converters/thanks-flag.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Thanks flag value to label converter.
+ *
+ * Converts numeric thanks flag codes from the ProtoPedia API to labels.
+ *
+ * This flag controls whether the "Thank you for posting" message has been shown.
+ *
+ * @module utils/converters/thanks-flag
+ */
+import type { ThanksFlagCode } from '../../types/codes.js';
+/**
+ * Convert thanks flag code to label.
+ *
+ * @param thanksFlag - Thanks flag from NormalizedPrototype.thanksFlg (may be undefined for old data)
+ * @returns Label or the numeric value as string, or '不明' for undefined
+ *
+ * @example
+ * ```typescript
+ * getPrototypeThanksFlagLabel(1); // => '初回表示済'
+ * getPrototypeThanksFlagLabel(0); // => '0'
+ * getPrototypeThanksFlagLabel(undefined); // => '不明'
+ * ```
+ */
+export declare const getPrototypeThanksFlagLabel: (thanksFlag: ThanksFlagCode) => string;
+//# sourceMappingURL=thanks-flag.d.ts.map

package/dist/utils/converters/thanks-flag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"thanks-flag.d.ts","sourceRoot":"","sources":["../../../lib/utils/converters/thanks-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AAe3D;;;;;;;;;;;;GAYG;AACH,eAAO,MAAM,2BAA2B,GACtC,YAAY,cAAc,KACzB,MAKF,CAAC"}

package/dist/utils/converters/thanks-flag.js

@@ -0,0 +1,41 @@
+/**
+ * Thanks flag value to label converter.
+ *
+ * Converts numeric thanks flag codes from the ProtoPedia API to labels.
+ *
+ * This flag controls whether the "Thank you for posting" message has been shown.
+ *
+ * @module utils/converters/thanks-flag
+ */
+/**
+ * Thanks flag labels mapping.
+ *
+ * - 0: (Implicit) Message not yet shown - **Rarely or never seen in API responses**
+ * - 1: '初回表示済' ("Thank you for posting" message already shown) - **Most common value in API**
+ *
+ * Note: Almost all prototypes in API responses have thanksFlg=1.
+ * Historical data (~3.26%) may have undefined thanksFlg.
+ */
+const THANKS_FLAG_LABELS = {
+    1: '初回表示済',
+};
+/**
+ * Convert thanks flag code to label.
+ *
+ * @param thanksFlag - Thanks flag from NormalizedPrototype.thanksFlg (may be undefined for old data)
+ * @returns Label or the numeric value as string, or '不明' for undefined
+ *
+ * @example
+ * ```typescript
+ * getPrototypeThanksFlagLabel(1); // => '初回表示済'
+ * getPrototypeThanksFlagLabel(0); // => '0'
+ * getPrototypeThanksFlagLabel(undefined); // => '不明'
+ * ```
+ */
+export const getPrototypeThanksFlagLabel = (thanksFlag) => {
+    if (thanksFlag === undefined) {
+        return '不明';
+    }
+    return THANKS_FLAG_LABELS[thanksFlag] ?? `${thanksFlag}`;
+};
+//# sourceMappingURL=thanks-flag.js.map

package/dist/utils/converters/thanks-flag.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"thanks-flag.js","sourceRoot":"","sources":["../../../lib/utils/converters/thanks-flag.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH;;;;;;;;GAQG;AACH,MAAM,kBAAkB,GAA2B;IACjD,CAAC,EAAE,OAAO;CACX,CAAC;AAEF;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,CACzC,UAA0B,EAClB,EAAE;IACV,IAAI,UAAU,KAAK,SAAS,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,kBAAkB,CAAC,UAAU,CAAC,IAAI,GAAG,UAAU,EAAE,CAAC;AAC3D,CAAC,CAAC"}

package/dist/utils/deep-merge.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Checks if a value is a plain object.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a plain object
+ */
+export declare function isPlainObject(value: unknown): value is Record<string, unknown>;
+/**
+ * Deep merge utility for configuration objects.
+ * Recursively merges nested objects while preserving function references.
+ *
+ * This implementation includes protections against:
+ * - Circular references (using path-based WeakSet tracking)
+ * - Prototype pollution (skipping dangerous keys)
+ * - Non-plain object corruption (only merging plain objects)
+ * - Stack overflow from deep nesting (depth limit)
+ * - Array reference sharing (shallow copying arrays)
+ *
+ * Note on Arrays:
+ * Arrays are shallow copied. Objects inside arrays are shared by reference.
+ * If you need deep cloning of array elements, this utility does not support it.
+ *
+ * Note on null/undefined:
+ * - `undefined` values in source are skipped (target value preserved).
+ * - `null` values in source overwrite target values.
+ *
+ * Note on Special Objects:
+ * - `Object.create(null)` objects are treated as plain objects and merged.
+ * - Symbol properties are ignored (as Object.keys is used).
+ *
+ * @param target - Target object
+ * @param source - Source object to merge from
+ * @param seen - Set of objects in the current recursion path to detect cycles
+ * @param depth - Current recursion depth
+ * @returns Merged object
+ */
+export declare function deepMerge<T extends Record<string, unknown>>(target: T, source: Partial<T>, seen?: WeakSet<object>, depth?: number): T;
+//# sourceMappingURL=deep-merge.d.ts.map

package/dist/utils/deep-merge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.d.ts","sourceRoot":"","sources":["../../lib/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,aAAa,CAC3B,KAAK,EAAE,OAAO,GACb,KAAK,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAMlC;AAID;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACzD,MAAM,EAAE,CAAC,EACT,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,EAClB,IAAI,kBAAwB,EAC5B,KAAK,SAAI,GACR,CAAC,CAmDH"}

package/dist/utils/deep-merge.js

@@ -0,0 +1,85 @@
+/**
+ * Checks if a value is a plain object.
+ *
+ * @param value - The value to check
+ * @returns True if the value is a plain object
+ */
+export function isPlainObject(value) {
+    if (typeof value !== 'object' || value === null) {
+        return false;
+    }
+    const proto = Object.getPrototypeOf(value);
+    return proto === null || proto === Object.prototype;
+}
+const MAX_MERGE_DEPTH = 100;
+/**
+ * Deep merge utility for configuration objects.
+ * Recursively merges nested objects while preserving function references.
+ *
+ * This implementation includes protections against:
+ * - Circular references (using path-based WeakSet tracking)
+ * - Prototype pollution (skipping dangerous keys)
+ * - Non-plain object corruption (only merging plain objects)
+ * - Stack overflow from deep nesting (depth limit)
+ * - Array reference sharing (shallow copying arrays)
+ *
+ * Note on Arrays:
+ * Arrays are shallow copied. Objects inside arrays are shared by reference.
+ * If you need deep cloning of array elements, this utility does not support it.
+ *
+ * Note on null/undefined:
+ * - `undefined` values in source are skipped (target value preserved).
+ * - `null` values in source overwrite target values.
+ *
+ * Note on Special Objects:
+ * - `Object.create(null)` objects are treated as plain objects and merged.
+ * - Symbol properties are ignored (as Object.keys is used).
+ *
+ * @param target - Target object
+ * @param source - Source object to merge from
+ * @param seen - Set of objects in the current recursion path to detect cycles
+ * @param depth - Current recursion depth
+ * @returns Merged object
+ */
+export function deepMerge(target, source, seen = new WeakSet(), depth = 0) {
+    // Prevent stack overflow from excessively deep objects
+    if (depth > MAX_MERGE_DEPTH) {
+        console.warn(`deepMerge: Maximum depth (${MAX_MERGE_DEPTH}) exceeded`);
+        return target;
+    }
+    const result = { ...target };
+    for (const key of Object.keys(source)) {
+        // Prevent prototype pollution
+        if (key === '__proto__' || key === 'constructor' || key === 'prototype') {
+            continue;
+        }
+        const sourceValue = source[key];
+        const targetValue = target[key];
+        if (isPlainObject(sourceValue)) {
+            // Circular reference check (path-based)
+            if (seen.has(sourceValue)) {
+                continue;
+            }
+            seen.add(sourceValue);
+            // Recursively merge nested objects
+            // If targetValue is not a plain object, use an empty object as the base
+            const nextTarget = isPlainObject(targetValue) ? targetValue : {};
+            result[key] = deepMerge(nextTarget, sourceValue, seen, depth + 1);
+            // Remove from seen set after processing (backtracking)
+            // This ensures we only detect cycles in the current path, allowing shared references
+            seen.delete(sourceValue);
+        }
+        else if (sourceValue !== undefined) {
+            // Handle Arrays: Create shallow copy to prevent reference sharing
+            if (Array.isArray(sourceValue)) {
+                result[key] = [...sourceValue];
+            }
+            else {
+                // Directly assign primitives, functions, etc.
+                result[key] = sourceValue;
+            }
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=deep-merge.js.map

package/dist/utils/deep-merge.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"deep-merge.js","sourceRoot":"","sources":["../../lib/utils/deep-merge.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAC3B,KAAc;IAEd,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,KAAK,CAAC;IACf,CAAC;IACD,MAAM,KAAK,GAAG,MAAM,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC;IAC3C,OAAO,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,MAAM,CAAC,SAAS,CAAC;AACtD,CAAC;AAED,MAAM,eAAe,GAAG,GAAG,CAAC;AAE5B;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,MAAM,UAAU,SAAS,CACvB,MAAS,EACT,MAAkB,EAClB,OAAO,IAAI,OAAO,EAAU,EAC5B,KAAK,GAAG,CAAC;IAET,uDAAuD;IACvD,IAAI,KAAK,GAAG,eAAe,EAAE,CAAC;QAC5B,OAAO,CAAC,IAAI,CAAC,6BAA6B,eAAe,YAAY,CAAC,CAAC;QACvE,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,MAAM,MAAM,GAA4B,EAAE,GAAG,MAAM,EAAE,CAAC;IAEtD,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,8BAA8B;QAC9B,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,aAAa,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;YACxE,SAAS;QACX,CAAC;QAED,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAChC,MAAM,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAEhC,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;YAC/B,wCAAwC;YACxC,IAAI,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC1B,SAAS;YACX,CAAC;YACD,IAAI,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;YAEtB,mCAAmC;YACnC,wEAAwE;YACxE,MAAM,UAAU,GAAG,aAAa,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,CAAC;YAEjE,MAAM,CAAC,GAAG,CAAC,GAAG,SAAS,CACrB,UAAqC,EACrC,WAAW,EACX,IAAI,EACJ,KAAK,GAAG,CAAC,CACV,CAAC;YAEF,uDAAuD;YACvD,qFAAqF;YACrF,IAAI,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;QAC3B,CAAC;aAAM,IAAI,WAAW,KAAK,SAAS,EAAE,CAAC;YACrC,kEAAkE;YAClE,IAAI,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,CAAC;YACjC,CAAC;iBAAM,CAAC;gBACN,8CAA8C;gBAC9C,MAAM,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC;YAC5B,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,MAAW,CAAC;AACrB,CAAC"}