@siteping/widget 0.10.7 → 0.10.8

package/dist/siteping-core.d.cts

@@ -1,7 +1,8 @@
+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";

package/dist/siteping-core.d.ts

@@ -1,7 +1,8 @@
+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";

package/dist/store-helpers.d.cts

@@ -41,11 +41,18 @@ export declare function buildFeedbackRecord(input: FeedbackCreateInput, ctx: {
  * and async KV stores all fit the same three functions.
  */
 export interface CollectionStoreBackend {
-    /** Return the current full snapshot of feedback records. */
+    /**
+     * 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. Throw `StorePersistenceError` when the write
-     * is lost (quota, storage disabled, …) — never swallow the failure.
+     * 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. */
@@ -62,7 +69,9 @@ export type CollectionStore = SitepingStore & Required<Pick<SitepingStore, "veri
  * 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`. When `persist` fails during `createFeedback`
+ * 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 —

package/dist/store-helpers.d.ts

@@ -41,11 +41,18 @@ export declare function buildFeedbackRecord(input: FeedbackCreateInput, ctx: {
  * and async KV stores all fit the same three functions.
  */
 export interface CollectionStoreBackend {
-    /** Return the current full snapshot of feedback records. */
+    /**
+     * 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. Throw `StorePersistenceError` when the write
-     * is lost (quota, storage disabled, …) — never swallow the failure.
+     * 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. */
@@ -62,7 +69,9 @@ export type CollectionStore = SitepingStore & Required<Pick<SitepingStore, "veri
  * 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`. When `persist` fails during `createFeedback`
+ * 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 —

package/dist/types.d.cts

@@ -595,7 +595,7 @@ export interface AnnotationRecord {
  */
 export declare class StoreNotFoundError extends Error {
     readonly code: "STORE_NOT_FOUND";
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }
 /**
  * Thrown when a unique constraint is violated (e.g. duplicate `clientId`).
@@ -604,7 +604,7 @@ export declare class StoreNotFoundError extends Error {
  */
 export declare class StoreDuplicateError extends Error {
     readonly code: "STORE_DUPLICATE";
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }
 /**
  * Thrown when a store accepts a mutation but cannot persist it — e.g.

package/dist/types.d.ts

@@ -595,7 +595,7 @@ export interface AnnotationRecord {
  */
 export declare class StoreNotFoundError extends Error {
     readonly code: "STORE_NOT_FOUND";
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }
 /**
  * Thrown when a unique constraint is violated (e.g. duplicate `clientId`).
@@ -604,7 +604,7 @@ export declare class StoreNotFoundError extends Error {
  */
 export declare class StoreDuplicateError extends Error {
     readonly code: "STORE_DUPLICATE";
-    constructor(message?: string);
+    constructor(message?: string, options?: ErrorOptions);
 }
 /**
  * Thrown when a store accepts a mutation but cannot persist it — e.g.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@siteping/widget",
-  "version": "0.10.7",
+  "version": "0.10.8",
   "description": "Feedback widget for client review during development — annotations, bugs, questions directly on the site",
   "type": "module",
   "sideEffects": false,
@@ -79,9 +79,9 @@
     "@siteping/core": "workspace:*",
     "@size-limit/preset-small-lib": "^12.1.0",
     "@testing-library/react": "^16.3.2",
-    "@types/react": "^19.2.17",
-    "@types/react-dom": "^19.2.3",
-    "esbuild": "^0.28.1",
+    "@types/react": "^19.2.18",
+    "@types/react-dom": "^19.2.5",
+    "esbuild": "^0.28.2",
     "react": "^19.2.7",
     "react-dom": "^19.2.7",
     "size-limit": "^12.1.0"