App & Game Store Listing Validator

Validates store listing copy against the published limits of Steam, the App Store and Google Play.

THE SILENT FAILURE. Store fields truncate rather than rejecting. A short description cut mid-sentence is what a shopper reads. The limits differ per store and per field, are counted inconsistently for non-Latin text, and — the part nobody checks — a LOCALISED listing blows limits that the English one passed. The Japanese or German page silently truncates while English looks perfect.

MULTI-LOCALE VALIDATION IS THE POINT: it validates a set of localised strings and reports which locales fail which fields. A validator that only checks English reproduces the bug.

Apple's keywords field is a comma-separated TOTAL budget rather than per keyword, and is handled the way the platform does, naming which keywords were dropped. Counting never uses naive .length on text containing astral characters, and the unit used per field is documented.

Every limit is cited to a primary source. Where a limit could not be confirmed it is marked UNVERIFIED in the code rather than guessed.

VERIFIED: 117 tests, 9/9 mutations caught. Every mutation was observed FAILING before the source was restored — a test never seen to fail is a decoration.

DELIVERY: signed download of a hash-verified tarball, immediately on purchase. Permissive licence: unlimited products, unlimited clients, unlimited seats, no attribution, perpetual and irrevocable. One restriction, do not republish the source as source.

Interface

What you call, and what comes back. Types and signatures only — the implementation ships with the source.

  export function validateAppStoreListing( locales: Record<string, AppleLocaleFields> ): AppStoreListingReport;
  export function validateGooglePlayListing( locales: Record<string, GooglePlayLocaleFields> ): GooglePlayListingReport;
  export function appleKeywordsBudget( keywords: string[], budgetBytes: number = APPLE_KEYWORDS_BUDGET_BYTES ): KeywordsBudgetResult;
  export function validateSteamTags(tags: string[]): SteamTagsReport;
  export function validateSteamListing( locales: Record<string, SteamLocaleFields>, tags: string[] = [] ): SteamListingReport;
  export function codepointLength(value: string): number;
  export function utf8ByteLength(value: string): number;
  export function truncateToUtf8Budget( value: string, budgetBytes: number ):;
  export function validateTextField( store: StoreId, locale: string, field: string, value: string, limit: TextFieldLimit ): FieldReport;
  export function validateLocalizedTextFields( store: StoreId, locales: Record<string, Record<string, string | undefined>>, limitTable: Record<string, TextFieldLimit> ): FieldReport[];
  export function failingLocales(reports: FieldReport[]): FailingLocale[];

  export type StoreId = "steam" | "appStore" | "googlePlay";
  export type CountingUnit = "codepoints" | "utf8Bytes";
  export type FieldLimit = TextFieldLimit | ListCountLimit;
  export type FieldStatus = "ok" | "violation" | "unverified";