@seedprotocol/react 0.4.18 → 0.4.21

package/dist/item.d.ts

@@ -23,6 +23,16 @@ type UseItemsProps = {
     addressFilter?: 'owned' | 'watched' | 'all';
 };
 type UseItems = (props: UseItemsProps) => UseItemsReturn;
+/**
+ * Lists items for an optional model (and filters) with TanStack Query plus a SQLite live query.
+ *
+ * - This hook uses `staleTime: 0` on its query so the list does not inherit Seed’s default
+ *   long freshness window; local data is kept in sync via live-query invalidation, and remounts
+ *   can refetch when the cache is stale.
+ * - Schema-backed fields on each `IItem` (e.g. list relation properties) read from the item
+ *   machine and may be `undefined` until that property is loaded; normalize for forms
+ *   (e.g. `Array.isArray(x) ? x : []`).
+ */
 export declare const useItems: UseItems;
 export type UseCreateItemReturn = {
     createItem: (modelName: string, itemData?: Record<string, any>) => Promise<Item<any> | undefined>;

package/dist/item.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../src/item.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6C,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAa9C,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI;IAC7C,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,OAAO,GAAG,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA;AAElF,eAAO,MAAM,OAAO,EAAE,OA6IrB,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;CAC5C,CAAA;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,cAAc,CAAA;AASxD,eAAO,MAAM,QAAQ,EAAE,QAqKtB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;IACjG,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,mBAyChC,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,KAAK,IAAI,CAAA;IAClD,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,oBAsDjC,CAAA"}
+{"version":3,"file":"item.d.ts","sourceRoot":"","sources":["../src/item.ts"],"names":[],"mappings":"AAEA,OAAO,EAA6C,IAAI,EAAE,MAAM,mBAAmB,CAAA;AAGnF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAA;AAEpD,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,mBAAmB,CAAA;AAc9C,KAAK,aAAa,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,IAAI;IAC7C,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,SAAS,CAAA;IAC1B,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,YAAY,GAAG;IAClB,SAAS,EAAE,MAAM,CAAA;IACjB,WAAW,CAAC,EAAE,MAAM,CAAA;IACpB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB,CAAA;AAED,KAAK,OAAO,GAAG,CAAC,CAAC,SAAS,WAAW,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,KAAK,aAAa,CAAC,CAAC,CAAC,CAAA;AAElF,eAAO,MAAM,OAAO,EAAE,OA8IrB,CAAA;AAED,KAAK,cAAc,GAAG;IACpB,KAAK,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,CAAA;IACnB,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;CACpB,CAAA;AAED,KAAK,aAAa,GAAG;IACnB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,aAAa,CAAC,EAAE,OAAO,GAAG,SAAS,GAAG,KAAK,CAAA;CAC5C,CAAA;AAED,KAAK,QAAQ,GAAG,CAAC,KAAK,EAAE,aAAa,KAAK,cAAc,CAAA;AAmBxD;;;;;;;;;GASG;AACH,eAAO,MAAM,QAAQ,EAAE,QAoLtB,CAAA;AAED,MAAM,MAAM,mBAAmB,GAAG;IAChC,UAAU,EAAE,CAAC,SAAS,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,CAAA;IACjG,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,aAAa,QAAO,mBAyChC,CAAA;AAED,KAAK,oBAAoB,GAAG;IAC1B,WAAW,EAAE,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,SAAS,KAAK,IAAI,CAAA;IAClD,SAAS,EAAE,OAAO,CAAA;IAClB,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,UAAU,EAAE,MAAM,IAAI,CAAA;CACvB,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,oBAsDjC,CAAA"}

package/dist/useNormalizedFeedItemFields.d.ts

@@ -0,0 +1,7 @@
+import { FeedFieldManifest, NormalizedFeedFieldValue } from '@seedprotocol/sdk';
+/**
+ * Synchronously classify feed item fields from a manifest (no network).
+ * Memoized; pass a stable `manifest` reference when possible.
+ */
+export declare function useNormalizedFeedItemFields(item: Record<string, unknown> | null | undefined, manifest: FeedFieldManifest): Record<string, NormalizedFeedFieldValue | undefined>;
+//# sourceMappingURL=useNormalizedFeedItemFields.d.ts.map

package/dist/useNormalizedFeedItemFields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useNormalizedFeedItemFields.d.ts","sourceRoot":"","sources":["../src/useNormalizedFeedItemFields.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,iBAAiB,EACtB,KAAK,wBAAwB,EAC9B,MAAM,mBAAmB,CAAA;AAE1B;;;GAGG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,EAChD,QAAQ,EAAE,iBAAiB,GAC1B,MAAM,CAAC,MAAM,EAAE,wBAAwB,GAAG,SAAS,CAAC,CAOtD"}

package/dist/useResolvedMediaRef.d.ts

@@ -0,0 +1,19 @@
+import { ResolveMediaRefOptions, ResolveMediaRefResult } from '@seedprotocol/sdk';
+export type UseResolvedMediaRefParams = {
+    value: string | undefined | null;
+    enabled?: boolean;
+} & ResolveMediaRefOptions;
+export type UseResolvedMediaRefReturn = {
+    href: string | undefined;
+    status: 'idle' | 'loading' | 'ready' | 'empty' | 'unresolved' | 'error';
+    source: 'direct' | 'gateway' | 'localBlob' | undefined;
+    error: Error | null;
+    result: ResolveMediaRefResult | null;
+    refetch: () => void;
+};
+/**
+ * Resolve a feed/XML media string (URL, Arweave tx id, seed UID, etc.) to a display URL.
+ * Use `SeedImage` when you have a synced item property from the local database.
+ */
+export declare function useResolvedMediaRef(params: UseResolvedMediaRefParams): UseResolvedMediaRefReturn;
+//# sourceMappingURL=useResolvedMediaRef.d.ts.map

package/dist/useResolvedMediaRef.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useResolvedMediaRef.d.ts","sourceRoot":"","sources":["../src/useResolvedMediaRef.ts"],"names":[],"mappings":"AACA,OAAO,EAEL,KAAK,sBAAsB,EAC3B,KAAK,qBAAqB,EAC3B,MAAM,mBAAmB,CAAA;AAE1B,MAAM,MAAM,yBAAyB,GAAG;IACtC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,CAAA;IAChC,OAAO,CAAC,EAAE,OAAO,CAAA;CAClB,GAAG,sBAAsB,CAAA;AAE1B,MAAM,MAAM,yBAAyB,GAAG;IACtC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAA;IACxB,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,GAAG,OAAO,GAAG,YAAY,GAAG,OAAO,CAAA;IACvE,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,WAAW,GAAG,SAAS,CAAA;IACtD,KAAK,EAAE,KAAK,GAAG,IAAI,CAAA;IACnB,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAAA;IACpC,OAAO,EAAE,MAAM,IAAI,CAAA;CACpB,CAAA;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,yBAAyB,GAAG,yBAAyB,CA+DhG"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@seedprotocol/react",
-  "version": "0.4.18",
+  "version": "0.4.21",
   "description": "React hooks and components for Seed Protocol",
   "type": "module",
   "main": "./dist/index.js",
@@ -44,7 +44,7 @@
     "xstate": "^5.28.0"
   },
   "devDependencies": {
-    "@seedprotocol/sdk": "0.4.18",
+    "@seedprotocol/sdk": "0.4.21",
     "vite-plugin-dts": "^4.5.4",
     "@tanstack/react-query": "^5.90.15",
     "@testing-library/react": "^16.3.1",