@mohasinac/appkit 4.52.5 → 4.53.1

package/dist/seed/_helpers/character-features.d.ts

@@ -7,4 +7,4 @@ export interface CharacterSeed {
     beyCount: number;
 }
 export declare const CHARACTER_SEEDS: CharacterSeed[];
-export declare const CHARACTER_SEED_COUNT = 94;
+export declare const CHARACTER_SEED_COUNT = 95;

package/dist/seed/_helpers/character-features.js

@@ -68,6 +68,7 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-anime-secondary", name: "Anime-secondary", beyCount: 1 },
     { slug: "blader-blader-dj", name: "Blader DJ", beyCount: 1 },
     { slug: "blader-brooklyn", name: "Brooklyn", beyCount: 1 },
+    { slug: "blader-burn-fujiwara", name: "Burn Fujiwara", beyCount: 1 },
     { slug: "blader-chris", name: "Chris", beyCount: 1 },
     { slug: "blader-claude", name: "Claude", beyCount: 1 },
     { slug: "blader-clio-delon", name: "Clio Delon", beyCount: 1 },
@@ -116,4 +117,4 @@ export const CHARACTER_SEEDS = [
     { slug: "blader-yuni-naniwa", name: "Yuni Naniwa", beyCount: 1 },
     { slug: "blader-zyro-kurogane", name: "Zyro Kurogane", beyCount: 1 },
 ];
-export const CHARACTER_SEED_COUNT = 94;
+export const CHARACTER_SEED_COUNT = 95;

package/dist/seed/_helpers/franchise-rows.js

