@nivaro/react 0.1.269 → 0.1.271

package/dist/index.d.ts

@@ -421,6 +421,20 @@ declare interface BulkTarget {
     id: string | number;
 }
 
+/**
+ * "Updated 3m ago · Refresh" for a cached figure.
+ *
+ * A cache the viewer cannot see is a number they cannot trust: without this
+ * a report served from Redis is indistinguishable from one just computed.
+ * Renders nothing for an uncached query — there is nothing to disclose.
+ */
+export declare function CacheStamp({ envelope, onRefresh, refreshing, className }: {
+    envelope: CustomQueryEnvelope | undefined;
+    onRefresh?: () => void;
+    refreshing?: boolean;
+    className?: string;
+}): JSX.Element | null;
+
 export declare function canOpenCatalogItem(collection: string | null | undefined): boolean;
 
 export declare function canOpenChatRoom(): boolean;
@@ -1005,6 +1019,21 @@ export declare function CustomActionButtons({ collection, itemId, draft }: {
     draft: Record<string, unknown>;
 }): JSX.Element | null;
 
+/**
+ * The envelope `POST /custom-queries/:slug/execute` returns. Older servers
+ * answer with `data`/`cached` only, so every cache field is optional and the
+ * stamp simply renders nothing when they are absent.
+ */
+declare interface CustomQueryEnvelope {
+    data: Array<Record<string, unknown>>;
+    cached?: boolean;
+    cached_at?: string | null;
+    age_seconds?: number | null;
+    expires_in_seconds?: number | null;
+    cache_ttl?: number | null;
+    executed_at?: string | null;
+}
+
 /** `nivaro_users.preferences.custom_status` — free text + emoji beside the
  *  presence state, self-clearing at `expires_at`. */
 export declare type CustomStatus = {