@siteping/widget 0.10.6 → 0.10.8

package/dist/screenshot-storage.d.cts

@@ -40,6 +40,11 @@ export interface ScreenshotStorage {
      *
      * Adapters call this synchronously inside `createFeedback` — keep it
      * fast or move to a queue if needed.
+     *
+     * **Security note:** `ctx.feedbackId` is the *client-generated* id
+     * (`clientId`) — the record id does not exist yet at upload time. Treat it
+     * as attacker-controlled: sanitize before using it in filesystem paths or
+     * object keys, even though server adapters validate its shape upstream.
      */
     upload(dataUrl: string, ctx: {
         feedbackId: string;

package/dist/screenshot-storage.d.ts

@@ -40,6 +40,11 @@ export interface ScreenshotStorage {
      *
      * Adapters call this synchronously inside `createFeedback` — keep it
      * fast or move to a queue if needed.
+     *
+     * **Security note:** `ctx.feedbackId` is the *client-generated* id
+     * (`clientId`) — the record id does not exist yet at upload time. Treat it
+     * as attacker-controlled: sanitize before using it in filesystem paths or
+     * object keys, even though server adapters validate its shape upstream.
      */
     upload(dataUrl: string, ctx: {
         feedbackId: string;

package/dist/siteping-core.d.cts

@@ -1,11 +1,17 @@
+export { EMAIL_PATTERN, isValidEmail } from "./email.cjs";
 export type { SitepingErrorCode } from "./errors.cjs";
 export { SitepingAuthError, SitepingError, SitepingNetworkError, SitepingValidationError } from "./errors.cjs";
-export type { FilterResult } from "./filters.cjs";
-export { applyFeedbackFilters } from "./filters.cjs";
+export type { FilterResult, Pagination } from "./filters.cjs";
+export { applyFeedbackFilters, clampPagination, DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT } from "./filters.cjs";
+export type { I18n, LocaleLoaders, TranslateFunction } from "./i18n.cjs";
+export { createI18n, interpolate, tWithParams } from "./i18n.cjs";
 export type { FieldDef, IndexDef, ModelDef, PrismaNativeType, PrismaScalarType, RelationDef, RelationKind, RelationOnDelete, SitepingModelFieldName, SitepingModelName, } from "./schema.cjs";
 export { isRelationField, isScalarField, SITEPING_MODELS } from "./schema.cjs";
 export type { ScreenshotStorage } from "./screenshot-storage.cjs";
-export type { AssertEqual, Brand, DeepReadonly, IfEquals, KeysOfType, NonEmptyArray, Prettify, Replace, RequiredNonNull, } from "./type-utils.cjs";
+export type { CollectionStore, CollectionStoreBackend } from "./store-helpers.cjs";
+export { buildAnnotationRecord, buildFeedbackRecord, createCollectionStore } from "./store-helpers.cjs";
+export type { AssertEqual, IfEquals, Prettify, Serialized } from "./type-utils.cjs";
 export { hasOwn, isRecord } from "./type-utils.cjs";
-export type { AnchorData, AnnotationCreateInput, AnnotationPayload, AnnotationRecord, AnnotationResponse, BuiltinLocale, ConsoleDiagnosticEntry, ConsoleDiagnosticLevel, DiagnosticsCaptureOptions, DiagnosticsSnapshot, FeedbackCreateInput, FeedbackPage, FeedbackPayload, FeedbackQuery, FeedbackRecord, FeedbackResponse, FeedbackResponseList, FeedbackStatus, FeedbackType, FeedbackUpdateInput, NetworkDiagnosticEntry, PageScope, RectData, ScreenshotRegion, SitepingConfig, SitepingDeepLinkOptions, SitepingHeadersOption, SitepingIdentity, SitepingInstance, SitepingLocale, SitepingPosition, SitepingPublicEventListener, SitepingPublicEvents, SitepingSkipReason, SitepingStore, SitepingTheme, SitepingUnsubscribe, } from "./types.cjs";
-export { BUILTIN_LOCALES, CLOSED_FEEDBACK_STATUSES, FEEDBACK_STATUSES, FEEDBACK_TYPES, flattenAnnotation, isClosedStatus, isStoreDuplicate, isStoreNotFound, isStorePersistence, StoreDuplicateError, StoreNotFoundError, StorePersistenceError, } from "./types.cjs";
+export type { AnchorData, AnnotationCreateInput, AnnotationPayload, AnnotationRecord, AnnotationResponse, BuiltinLocale, ClosedFeedbackStatus, ConsoleDiagnosticEntry, ConsoleDiagnosticLevel, DiagnosticsCaptureOptions, DiagnosticsSnapshot, FeedbackCreateInput, FeedbackPage, FeedbackPayload, FeedbackQuery, FeedbackRecord, FeedbackResponse, FeedbackResponseList, FeedbackStatus, FeedbackType, FeedbackUpdateInput, NetworkDiagnosticEntry, OpenFeedbackStatus, PageScope, RectData, ScreenshotRegion, SitepingBaseConfig, SitepingConfig, SitepingDeepLinkOptions, SitepingHeadersOption, SitepingHttpConfig, SitepingIdentity, SitepingInstance, SitepingLocale, SitepingPosition, SitepingPublicEventListener, SitepingPublicEvents, SitepingSkipReason, SitepingStore, SitepingStoreConfig, SitepingTheme, SitepingUnsubscribe, } from "./types.cjs";
+export { BUILTIN_LOCALES, CLOSED_FEEDBACK_STATUSES, CONSOLE_DIAGNOSTIC_LEVELS, FEEDBACK_STATUSES, FEEDBACK_TYPES, flattenAnnotation, isClosedStatus, isStoreDuplicate, isStoreNotFound, isStorePersistence, OPEN_FEEDBACK_STATUSES, StoreDuplicateError, StoreNotFoundError, StorePersistenceError, toFeedbackUpdate, } from "./types.cjs";
+export { errorFromResponse, feedbackQueryToSearchParams, networkErrorFromException } from "./wire.cjs";

package/dist/siteping-core.d.ts

@@ -1,11 +1,17 @@
+export { EMAIL_PATTERN, isValidEmail } from "./email.js";
 export type { SitepingErrorCode } from "./errors.js";
 export { SitepingAuthError, SitepingError, SitepingNetworkError, SitepingValidationError } from "./errors.js";
-export type { FilterResult } from "./filters.js";
-export { applyFeedbackFilters } from "./filters.js";
+export type { FilterResult, Pagination } from "./filters.js";
+export { applyFeedbackFilters, clampPagination, DEFAULT_PAGE_LIMIT, MAX_PAGE_LIMIT } from "./filters.js";
+export type { I18n, LocaleLoaders, TranslateFunction } from "./i18n.js";
+export { createI18n, interpolate, tWithParams } from "./i18n.js";
 export type { FieldDef, IndexDef, ModelDef, PrismaNativeType, PrismaScalarType, RelationDef, RelationKind, RelationOnDelete, SitepingModelFieldName, SitepingModelName, } from "./schema.js";
 export { isRelationField, isScalarField, SITEPING_MODELS } from "./schema.js";
 export type { ScreenshotStorage } from "./screenshot-storage.js";
-export type { AssertEqual, Brand, DeepReadonly, IfEquals, KeysOfType, NonEmptyArray, Prettify, Replace, RequiredNonNull, } from "./type-utils.js";
+export type { CollectionStore, CollectionStoreBackend } from "./store-helpers.js";
+export { buildAnnotationRecord, buildFeedbackRecord, createCollectionStore } from "./store-helpers.js";
+export type { AssertEqual, IfEquals, Prettify, Serialized } from "./type-utils.js";
 export { hasOwn, isRecord } from "./type-utils.js";
-export type { AnchorData, AnnotationCreateInput, AnnotationPayload, AnnotationRecord, AnnotationResponse, BuiltinLocale, ConsoleDiagnosticEntry, ConsoleDiagnosticLevel, DiagnosticsCaptureOptions, DiagnosticsSnapshot, FeedbackCreateInput, FeedbackPage, FeedbackPayload, FeedbackQuery, FeedbackRecord, FeedbackResponse, FeedbackResponseList, FeedbackStatus, FeedbackType, FeedbackUpdateInput, NetworkDiagnosticEntry, PageScope, RectData, ScreenshotRegion, SitepingConfig, SitepingDeepLinkOptions, SitepingHeadersOption, SitepingIdentity, SitepingInstance, SitepingLocale, SitepingPosition, SitepingPublicEventListener, SitepingPublicEvents, SitepingSkipReason, SitepingStore, SitepingTheme, SitepingUnsubscribe, } from "./types.js";
-export { BUILTIN_LOCALES, CLOSED_FEEDBACK_STATUSES, FEEDBACK_STATUSES, FEEDBACK_TYPES, flattenAnnotation, isClosedStatus, isStoreDuplicate, isStoreNotFound, isStorePersistence, StoreDuplicateError, StoreNotFoundError, StorePersistenceError, } from "./types.js";
+export type { AnchorData, AnnotationCreateInput, AnnotationPayload, AnnotationRecord, AnnotationResponse, BuiltinLocale, ClosedFeedbackStatus, ConsoleDiagnosticEntry, ConsoleDiagnosticLevel, DiagnosticsCaptureOptions, DiagnosticsSnapshot, FeedbackCreateInput, FeedbackPage, FeedbackPayload, FeedbackQuery, FeedbackRecord, FeedbackResponse, FeedbackResponseList, FeedbackStatus, FeedbackType, FeedbackUpdateInput, NetworkDiagnosticEntry, OpenFeedbackStatus, PageScope, RectData, ScreenshotRegion, SitepingBaseConfig, SitepingConfig, SitepingDeepLinkOptions, SitepingHeadersOption, SitepingHttpConfig, SitepingIdentity, SitepingInstance, SitepingLocale, SitepingPosition, SitepingPublicEventListener, SitepingPublicEvents, SitepingSkipReason, SitepingStore, SitepingStoreConfig, SitepingTheme, SitepingUnsubscribe, } from "./types.js";
+export { BUILTIN_LOCALES, CLOSED_FEEDBACK_STATUSES, CONSOLE_DIAGNOSTIC_LEVELS, FEEDBACK_STATUSES, FEEDBACK_TYPES, flattenAnnotation, isClosedStatus, isStoreDuplicate, isStoreNotFound, isStorePersistence, OPEN_FEEDBACK_STATUSES, StoreDuplicateError, StoreNotFoundError, StorePersistenceError, toFeedbackUpdate, } from "./types.js";
+export { errorFromResponse, feedbackQueryToSearchParams, networkErrorFromException } from "./wire.js";

package/dist/store-helpers.d.cts

@@ -0,0 +1,96 @@
+/**
+ * Record-construction helpers and the collection-store engine.
+ *
+ * Every snapshot-style adapter (memory, localStorage, flat file, KV, …)
+ * needs the same three ingredients: turn a `FeedbackCreateInput` into a
+ * `FeedbackRecord` (null-normalizing optional fields, stamping ids and
+ * timestamps), filter/paginate with `applyFeedbackFilters`, and implement
+ * the dedup/update/delete choreography of the `SitepingStore` contract.
+ *
+ * `buildFeedbackRecord` / `buildAnnotationRecord` cover the first part for
+ * any adapter. `createCollectionStore` covers all of it: give it `load`,
+ * `persist`, and `generateId`, and it returns a fully conformant
+ * `SitepingStore` — writing a new snapshot adapter is ~20 lines plus its
+ * storage specifics.
+ */
+import type { AnnotationCreateInput, AnnotationRecord, FeedbackCreateInput, FeedbackRecord, SitepingStore } from "./types.cjs";
+/**
+ * Build a persisted `AnnotationRecord` from its create input — normalizes
+ * the optional anchor fields to `null` and stamps identity/timestamp.
+ */
+export declare function buildAnnotationRecord(input: AnnotationCreateInput, ctx: {
+    id: string;
+    feedbackId: string;
+    now: Date;
+}): AnnotationRecord;
+/**
+ * Build a persisted `FeedbackRecord` (with its annotations) from a create
+ * input — normalizes every optional field to `null` and stamps ids and
+ * timestamps. Adapters without external screenshot storage keep the data
+ * URL inline on `screenshotUrl`, which is what this helper does; adapters
+ * with a `ScreenshotStorage` upload first and override `screenshotUrl`.
+ */
+export declare function buildFeedbackRecord(input: FeedbackCreateInput, ctx: {
+    id: string;
+    annotationId: () => string;
+    now?: Date;
+}): FeedbackRecord;
+/**
+ * Storage primitives behind a collection store. `load`/`persist` may be
+ * sync or async — the engine awaits both, so in-memory arrays, localStorage
+ * and async KV stores all fit the same three functions.
+ */
+export interface CollectionStoreBackend {
+    /**
+     * Return the current full snapshot of feedback records. The engine never
+     * mutates this array — handing out a live cache is safe.
+     */
+    load(): FeedbackRecord[] | Promise<FeedbackRecord[]>;
+    /**
+     * Persist the full snapshot — always a new array, never the one `load()`
+     * returned. Throw `StorePersistenceError` when the write is lost (quota,
+     * storage disabled, …) — never swallow the failure. Because the loaded
+     * snapshot is left untouched, a throw here leaves a cached `load()` result
+     * consistent with durable storage: no phantom record, no half-applied
+     * update.
+     */
+    persist(feedbacks: FeedbackRecord[]): void | Promise<void>;
+    /** Generate a unique id for a new feedback or annotation record. */
+    generateId(): string;
+}
+/**
+ * A `SitepingStore` with the optional `verifyProjectOwnership` guaranteed —
+ * what `createCollectionStore` returns.
+ */
+export type CollectionStore = SitepingStore & Required<Pick<SitepingStore, "verifyProjectOwnership">>;
+/**
+ * Build a fully conformant `SitepingStore` on top of a snapshot backend.
+ *
+ * The engine implements the whole store contract: clientId dedup (idempotent
+ * create), newest-first ordering, the standard filter/pagination pipeline,
+ * `StoreNotFoundError` on missing update/delete, project-scoped bulk delete,
+ * and `verifyProjectOwnership`. The snapshot returned by `load` is never
+ * mutated: every write hands `persist` a new array, so a failed write leaves
+ * a cached snapshot exactly as it was. When `persist` fails during `createFeedback`
+ * and the record carries an inline screenshot, the engine retries once
+ * without the screenshot (by far the heaviest field) so the text feedback
+ * survives a storage-quota hit; if that also fails, the error propagates —
+ * returning the record would claim a success that was never persisted.
+ *
+ * @example
+ * ```ts
+ * export class MemoryStore implements SitepingStore {
+ *   private feedbacks: FeedbackRecord[] = [];
+ *   private readonly store = createCollectionStore({
+ *     load: () => this.feedbacks,
+ *     persist: (next) => {
+ *       this.feedbacks = next;
+ *     },
+ *     generateId: () => crypto.randomUUID(),
+ *   });
+ *   createFeedback = this.store.createFeedback;
+ *   // …delegate the remaining methods the same way
+ * }
+ * ```
+ */
+export declare function createCollectionStore(backend: CollectionStoreBackend): CollectionStore;

package/dist/store-helpers.d.ts

@@ -0,0 +1,96 @@
+/**
+ * Record-construction helpers and the collection-store engine.
+ *
+ * Every snapshot-style adapter (memory, localStorage, flat file, KV, …)
+ * needs the same three ingredients: turn a `FeedbackCreateInput` into a
+ * `FeedbackRecord` (null-normalizing optional fields, stamping ids and
+ * timestamps), filter/paginate with `applyFeedbackFilters`, and implement
+ * the dedup/update/delete choreography of the `SitepingStore` contract.
+ *
+ * `buildFeedbackRecord` / `buildAnnotationRecord` cover the first part for
+ * any adapter. `createCollectionStore` covers all of it: give it `load`,
+ * `persist`, and `generateId`, and it returns a fully conformant
+ * `SitepingStore` — writing a new snapshot adapter is ~20 lines plus its
+ * storage specifics.
+ */
+import type { AnnotationCreateInput, AnnotationRecord, FeedbackCreateInput, FeedbackRecord, SitepingStore } from "./types.js";
+/**
+ * Build a persisted `AnnotationRecord` from its create input — normalizes
+ * the optional anchor fields to `null` and stamps identity/timestamp.
+ */
+export declare function buildAnnotationRecord(input: AnnotationCreateInput, ctx: {
+    id: string;
+    feedbackId: string;
+    now: Date;
+}): AnnotationRecord;
+/**
+ * Build a persisted `FeedbackRecord` (with its annotations) from a create
+ * input — normalizes every optional field to `null` and stamps ids and
+ * timestamps. Adapters without external screenshot storage keep the data
+ * URL inline on `screenshotUrl`, which is what this helper does; adapters
+ * with a `ScreenshotStorage` upload first and override `screenshotUrl`.
+ */
+export declare function buildFeedbackRecord(input: FeedbackCreateInput, ctx: {
+    id: string;
+    annotationId: () => string;
+    now?: Date;
+}): FeedbackRecord;
+/**
+ * Storage primitives behind a collection store. `load`/`persist` may be
+ * sync or async — the engine awaits both, so in-memory arrays, localStorage
+ * and async KV stores all fit the same three functions.
+ */
+export interface CollectionStoreBackend {
+    /**
+     * Return the current full snapshot of feedback records. The engine never
+     * mutates this array — handing out a live cache is safe.
+     */
+    load(): FeedbackRecord[] | Promise<FeedbackRecord[]>;
+    /**
+     * Persist the full snapshot — always a new array, never the one `load()`
+     * returned. Throw `StorePersistenceError` when the write is lost (quota,
+     * storage disabled, …) — never swallow the failure. Because the loaded
+     * snapshot is left untouched, a throw here leaves a cached `load()` result
+     * consistent with durable storage: no phantom record, no half-applied
+     * update.
+     */
+    persist(feedbacks: FeedbackRecord[]): void | Promise<void>;
+    /** Generate a unique id for a new feedback or annotation record. */
+    generateId(): string;
+}
+/**
+ * A `SitepingStore` with the optional `verifyProjectOwnership` guaranteed —
+ * what `createCollectionStore` returns.
+ */
+export type CollectionStore = SitepingStore & Required<Pick<SitepingStore, "verifyProjectOwnership">>;
+/**
+ * Build a fully conformant `SitepingStore` on top of a snapshot backend.
+ *
+ * The engine implements the whole store contract: clientId dedup (idempotent
+ * create), newest-first ordering, the standard filter/pagination pipeline,
+ * `StoreNotFoundError` on missing update/delete, project-scoped bulk delete,
+ * and `verifyProjectOwnership`. The snapshot returned by `load` is never
+ * mutated: every write hands `persist` a new array, so a failed write leaves
+ * a cached snapshot exactly as it was. When `persist` fails during `createFeedback`
+ * and the record carries an inline screenshot, the engine retries once
+ * without the screenshot (by far the heaviest field) so the text feedback
+ * survives a storage-quota hit; if that also fails, the error propagates —
+ * returning the record would claim a success that was never persisted.
+ *
+ * @example
+ * ```ts
+ * export class MemoryStore implements SitepingStore {
+ *   private feedbacks: FeedbackRecord[] = [];
+ *   private readonly store = createCollectionStore({
+ *     load: () => this.feedbacks,
+ *     persist: (next) => {
+ *       this.feedbacks = next;
+ *     },
+ *     generateId: () => crypto.randomUUID(),
+ *   });
+ *   createFeedback = this.store.createFeedback;
+ *   // …delegate the remaining methods the same way
+ * }
+ * ```
+ */
+export declare function createCollectionStore(backend: CollectionStoreBackend): CollectionStore;

package/dist/type-utils.d.cts

@@ -17,61 +17,30 @@
 export type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
-/**
- * Branded primitive — opaque alias safer than a raw `string` for IDs and
- * other opaque tokens. Cast through `as` at the construction boundary.
- *
- * @example
- *   type FeedbackId = Brand<string, "FeedbackId">;
- *   const id = "abc" as FeedbackId;
- */
-export type Brand<T, B extends string> = T & {
-    readonly __brand: B;
-};
-/**
- * Tuple type for arrays guaranteed to contain at least one element. Useful
- * for invariants enforced at the type system level.
- */
-export type NonEmptyArray<T> = readonly [T, ...T[]];
 /**
  * Returns `Y` when `A` is exactly assignable to `B` and vice-versa,
  * otherwise `N`. Powers compile-time equality assertions.
  */
 export type IfEquals<A, B, Y = true, N = false> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? Y : N;
 /**
- * Compile-time exact-type guard — throws a type error when `Actual` and
- * `Expected` drift apart. Use inside dead-code `void` statements to lock
- * inferred types against manually-written interfaces.
+ * Compile-time exact-type guard — resolves to `true` when `Actual` and
+ * `Expected` are identical, `never` otherwise. Assign the result to a
+ * `const _lock: AssertEqual<A, B> = true;` so any drift becomes a compile
+ * error at the declaration site.
  */
 export type AssertEqual<Actual, Expected> = IfEquals<Actual, Expected, true, never>;
 /**
- * Extract literal keys whose values match the predicate type `V`.
- * Useful to derive enums or maps from a config record.
- */
-export type KeysOfType<T, V> = {
-    [K in keyof T]-?: T[K] extends V ? K : never;
-}[keyof T];
-/**
- * Mark every property of `T` as required AND non-nullable. Stricter than
- * `Required<T>` because it also strips `null`.
+ * JSON-serialized shape of `T` — the wire form produced by `Response.json()`
+ * / `JSON.stringify`: `Date` becomes ISO `string` (nullability preserved),
+ * arrays are serialized element-wise, everything else is untouched.
+ *
+ * Used to derive the `*Response` API types from the `*Record` store types so
+ * the two can never drift: add a field to `FeedbackRecord` and
+ * `FeedbackResponse` follows automatically.
  */
-export type RequiredNonNull<T> = {
-    [K in keyof T]-?: NonNullable<T[K]>;
+export type Serialized<T> = {
+    [K in keyof T]: T[K] extends Date ? string : T[K] extends Date | null ? string | null : T[K] extends (infer U)[] ? Serialized<U>[] : T[K];
 };
-/**
- * Replace properties of `T` whose names are in `K` with the shape `R[K]`.
- * Preserves the rest. Cheaper than chaining `Omit` + `Pick`.
- */
-export type Replace<T, K extends keyof T, R extends {
-    [P in K]: unknown;
-}> = Prettify<Omit<T, K> & R>;
-/**
- * Deep readonly — recurses through arrays and plain objects, leaves
- * primitives, classes, and built-ins (Date, Map, Set, …) untouched.
- */
-export type DeepReadonly<T> = T extends (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepReadonly<U>> : T extends object ? T extends (...args: never[]) => unknown ? T : T extends Date | RegExp | Map<unknown, unknown> | Set<unknown> | Promise<unknown> ? T : {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T;
 /**
  * Type guard that narrows `value` to a non-null `Record<PropertyKey, unknown>`.
  * Useful when validating arbitrary inputs before reading fields.

package/dist/type-utils.d.ts

@@ -17,61 +17,30 @@
 export type Prettify<T> = {
     [K in keyof T]: T[K];
 } & {};
-/**
- * Branded primitive — opaque alias safer than a raw `string` for IDs and
- * other opaque tokens. Cast through `as` at the construction boundary.
- *
- * @example
- *   type FeedbackId = Brand<string, "FeedbackId">;
- *   const id = "abc" as FeedbackId;
- */
-export type Brand<T, B extends string> = T & {
-    readonly __brand: B;
-};
-/**
- * Tuple type for arrays guaranteed to contain at least one element. Useful
- * for invariants enforced at the type system level.
- */
-export type NonEmptyArray<T> = readonly [T, ...T[]];
 /**
  * Returns `Y` when `A` is exactly assignable to `B` and vice-versa,
  * otherwise `N`. Powers compile-time equality assertions.
  */
 export type IfEquals<A, B, Y = true, N = false> = (<T>() => T extends A ? 1 : 2) extends <T>() => T extends B ? 1 : 2 ? Y : N;
 /**
- * Compile-time exact-type guard — throws a type error when `Actual` and
- * `Expected` drift apart. Use inside dead-code `void` statements to lock
- * inferred types against manually-written interfaces.
+ * Compile-time exact-type guard — resolves to `true` when `Actual` and
+ * `Expected` are identical, `never` otherwise. Assign the result to a
+ * `const _lock: AssertEqual<A, B> = true;` so any drift becomes a compile
+ * error at the declaration site.
  */
 export type AssertEqual<Actual, Expected> = IfEquals<Actual, Expected, true, never>;
 /**
- * Extract literal keys whose values match the predicate type `V`.
- * Useful to derive enums or maps from a config record.
- */
-export type KeysOfType<T, V> = {
-    [K in keyof T]-?: T[K] extends V ? K : never;
-}[keyof T];
-/**
- * Mark every property of `T` as required AND non-nullable. Stricter than
- * `Required<T>` because it also strips `null`.
+ * JSON-serialized shape of `T` — the wire form produced by `Response.json()`
+ * / `JSON.stringify`: `Date` becomes ISO `string` (nullability preserved),
+ * arrays are serialized element-wise, everything else is untouched.
+ *
+ * Used to derive the `*Response` API types from the `*Record` store types so
+ * the two can never drift: add a field to `FeedbackRecord` and
+ * `FeedbackResponse` follows automatically.
  */
-export type RequiredNonNull<T> = {
-    [K in keyof T]-?: NonNullable<T[K]>;
+export type Serialized<T> = {
+    [K in keyof T]: T[K] extends Date ? string : T[K] extends Date | null ? string | null : T[K] extends (infer U)[] ? Serialized<U>[] : T[K];
 };
-/**
- * Replace properties of `T` whose names are in `K` with the shape `R[K]`.
- * Preserves the rest. Cheaper than chaining `Omit` + `Pick`.
- */
-export type Replace<T, K extends keyof T, R extends {
-    [P in K]: unknown;
-}> = Prettify<Omit<T, K> & R>;
-/**
- * Deep readonly — recurses through arrays and plain objects, leaves
- * primitives, classes, and built-ins (Date, Map, Set, …) untouched.
- */
-export type DeepReadonly<T> = T extends (infer U)[] ? ReadonlyArray<DeepReadonly<U>> : T extends ReadonlyArray<infer U> ? ReadonlyArray<DeepReadonly<U>> : T extends object ? T extends (...args: never[]) => unknown ? T : T extends Date | RegExp | Map<unknown, unknown> | Set<unknown> | Promise<unknown> ? T : {
-    readonly [K in keyof T]: DeepReadonly<T[K]>;
-} : T;
 /**
  * Type guard that narrows `value` to a non-null `Record<PropertyKey, unknown>`.
  * Useful when validating arbitrary inputs before reading fields.