@@ -64,8 +64,16 @@ export function franchiseRow(input, order, stamps) {
         path: id,
         isLeaf: true,
         order,
-        /* `icon` deliberately unset — the brands grid reads `display.icon` first
-         * and an emoji there would beat a real cover image (brand-rows trap 2). */
+        /*
+         * A placeholder tile that a real wordmark OVERRIDES — same rule as
+         * `brand-rows.ts`: `withGeneratedCoverImage` treats a `/images/seed-tiles/`
+         * path as a default rather than a hand-authored decision. Only
+         * `franchise-beyblade` resolves a real one today; the other seven are the
+         * inactive dead-facet rows and keep the tile.
+         *
+         * `icon` stays unset — the brands grid reads `display.icon` first and an
+         * emoji there would beat a real cover image (brand-rows trap 2).
+         */
         display: {
             coverImage: seedPhoto(`franchise-cover-${input.slug}-20261014`, 800, 800),
             showInMenu: false,

package/dist/seed/_helpers/media.d.ts

@@ -1,4 +1,34 @@
+/**
+ * Seed-time media URL helper.
+ *
+ * Wraps a 3rd-party image/video URL in the /api/media/ext proxy path so
+ * seed data never persists raw upstream URLs. The proxy adds watermarking,
+ * survives upstream rate-limits, and keeps CSP / image hosts under our
+ * control.
+ *
+ * Companion runtime helper: `resolveMediaUrl()` in ../../utils/media-url.ts
+ * — defends consumers that still see raw URLs (e.g. live Firestore reads
+ * from older docs). Both produce the same `/api/media/ext?url=<encoded>`
+ * shape for external https URLs.
+ *
+ * Idempotent: already-proxied URLs (`/media/...` or `/api/media/ext?url=...`)
+ * pass through untouched, so wrapping a wrapped URL is safe.
+ */
+import type { ProductImage } from "../../features/products/types";
 export declare function seedExtMedia(url: string): string;
+/**
+ * Is this cover value a generated PLACEHOLDER rather than a real image?
+ *
+ * 🛑 Load-bearing for `withGeneratedCoverImage`, which otherwise treats any
+ * non-empty `display.coverImage` as hand-authored and skips the row — so a
+ * `seedPhoto(...)` tile BLOCKED every fetched wordmark, and a logo could be
+ * downloaded, uploaded, mapped and still never appear.
+ *
+ * The distinction is the honest one: a tile is what the seed emits when it has
+ * nothing better, so it is a default to be improved on. A real path (a
+ * `/media/<slug>` or an admin upload) is a decision, and that still wins.
+ */
+export declare function isSeedPlaceholderImage(value: string | undefined | null): boolean;
 /**
  * Turn a seed key into something a person would read.
  *
@@ -9,6 +39,23 @@ export declare function seedExtMedia(url: string): string;
  * bookkeeping, not the name of the thing.
  */
 export declare function seedPhotoLabel(seed: string): string;
+/**
+ * A seed gallery as `ProductImage[]` — plan A6 changed
+ * `ProductDocument.images` from `string[]` to `ProductImage[]`, and these
+ * fixtures hold bare URLs.
+ *
+ * 🛑 Deliberately sets NO `alt`. The only string available at these call
+ * sites is the product title, and "Dranzer S" repeated as the alt of all
+ * three of its photos is the naive fill that screen-reader users correctly
+ * treat as noise — worse than absent, because it claims to describe. The
+ * GENERATED catalogue does emit real alt ("Chain Kerbeus — Aquilon-Q
+ * (Disc)") because its join knows what each photo is OF; a hand-written
+ * fixture does not, and should say so by omission.
+ *
+ * Nor does it set `width`/`height`: a seed tile is one SVG serving every
+ * aspect (see `seedPhoto` below), so there is no honest intrinsic size.
+ */
+export declare function seedGallery(...urls: string[]): ProductImage[];
 /**
  * A deterministic, labelled placeholder image for seed data, already wrapped in
  * the media proxy.

package/dist/seed/_helpers/media.js

@@ -75,6 +75,21 @@ export function seedExtMedia(url) {
  * comment is the only thing guarding the second.
  */
 const SEED_TILE_PREFIX = "/images/seed-tiles/";
+/**
+ * Is this cover value a generated PLACEHOLDER rather than a real image?
+ *
+ * 🛑 Load-bearing for `withGeneratedCoverImage`, which otherwise treats any
+ * non-empty `display.coverImage` as hand-authored and skips the row — so a
+ * `seedPhoto(...)` tile BLOCKED every fetched wordmark, and a logo could be
+ * downloaded, uploaded, mapped and still never appear.
+ *
+ * The distinction is the honest one: a tile is what the seed emits when it has
+ * nothing better, so it is a default to be improved on. A real path (a
+ * `/media/<slug>` or an admin upload) is a decision, and that still wins.
+ */
+export function isSeedPlaceholderImage(value) {
+    return typeof value === "string" && value.startsWith(SEED_TILE_PREFIX);
+}
 /**
  * Muted backgrounds, all dark enough for the same light foreground.
  *
@@ -120,6 +135,25 @@ export function seedPhotoLabel(seed) {
         return "LetItRip";
     return cleaned.replace(/\b[a-z]/g, (c) => c.toUpperCase());
 }
+/**
+ * A seed gallery as `ProductImage[]` — plan A6 changed
+ * `ProductDocument.images` from `string[]` to `ProductImage[]`, and these
+ * fixtures hold bare URLs.
+ *
+ * 🛑 Deliberately sets NO `alt`. The only string available at these call
+ * sites is the product title, and "Dranzer S" repeated as the alt of all
+ * three of its photos is the naive fill that screen-reader users correctly
+ * treat as noise — worse than absent, because it claims to describe. The
+ * GENERATED catalogue does emit real alt ("Chain Kerbeus — Aquilon-Q
+ * (Disc)") because its join knows what each photo is OF; a hand-written
+ * fixture does not, and should say so by omission.
+ *
+ * Nor does it set `width`/`height`: a seed tile is one SVG serving every
+ * aspect (see `seedPhoto` below), so there is no honest intrinsic size.
+ */
+export function seedGallery(...urls) {
+    return urls.filter(Boolean).map((url) => ({ url }));
+}
 /**
  * A deterministic, labelled placeholder image for seed data, already wrapped in
  * the media proxy.

package/dist/seed/_helpers/search-txt-wrappers.d.ts

@@ -3,10 +3,10 @@ import type { StoreDocument } from "../../features/stores/schemas/firestore";
 import type { ScammerDocument } from "../../features/scams/schemas/firestore";
 import type { EventDocument } from "../../features/events/schemas/firestore";
 import type { BlogPostDocument } from "../../features/blog/schemas/firestore";
-import type { ReviewDocument } from "../../features/reviews/schemas/firestore";
-import type { OrderDocument } from "../../features/orders/schemas/firestore";
+import type { ReviewPlain } from "../../features/reviews/schemas/firestore";
+import type { OrderPlain } from "../../features/orders/schemas/firestore";
 import type { CouponDocument } from "../../features/promotions/schemas/firestore";
-import type { OfferDocument } from "../../features/seller/schemas/firestore";
+import type { OfferPlain } from "../../features/seller/schemas/firestore";
 /**
  * 🛑 Apply AFTER `buildCategoryTree`, never before.
  *
@@ -19,8 +19,8 @@ export declare function withCategorySearchTxt<T extends Partial<CategoryDocument
 export declare function withStoreSearchTxt<T extends Partial<StoreDocument>>(p: T): T;
 export declare function withEventSearchTxt<T extends Partial<EventDocument>>(p: T): T;
 export declare function withBlogSearchTxt<T extends Partial<BlogPostDocument>>(p: T): T;
-export declare function withReviewSearchTxt<T extends Partial<ReviewDocument>>(p: T): T;
-export declare function withOrderSearchTxt<T extends Partial<OrderDocument>>(p: T): T;
+export declare function withReviewSearchTxt<T extends Partial<ReviewPlain>>(p: T): T;
+export declare function withOrderSearchTxt<T extends Partial<OrderPlain>>(p: T): T;
 export declare function withCouponSearchTxt<T extends Partial<CouponDocument>>(p: T): T;
-export declare function withOfferSearchTxt<T extends Partial<OfferDocument>>(p: T): T;
+export declare function withOfferSearchTxt<T extends Partial<OfferPlain>>(p: T): T;
 export declare function withScammerSearchTxt<T extends Partial<ScammerDocument>>(p: T): T;

package/dist/seed/_helpers/search-txt-wrappers.js

@@ -19,15 +19,37 @@ export function withEventSearchTxt(p) {
 export function withBlogSearchTxt(p) {
     return { ...p, searchTxt: buildBlogSearchTxt(p) };
 }
+/*
+ * Bounded by `ReviewPlain` for the same reason as the offer wrapper: seed
+ * fixtures hold plaintext and `seed-cli` encrypts on write, and
+ * `string`/`Encrypted<string>` are incompatible in both directions.
+ * `buildReviewSearchTxt` deliberately does NOT read `userName` — it is
+ * encrypted, and indexing it would undo the encryption (D1).
+ */
 export function withReviewSearchTxt(p) {
     return { ...p, searchTxt: buildReviewSearchTxt(p) };
 }
+/*
+ * Bounded by `OrderPlain`: seed fixtures hold plaintext and `seed-cli`
+ * encrypts on write. `buildOrderSearchTxt` reads the product, store, tracking
+ * number, items and location — never `userEmail` (D1).
+ */
 export function withOrderSearchTxt(p) {
     return { ...p, searchTxt: buildOrderSearchTxt(p) };
 }
 export function withCouponSearchTxt(p) {
     return { ...p, searchTxt: buildCouponSearchTxt(p) };
 }
+/*
+ * Bounded by `OfferPlain`, not `OfferDocument`.
+ *
+ * Seed fixtures hold plaintext and `seed-cli` encrypts on write, so the array
+ * this maps over is `Partial<OfferPlain>[]`. `string` and `Encrypted<string>`
+ * are incompatible in both directions, so a document-bounded generic rejects
+ * the plain shape outright. The function reads `buyerName` for tokens and does
+ * not care which it gets — and `buildOfferSearchTxt` is deliberately given the
+ * PLAINTEXT one: tokenising ciphertext would index base64.
+ */
 export function withOfferSearchTxt(p) {
     return { ...p, searchTxt: buildOfferSearchTxt(p) };
 }

package/dist/seed/addresses-seed-data.d.ts

@@ -1,2 +1,2 @@
-import type { AddressDocument } from "../features/addresses/schemas/firestore";
-export declare const addressesSeedData: AddressDocument[];
+import type { AddressPlain } from "../features/addresses/schemas/firestore";
+export declare const addressesSeedData: AddressPlain[];

package/dist/seed/authenticity-knowledge-seed-data.d.ts

@@ -0,0 +1,78 @@
+export declare const AUTHENTICITY_KNOWLEDGE_COLLECTION = "authenticityKnowledge";
+/** A date-code row, its reverse per-model row, a generation summary, a series-production window, or (future) a marque. */
+export type AuthenticityKnowledgeKind = "date-code" | "model-codes" | "generation" | "series-window" | "marque";
+/**
+ * What the community has recorded about a box code.
+ *
+ * 🛑 `recorded-midfake` is a statement about a BATCH, never about a seller, and
+ * never "counterfeit". A midfake is Takara-Tomy-blueprint product of reduced
+ * quality and there is no official Takara Tomy statement acknowledging the runs.
+ *
+ * 🛑 `contested` is not a weaker midfake — it means two sources assert OPPOSITE
+ * things about the same code. Quoting either side of one as the answer is how
+ * this collection would be used to accuse the holder of a genuine box, or to
+ * reassure the holder of a fake. Report both.
+ */
+export type AuthenticityCodeVerdict = "recorded-original" | "recorded-midfake" | "contested" | "unresolved";
+export interface AuthenticityKnowledgeDocument {
+    id: string;
+    kind: AuthenticityKnowledgeKind;
+    seedPurpose: "permanent";
+    /** date-code rows only. */
+    code?: string;
+    verdict?: AuthenticityCodeVerdict;
+    products?: string[];
+    /** Regions of sale: Japan, Taiwan (Funbox Toys), Korea (Sonokong), … */
+    regions?: string[];
+    /** Starter / Booster / Random Booster Vol. N, where a source stated it. */
+    packaging?: string[];
+    /** Per-batch observations: mould variants, importer stickers, launcher colour. */
+    notes?: string[];
+    /** Midfake rows: taiwan-batch | sonokong-highquality | chinese-font. */
+    families?: string[];
+    /** Which archived source files carry this row. */
+    sources?: string[];
+    /** The source itself hedged — a blurry photo, or two codes it could not separate. */
+    uncertain?: boolean;
+    /** Derived FROM the code under the disputed month-day-year reading. */
+    derivedDate?: string | null;
+    /** True where the source's own written date contradicts its own stated rule. */
+    sourceDateDiffers?: boolean;
+    /**
+     * The bey(s) this code is recorded against, as CATEGORY LEAF ids — the same
+     * id the model's own page, its search hit and its imagery all use.
+     *
+     * 🛑 A code resolving to no model is NORMAL and is not a defect in the row:
+     * the source may have named a bey the canonical corpus has no entry for, or
+     * named a Random Booster rather than a bey. Those labels are kept in
+     * `unlinkedProducts` so the gap is visible instead of looking like nothing
+     * was ever recorded.
+     */
+    modelSlugs?: string[];
+    categoryIds?: string[];
+    unlinkedProducts?: string[];
+    /** `contested` rows only: which source is on which side. */
+    recordedOriginalBy?: string[];
+    recordedMidfakeBy?: string[];
+    generation?: string;
+    /** `model-codes` rows only — the reverse index, keyed by category leaf. */
+    modelSlug?: string;
+    categoryId?: string;
+    retailCode?: string | null;
+    originalCodes?: string[];
+    midfakeCodes?: string[];
+    contestedCodes?: string[];
+    unclearCodes?: string[];
+    /** generation rows only. */
+    canonicalReleaseCount?: number;
+    releasesWithRetailCode?: number;
+    exampleCodes?: string[];
+    hasDateCodeTable?: boolean;
+    /** series-window rows only. `name`/`generation` are shared with other kinds above. */
+    name?: string;
+    startLabel?: string;
+    endLabel?: string;
+}
+export declare const authenticityKnowledgeSeedData: AuthenticityKnowledgeDocument[];
+/** Asserted downstream so a silent drop is loud. */
+export declare const AUTHENTICITY_KNOWLEDGE_COUNT = 565;