@lockerverse/react 0.2.127-dev.1 → 0.2.129-dev.1

package/dist/auction-data.d.ts

@@ -1,4 +1,4 @@
-import { n as useLockerverseAuctions, t as UseLockerverseAuctionsResult } from "./use-lockerverse-auctions.js";
+import { n as useLockerverseAuctions, r as AuctionRefreshOptions, t as UseLockerverseAuctionsResult } from "./use-lockerverse-auctions.js";
 import { CreateLockerverseAuctionOptions, LockerverseAuction, LockerverseAuctionClient, LockerverseSdkError } from "@lockerverse/sdk/auctions";
 //#region src/use-lockerverse-auction.d.ts
 type UseLockerverseAuctionResult = {
@@ -10,7 +10,7 @@ type UseLockerverseAuctionResult = {
   refresh: () => void;
 };
 /** Load one auction by slug without requesting the community auction list. */
-declare function useLockerverseAuction(options: CreateLockerverseAuctionOptions, auctionSlug: string): UseLockerverseAuctionResult;
+declare function useLockerverseAuction(options: CreateLockerverseAuctionOptions, auctionSlug: string, refreshOptions?: AuctionRefreshOptions): UseLockerverseAuctionResult;
 //#endregion
-export { type UseLockerverseAuctionResult, type UseLockerverseAuctionsResult, useLockerverseAuction, useLockerverseAuctions };
+export { type AuctionRefreshOptions, type UseLockerverseAuctionResult, type UseLockerverseAuctionsResult, useLockerverseAuction, useLockerverseAuctions };
 //# sourceMappingURL=auction-data.d.ts.map

package/dist/auction-data.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"auction-data.d.ts","names":[],"sources":["../src/use-lockerverse-auction.ts"],"mappings":";;;KAUY;EACV,QAAQ;;EAER,SAAS;EACT;EACA,OAAO;EACP;;;iBAIc,sBACd,SAAS,iCACT,sBACC"}
+{"version":3,"file":"auction-data.d.ts","names":[],"sources":["../src/use-lockerverse-auction.ts"],"mappings":";;;KAcY;EACV,QAAQ;;EAER,SAAS;EACT;EACA,OAAO;EACP;;;iBAIc,sBACd,SAAS,iCACT,qBACA,iBAAgB,wBACf"}

package/dist/auction-data.js

@@ -1,2 +1,2 @@
-import{t as e}from"./immutable-resource-identity.js";import{t}from"./use-lockerverse-auctions.js";import{useCallback as n,useEffect as r,useRef as i,useState as a}from"react";import{createLockerverseAuctionClient as o}from"@lockerverse/sdk/auctions";function s(t,s){e(`auction`,{apiBaseUrl:t.apiBaseUrl,communitySlug:t.communitySlug,environment:t.environment,mediaBaseUrl:t.mediaBaseUrl,slug:s});let c=i(t.onError);c.current=t.onError;let[l]=a(()=>o({...t,onError:e=>c.current?.(e)})),u=i(0),[d,f]=a(0),[p,m]=a({auction:null,error:null,loading:!0});r(()=>{let e=!0,t=u.current;return l.load(s).then(n=>{e&&t===u.current&&m({auction:n,error:null,loading:!1})},n=>{e&&t===u.current&&m(e=>({...e,error:n,loading:!1}))}),()=>{e=!1}},[l,s,d]);let h=n(()=>{u.current+=1,m(e=>({...e,error:null,loading:!0})),f(e=>e+1)},[]);return{...p,client:l,refresh:h}}export{s as useLockerverseAuction,t as useLockerverseAuctions};
+import{t as e}from"./immutable-resource-identity.js";import{n as t,t as n}from"./use-lockerverse-auctions.js";import{useCallback as r,useEffect as i,useRef as a,useState as o}from"react";import{createLockerverseAuctionClient as s}from"@lockerverse/sdk/auctions";function c(n,c,l={}){e(`auction`,{apiBaseUrl:n.apiBaseUrl,communitySlug:n.communitySlug,environment:n.environment,mediaBaseUrl:n.mediaBaseUrl,slug:c});let u=a(n.onError);u.current=n.onError;let[d]=o(()=>s({...n,onError:e=>u.current?.(e)})),f=a(0),[p,m]=o(0),[h,g]=o({auction:null,error:null,loading:!0}),_=r(()=>{f.current+=1,g(e=>({...e,error:null,loading:!0})),m(e=>e+1)},[]),v=t(_,l);return i(()=>{let e=!0,t=f.current,n=v();return d.load(c).then(n=>{e&&t===f.current&&g({auction:n,error:null,loading:!1})},n=>{e&&t===f.current&&g(e=>({...e,error:n,loading:!1}))}).finally(n),()=>{e=!1}},[d,c,p,v]),{...h,client:d,refresh:_}}export{c as useLockerverseAuction,n as useLockerverseAuctions};
 //# sourceMappingURL=auction-data.js.map

package/dist/auction-data.js.map

@@ -1 +1 @@
-{"version":3,"file":"auction-data.js","names":[],"sources":["../src/use-lockerverse-auction.ts"],"sourcesContent":["import {\n  type CreateLockerverseAuctionOptions,\n  createLockerverseAuctionClient,\n  type LockerverseAuction,\n  type LockerverseAuctionClient,\n  type LockerverseSdkError,\n} from \"@lockerverse/sdk/auctions\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useImmutableResourceIdentity } from \"./immutable-resource-identity.ts\";\n\nexport type UseLockerverseAuctionResult = {\n  client: LockerverseAuctionClient;\n  /** Last successful snapshot, retained during refresh and refresh errors. */\n  auction: LockerverseAuction | null;\n  loading: boolean;\n  error: LockerverseSdkError | null;\n  refresh: () => void;\n};\n\n/** Load one auction by slug without requesting the community auction list. */\nexport function useLockerverseAuction(\n  options: CreateLockerverseAuctionOptions,\n  auctionSlug: string\n): UseLockerverseAuctionResult {\n  useImmutableResourceIdentity(\"auction\", {\n    apiBaseUrl: options.apiBaseUrl,\n    communitySlug: options.communitySlug,\n    environment: options.environment,\n    mediaBaseUrl: options.mediaBaseUrl,\n    slug: auctionSlug,\n  });\n  const onErrorRef = useRef(options.onError);\n  onErrorRef.current = options.onError;\n  const [client] = useState(() =>\n    createLockerverseAuctionClient({\n      ...options,\n      onError: (error) => onErrorRef.current?.(error),\n    })\n  );\n  const generation = useRef(0);\n  const [revision, setRevision] = useState(0);\n  const [state, setState] = useState<\n    Pick<UseLockerverseAuctionResult, \"auction\" | \"loading\" | \"error\">\n  >({ auction: null, error: null, loading: true });\n\n  useEffect(() => {\n    let active = true;\n    const requestGeneration = generation.current;\n    client.load(auctionSlug).then(\n      (auction) => {\n        if (active && requestGeneration === generation.current) {\n          setState({ auction, error: null, loading: false });\n        }\n      },\n      (error: LockerverseSdkError) => {\n        if (active && requestGeneration === generation.current) {\n          setState((current) => ({ ...current, error, loading: false }));\n        }\n      }\n    );\n    return () => {\n      active = false;\n    };\n  }, [client, auctionSlug, revision]);\n\n  const refresh = useCallback(() => {\n    generation.current += 1;\n    setState((current) => ({ ...current, error: null, loading: true }));\n    setRevision((current) => current + 1);\n  }, []);\n\n  return { ...state, client, refresh };\n}\n"],"mappings":"0PAoBA,SAAgB,EACd,EACA,EAC6B,CAC7B,EAA6B,UAAW,CACtC,WAAY,EAAQ,WACpB,cAAe,EAAQ,cACvB,YAAa,EAAQ,YACrB,aAAc,EAAQ,aACtB,KAAM,CACR,CAAC,EACD,IAAM,EAAa,EAAO,EAAQ,OAAO,EACzC,EAAW,QAAU,EAAQ,QAC7B,GAAM,CAAC,GAAU,MACf,EAA+B,CAC7B,GAAG,EACH,QAAU,GAAU,EAAW,UAAU,CAAK,CAChD,CAAC,CACH,EACM,EAAa,EAAO,CAAC,EACrB,CAAC,EAAU,GAAe,EAAS,CAAC,EACpC,CAAC,EAAO,GAAY,EAExB,CAAE,QAAS,KAAM,MAAO,KAAM,QAAS,EAAK,CAAC,EAE/C,MAAgB,CACd,IAAI,EAAS,GACP,EAAoB,EAAW,QAarC,OAZA,EAAO,KAAK,CAAW,CAAC,CAAC,KACtB,GAAY,CACP,GAAU,IAAsB,EAAW,SAC7C,EAAS,CAAE,UAAS,MAAO,KAAM,QAAS,EAAM,CAAC,CAErD,EACC,GAA+B,CAC1B,GAAU,IAAsB,EAAW,SAC7C,EAAU,IAAa,CAAE,GAAG,EAAS,QAAO,QAAS,EAAM,EAAE,CAEjE,CACF,MACa,CACX,EAAS,EACX,CACF,EAAG,CAAC,EAAQ,EAAa,CAAQ,CAAC,EAElC,IAAM,EAAU,MAAkB,CAChC,EAAW,SAAW,EACtB,EAAU,IAAa,CAAE,GAAG,EAAS,MAAO,KAAM,QAAS,EAAK,EAAE,EAClE,EAAa,GAAY,EAAU,CAAC,CACtC,EAAG,CAAC,CAAC,EAEL,MAAO,CAAE,GAAG,EAAO,SAAQ,SAAQ,CACrC"}
+{"version":3,"file":"auction-data.js","names":[],"sources":["../src/use-lockerverse-auction.ts"],"sourcesContent":["import {\n  type CreateLockerverseAuctionOptions,\n  createLockerverseAuctionClient,\n  type LockerverseAuction,\n  type LockerverseAuctionClient,\n  type LockerverseSdkError,\n} from \"@lockerverse/sdk/auctions\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useImmutableResourceIdentity } from \"./immutable-resource-identity.ts\";\nimport {\n  type AuctionRefreshOptions,\n  useAuctionReturnRefresh,\n} from \"./use-auction-return-refresh.ts\";\n\nexport type UseLockerverseAuctionResult = {\n  client: LockerverseAuctionClient;\n  /** Last successful snapshot, retained during refresh and refresh errors. */\n  auction: LockerverseAuction | null;\n  loading: boolean;\n  error: LockerverseSdkError | null;\n  refresh: () => void;\n};\n\n/** Load one auction by slug without requesting the community auction list. */\nexport function useLockerverseAuction(\n  options: CreateLockerverseAuctionOptions,\n  auctionSlug: string,\n  refreshOptions: AuctionRefreshOptions = {}\n): UseLockerverseAuctionResult {\n  useImmutableResourceIdentity(\"auction\", {\n    apiBaseUrl: options.apiBaseUrl,\n    communitySlug: options.communitySlug,\n    environment: options.environment,\n    mediaBaseUrl: options.mediaBaseUrl,\n    slug: auctionSlug,\n  });\n  const onErrorRef = useRef(options.onError);\n  onErrorRef.current = options.onError;\n  const [client] = useState(() =>\n    createLockerverseAuctionClient({\n      ...options,\n      onError: (error) => onErrorRef.current?.(error),\n    })\n  );\n  const generation = useRef(0);\n  const [revision, setRevision] = useState(0);\n  const [state, setState] = useState<\n    Pick<UseLockerverseAuctionResult, \"auction\" | \"loading\" | \"error\">\n  >({ auction: null, error: null, loading: true });\n\n  const refresh = useCallback(() => {\n    generation.current += 1;\n    setState((current) => ({ ...current, error: null, loading: true }));\n    setRevision((current) => current + 1);\n  }, []);\n  const startRead = useAuctionReturnRefresh(refresh, refreshOptions);\n\n  useEffect(() => {\n    let active = true;\n    const requestGeneration = generation.current;\n    const settleRead = startRead();\n    client\n      .load(auctionSlug)\n      .then(\n        (auction) => {\n          if (active && requestGeneration === generation.current) {\n            setState({ auction, error: null, loading: false });\n          }\n        },\n        (error: LockerverseSdkError) => {\n          if (active && requestGeneration === generation.current) {\n            setState((current) => ({ ...current, error, loading: false }));\n          }\n        }\n      )\n      .finally(settleRead);\n    return () => {\n      active = false;\n    };\n  }, [client, auctionSlug, revision, startRead]);\n\n  return { ...state, client, refresh };\n}\n"],"mappings":"sQAwBA,SAAgB,EACd,EACA,EACA,EAAwC,CAAC,EACZ,CAC7B,EAA6B,UAAW,CACtC,WAAY,EAAQ,WACpB,cAAe,EAAQ,cACvB,YAAa,EAAQ,YACrB,aAAc,EAAQ,aACtB,KAAM,CACR,CAAC,EACD,IAAM,EAAa,EAAO,EAAQ,OAAO,EACzC,EAAW,QAAU,EAAQ,QAC7B,GAAM,CAAC,GAAU,MACf,EAA+B,CAC7B,GAAG,EACH,QAAU,GAAU,EAAW,UAAU,CAAK,CAChD,CAAC,CACH,EACM,EAAa,EAAO,CAAC,EACrB,CAAC,EAAU,GAAe,EAAS,CAAC,EACpC,CAAC,EAAO,GAAY,EAExB,CAAE,QAAS,KAAM,MAAO,KAAM,QAAS,EAAK,CAAC,EAEzC,EAAU,MAAkB,CAChC,EAAW,SAAW,EACtB,EAAU,IAAa,CAAE,GAAG,EAAS,MAAO,KAAM,QAAS,EAAK,EAAE,EAClE,EAAa,GAAY,EAAU,CAAC,CACtC,EAAG,CAAC,CAAC,EACC,EAAY,EAAwB,EAAS,CAAc,EA0BjE,OAxBA,MAAgB,CACd,IAAI,EAAS,GACP,EAAoB,EAAW,QAC/B,EAAa,EAAU,EAgB7B,OAfA,EACG,KAAK,CAAW,CAAC,CACjB,KACE,GAAY,CACP,GAAU,IAAsB,EAAW,SAC7C,EAAS,CAAE,UAAS,MAAO,KAAM,QAAS,EAAM,CAAC,CAErD,EACC,GAA+B,CAC1B,GAAU,IAAsB,EAAW,SAC7C,EAAU,IAAa,CAAE,GAAG,EAAS,QAAO,QAAS,EAAM,EAAE,CAEjE,CACF,CAAC,CACA,QAAQ,CAAU,MACR,CACX,EAAS,EACX,CACF,EAAG,CAAC,EAAQ,EAAa,EAAU,CAAS,CAAC,EAEtC,CAAE,GAAG,EAAO,SAAQ,SAAQ,CACrC"}

package/dist/auctions.d.ts

@@ -1,4 +1,4 @@
-import { n as useLockerverseAuctions, t as UseLockerverseAuctionsResult } from "./use-lockerverse-auctions.js";
+import { n as useLockerverseAuctions, r as AuctionRefreshOptions, t as UseLockerverseAuctionsResult } from "./use-lockerverse-auctions.js";
 import { n as LockerverseTheme, t as LockerverseStyle } from "./theme.js";
 import { a as LockerverseAuctionItemRenderContext, i as LockerverseAuctionItemFilter, n as LockerverseAuctionItemCardProps, o as LockerverseAuctionProps, r as LockerverseAuction, t as LockerverseAuctionItemCard } from "./lockerverse-auction-item-card.js";
 import { LockerverseAuction as LockerverseAuction$1 } from "@lockerverse/sdk/auctions";
@@ -11,5 +11,5 @@ type LockerverseAuctionsProps = Omit<LockerverseAuctionProps, "auction" | "onBac
 /** Optional auction browser. Select an auction to show its items. */
 declare function LockerverseAuctions({ auctions, theme, style, className, showFilters, showHeader, showLineup, getAuctionHref, onSelectAuction, ...contentProps }: LockerverseAuctionsProps): import("react").JSX.Element;
 //#endregion
-export { LockerverseAuction, LockerverseAuctionItemCard, type LockerverseAuctionItemCardProps, type LockerverseAuctionItemFilter, type LockerverseAuctionItemRenderContext, type LockerverseAuctionProps, LockerverseAuctions, type LockerverseAuctionsProps, type LockerverseStyle, type LockerverseTheme, type UseLockerverseAuctionsResult, useLockerverseAuctions };
+export { type AuctionRefreshOptions, LockerverseAuction, LockerverseAuctionItemCard, type LockerverseAuctionItemCardProps, type LockerverseAuctionItemFilter, type LockerverseAuctionItemRenderContext, type LockerverseAuctionProps, LockerverseAuctions, type LockerverseAuctionsProps, type LockerverseStyle, type LockerverseTheme, type UseLockerverseAuctionsResult, useLockerverseAuctions };
 //# sourceMappingURL=auctions.d.ts.map

package/dist/auctions.js

@@ -1,2 +1,2 @@
-import{a as e,c as t,t as n}from"./use-auction-boundary.js";import{a as r,i,n as a,o,r as s,s as c,t as l}from"./lockerverse-auction.js";import{t as u}from"./use-lockerverse-auctions.js";import{ArrowRight as d,Gavel as f,ListChecks as p}from"lucide-react";import{useEffect as m,useRef as h,useState as g}from"react";import{Fragment as _,jsx as v,jsxs as y}from"react/jsx-runtime";function b({auction:a,onSelect:s,href:l}){n(a.startAt,a.endAt,a.items);let u=a.configuration.image||a.items.find(e=>e.image||e.images.length)?.image||a.items.find(e=>e.images.length)?.images[0]||a.community?.banner||a.community?.thumbnail,m=a.description||{active:`Bidding is open on available items.`,draft:`Preview the lineup before bidding opens.`,finished:`Bidding has wrapped. Review the completed items.`}[e(a)];return y(`article`,{className:`lockerverse-auctions__catalog-card`,children:[l?v(`a`,{"aria-label":`View items in ${a.name}`,className:`lockerverse-auctions__catalog-select`,"data-auction-id":a.id,href:l,onClick:e=>{s&&e.button===0&&!e.metaKey&&!e.ctrlKey&&!e.shiftKey&&!e.altKey&&(e.preventDefault(),s())},children:y(`span`,{className:`lockerverse-auctions__visually-hidden`,children:[`View items in `,a.name]})}):v(`button`,{"aria-label":`View items in ${a.name}`,className:`lockerverse-auctions__catalog-select`,"data-auction-id":a.id,onClick:s,type:`button`}),y(`div`,{className:`lockerverse-auctions__catalog-media`,children:[v(i,{fallback:u,name:a.name}),y(`div`,{className:`lockerverse-auctions__catalog-chips`,children:[v(`span`,{className:`lockerverse-auctions__catalog-chip`,children:o[e(a)]}),v(c,{auction:a})]}),y(`dl`,{className:`lockerverse-auctions__catalog-metrics`,children:[v(r,{icon:v(p,{"aria-hidden":`true`,size:16}),label:`Items`,value:String(a.items.length)}),v(r,{icon:v(f,{"aria-hidden":`true`,size:16}),label:`Bids`,value:String(a.items.reduce((e,t)=>e+t.bidCount,0))})]})]}),y(`div`,{className:`lockerverse-auctions__catalog-body`,children:[v(`h3`,{children:a.name}),v(t,{className:`lockerverse-auctions__catalog-description`,description:m}),y(`div`,{className:`lockerverse-auctions__catalog-footer`,children:[v(`span`,{className:`lockerverse-auctions__catalog-cta`,children:e(a)===`draft`?`Preview items`:`View items`}),v(`span`,{className:`lockerverse-auctions__catalog-arrow`,children:v(d,{"aria-hidden":`true`,size:16})})]})]})]})}function x({auctions:e,theme:t=`dark`,style:n,className:r,showFilters:i=!0,showHeader:a=!0,showLineup:o=!0,getAuctionHref:s,onSelectAuction:c,...u}){let[d,f]=g(null),p=h(null),_=h(null),b=h(d),x=e.auctions?.find(e=>e.id===d);return m(()=>{if(b.current!==d){if(d===null){let e=[..._.current?.querySelectorAll(`button[data-auction-id]`)??[]].find(e=>e.dataset.auctionId===b.current);(p.current??e??_.current)?.focus()}b.current=d}},[d]),y(`section`,{"aria-busy":e.loading,"aria-label":`Auctions`,className:[`lockerverse-auctions`,`lockerverse-auctions--catalog`,r].filter(Boolean).join(` `),"data-lockerverse-theme":t,ref:_,style:n,tabIndex:-1,children:[!x&&a?v(`header`,{className:`lockerverse-auctions__catalog-header`,children:v(`h2`,{ref:p,tabIndex:-1,children:`Auctions`})}):null,e.loading?v(`p`,{role:`status`,children:`Loading auctions…`}):null,e.error?y(`div`,{role:`alert`,children:[v(`p`,{children:e.error.message}),v(`button`,{onClick:e.refresh,type:`button`,children:`Try again`})]}):null,x?v(l,{auction:x,onBack:()=>f(null),...u,showFilters:i,showHeader:a,showLineup:o,theme:t,...n?{style:n}:{}},x.id):v(S,{auctions:e.auctions,onSelectAuction:e=>{c?c(e):f(e.id)},...s?{getAuctionHref:s}:{},interceptLinks:!!c,showLineup:o})]})}function S({auctions:e,showLineup:t,onSelectAuction:n,getAuctionHref:r,interceptLinks:i}){return e?e.length?y(_,{children:[t?y(`div`,{className:`lockerverse-auctions__catalog-lineup`,children:[y(`div`,{children:[v(`h3`,{children:`Auction lineup`}),v(`p`,{children:`Browse the current collection.`})]}),y(`span`,{children:[e.length,` `,e.length===1?`auction`:`auctions`]})]}):null,v(`ul`,{className:`lockerverse-auctions__catalog-grid`,children:e.map(e=>v(`li`,{children:v(b,{auction:e,...r?{href:r(e)}:{},...!r||i?{onSelect:()=>n(e)}:{}})},e.id))})]}):y(`div`,{className:`lockerverse-auctions__catalog-empty`,children:[v(`h3`,{children:`No auctions yet.`}),v(`p`,{children:`Published auctions will appear here once they are available.`})]}):null}export{a as LockerverseAuction,s as LockerverseAuctionItemCard,x as LockerverseAuctions,u as useLockerverseAuctions};
+import{a as e,c as t,t as n}from"./use-auction-boundary.js";import{a as r,i,n as a,o,r as s,s as c,t as l}from"./lockerverse-auction.js";import{t as u}from"./use-lockerverse-auctions.js";import{ArrowRight as d,Gavel as f,ListChecks as p}from"lucide-react";import{useEffect as m,useRef as h,useState as g}from"react";import{Fragment as _,jsx as v,jsxs as y}from"react/jsx-runtime";function b({auction:a,onSelect:s,href:l}){n(a.startAt,a.endAt,a.items);let u=a.configuration.image||a.items.find(e=>e.image||e.images.length)?.image||a.items.find(e=>e.images.length)?.images[0]||a.community?.banner||a.community?.thumbnail,m=a.description||{active:`Bidding is open on available items.`,draft:`Preview the lineup before bidding opens.`,finished:`Bidding has wrapped. Review the completed items.`}[e(a)];return y(`article`,{className:`lockerverse-auctions__catalog-card`,children:[l?v(`a`,{"aria-label":`View items in ${a.name}`,className:`lockerverse-auctions__catalog-select`,"data-auction-id":a.id,href:l,onClick:e=>{s&&e.button===0&&!e.metaKey&&!e.ctrlKey&&!e.shiftKey&&!e.altKey&&(e.preventDefault(),s())},children:y(`span`,{className:`lockerverse-auctions__visually-hidden`,children:[`View items in `,a.name]})}):v(`button`,{"aria-label":`View items in ${a.name}`,className:`lockerverse-auctions__catalog-select`,"data-auction-id":a.id,onClick:s,type:`button`}),y(`div`,{className:`lockerverse-auctions__catalog-media`,children:[v(i,{fallback:u,name:a.name}),y(`div`,{className:`lockerverse-auctions__catalog-chips`,children:[v(`span`,{className:`lockerverse-auctions__catalog-chip`,children:o[e(a)]}),v(c,{auction:a})]}),y(`dl`,{className:`lockerverse-auctions__catalog-metrics`,children:[v(r,{icon:v(p,{"aria-hidden":`true`,size:16}),label:`Items`,value:String(a.items.length)}),v(r,{icon:v(f,{"aria-hidden":`true`,size:16}),label:`Bids`,value:String(a.items.reduce((e,t)=>e+t.bidCount,0))})]})]}),y(`div`,{className:`lockerverse-auctions__catalog-body`,children:[v(`h3`,{children:a.name}),v(t,{className:`lockerverse-auctions__catalog-description`,description:m}),y(`div`,{className:`lockerverse-auctions__catalog-footer`,children:[v(`span`,{className:`lockerverse-auctions__catalog-cta`,children:e(a)===`draft`?`Preview items`:`View items`}),v(`span`,{className:`lockerverse-auctions__catalog-arrow`,children:v(d,{"aria-hidden":`true`,size:16})})]})]})]})}function x({auctions:e,theme:t=`dark`,style:n,className:r,showFilters:i=!0,showHeader:a=!0,showLineup:o=!0,getAuctionHref:s,onSelectAuction:c,...u}){let[d,f]=g(null),p=h(null),_=h(null),b=h(d),x=e.auctions?.find(e=>e.id===d);return m(()=>{if(b.current!==d){if(d===null){let e=[..._.current?.querySelectorAll(`button[data-auction-id]`)??[]].find(e=>e.dataset.auctionId===b.current);(p.current??e??_.current)?.focus()}b.current=d}},[d]),y(`section`,{"aria-busy":e.loading,"aria-label":`Auctions`,className:[`lockerverse-auctions`,`lockerverse-auctions--catalog`,r].filter(Boolean).join(` `),"data-lockerverse-theme":t,ref:_,style:n,tabIndex:-1,children:[!x&&a?v(`header`,{className:`lockerverse-auctions__catalog-header`,children:v(`h2`,{ref:p,tabIndex:-1,children:`Auctions`})}):null,e.loading?v(`p`,{role:`status`,children:e.auctions?`Refreshing auctions…`:`Loading auctions…`}):null,e.error?y(`div`,{role:`alert`,children:[v(`p`,{children:e.error.message}),v(`button`,{onClick:e.refresh,type:`button`,children:`Try again`})]}):null,x?v(l,{auction:x,onBack:()=>f(null),...u,showFilters:i,showHeader:a,showLineup:o,theme:t,...n?{style:n}:{}},x.id):v(S,{auctions:e.auctions,onSelectAuction:e=>{c?c(e):f(e.id)},...s?{getAuctionHref:s}:{},interceptLinks:!!c,showLineup:o})]})}function S({auctions:e,showLineup:t,onSelectAuction:n,getAuctionHref:r,interceptLinks:i}){return e?e.length?y(_,{children:[t?y(`div`,{className:`lockerverse-auctions__catalog-lineup`,children:[y(`div`,{children:[v(`h3`,{children:`Auction lineup`}),v(`p`,{children:`Browse the current collection.`})]}),y(`span`,{children:[e.length,` `,e.length===1?`auction`:`auctions`]})]}):null,v(`ul`,{className:`lockerverse-auctions__catalog-grid`,children:e.map(e=>v(`li`,{children:v(b,{auction:e,...r?{href:r(e)}:{},...!r||i?{onSelect:()=>n(e)}:{}})},e.id))})]}):y(`div`,{className:`lockerverse-auctions__catalog-empty`,children:[v(`h3`,{children:`No auctions yet.`}),v(`p`,{children:`Published auctions will appear here once they are available.`})]}):null}export{a as LockerverseAuction,s as LockerverseAuctionItemCard,x as LockerverseAuctions,u as useLockerverseAuctions};
 //# sourceMappingURL=auctions.js.map

package/dist/auctions.js.map

@@ -1 +1 @@
-{"version":3,"file":"auctions.js","names":[],"sources":["../src/lockerverse-auctions.tsx"],"sourcesContent":["import type { LockerverseAuction as Auction } from \"@lockerverse/sdk/auctions\";\nimport { ArrowRight, Gavel, ListChecks } from \"lucide-react\";\nimport { useEffect, useRef, useState } from \"react\";\nimport {\n  CatalogImage,\n  Metric,\n  STATUS_LABELS,\n  Timing,\n} from \"./auction-catalog-parts.tsx\";\nimport { AuctionDescription } from \"./auction-description.tsx\";\nimport { getAuctionDisplayStatus } from \"./auction-display.ts\";\nimport {\n  AuctionContent,\n  type LockerverseAuctionProps,\n} from \"./lockerverse-auction.tsx\";\nimport { useAuctionBoundary } from \"./use-auction-boundary.ts\";\nimport type { UseLockerverseAuctionsResult } from \"./use-lockerverse-auctions.ts\";\n\nexport type LockerverseAuctionsProps = Omit<\n  LockerverseAuctionProps,\n  \"auction\" | \"onBack\"\n> & {\n  auctions: UseLockerverseAuctionsResult;\n  getAuctionHref?: (auction: Auction) => string;\n  onSelectAuction?: (auction: Auction) => void;\n};\n\nfunction AuctionCard({\n  auction,\n  onSelect,\n  href,\n}: {\n  auction: Auction;\n  onSelect?: () => void;\n  href?: string;\n}) {\n  useAuctionBoundary(auction.startAt, auction.endAt, auction.items);\n  const fallback =\n    auction.configuration.image ||\n    auction.items.find((item) => item.image || item.images.length)?.image ||\n    auction.items.find((item) => item.images.length)?.images[0] ||\n    auction.community?.banner ||\n    auction.community?.thumbnail;\n  const description =\n    auction.description ||\n    {\n      active: \"Bidding is open on available items.\",\n      draft: \"Preview the lineup before bidding opens.\",\n      finished: \"Bidding has wrapped. Review the completed items.\",\n    }[getAuctionDisplayStatus(auction)];\n  return (\n    <article className=\"lockerverse-auctions__catalog-card\">\n      {href ? (\n        <a\n          aria-label={`View items in ${auction.name}`}\n          className=\"lockerverse-auctions__catalog-select\"\n          data-auction-id={auction.id}\n          href={href}\n          onClick={(event) => {\n            if (\n              onSelect &&\n              event.button === 0 &&\n              !event.metaKey &&\n              !event.ctrlKey &&\n              !event.shiftKey &&\n              !event.altKey\n            ) {\n              event.preventDefault();\n              onSelect();\n            }\n          }}\n        >\n          <span className=\"lockerverse-auctions__visually-hidden\">\n            View items in {auction.name}\n          </span>\n        </a>\n      ) : (\n        <button\n          aria-label={`View items in ${auction.name}`}\n          className=\"lockerverse-auctions__catalog-select\"\n          data-auction-id={auction.id}\n          onClick={onSelect}\n          type=\"button\"\n        />\n      )}\n      <div className=\"lockerverse-auctions__catalog-media\">\n        <CatalogImage fallback={fallback} name={auction.name} />\n        <div className=\"lockerverse-auctions__catalog-chips\">\n          <span className=\"lockerverse-auctions__catalog-chip\">\n            {STATUS_LABELS[getAuctionDisplayStatus(auction)]}\n          </span>\n          <Timing auction={auction} />\n        </div>\n        <dl className=\"lockerverse-auctions__catalog-metrics\">\n          <Metric\n            icon={<ListChecks aria-hidden=\"true\" size={16} />}\n            label=\"Items\"\n            value={String(auction.items.length)}\n          />\n          <Metric\n            icon={<Gavel aria-hidden=\"true\" size={16} />}\n            label=\"Bids\"\n            value={String(\n              auction.items.reduce((sum, item) => sum + item.bidCount, 0)\n            )}\n          />\n        </dl>\n      </div>\n      <div className=\"lockerverse-auctions__catalog-body\">\n        <h3>{auction.name}</h3>\n        <AuctionDescription\n          className=\"lockerverse-auctions__catalog-description\"\n          description={description}\n        />\n        <div className=\"lockerverse-auctions__catalog-footer\">\n          <span className=\"lockerverse-auctions__catalog-cta\">\n            {getAuctionDisplayStatus(auction) === \"draft\"\n              ? \"Preview items\"\n              : \"View items\"}\n          </span>\n          <span className=\"lockerverse-auctions__catalog-arrow\">\n            <ArrowRight aria-hidden=\"true\" size={16} />\n          </span>\n        </div>\n      </div>\n    </article>\n  );\n}\n\n/** Optional auction browser. Select an auction to show its items. */\nexport function LockerverseAuctions({\n  auctions,\n  theme = \"dark\",\n  style,\n  className,\n  showFilters = true,\n  showHeader = true,\n  showLineup = true,\n  getAuctionHref,\n  onSelectAuction,\n  ...contentProps\n}: LockerverseAuctionsProps) {\n  const [selectedId, setSelectedId] = useState<string | null>(null);\n  const headingRef = useRef<HTMLHeadingElement>(null);\n  const sectionRef = useRef<HTMLElement>(null);\n  const previousId = useRef(selectedId);\n  const selected = auctions.auctions?.find(\n    (auction) => auction.id === selectedId\n  );\n  useEffect(() => {\n    if (previousId.current !== selectedId) {\n      if (selectedId === null) {\n        const card = [\n          ...(sectionRef.current?.querySelectorAll<HTMLButtonElement>(\n            \"button[data-auction-id]\"\n          ) ?? []),\n        ].find((button) => button.dataset.auctionId === previousId.current);\n        (headingRef.current ?? card ?? sectionRef.current)?.focus();\n      }\n      previousId.current = selectedId;\n    }\n  }, [selectedId]);\n  return (\n    <section\n      aria-busy={auctions.loading}\n      aria-label=\"Auctions\"\n      className={[\n        \"lockerverse-auctions\",\n        \"lockerverse-auctions--catalog\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n      data-lockerverse-theme={theme}\n      ref={sectionRef}\n      style={style}\n      tabIndex={-1}\n    >\n      {!selected && showHeader ? (\n        <header className=\"lockerverse-auctions__catalog-header\">\n          <h2 ref={headingRef} tabIndex={-1}>\n            Auctions\n          </h2>\n        </header>\n      ) : null}\n      {auctions.loading ? <p role=\"status\">Loading auctions…</p> : null}\n      {auctions.error ? (\n        <div role=\"alert\">\n          <p>{auctions.error.message}</p>\n          <button onClick={auctions.refresh} type=\"button\">\n            Try again\n          </button>\n        </div>\n      ) : null}\n      {selected ? (\n        <AuctionContent\n          auction={selected}\n          key={selected.id}\n          onBack={() => setSelectedId(null)}\n          {...contentProps}\n          showFilters={showFilters}\n          showHeader={showHeader}\n          showLineup={showLineup}\n          theme={theme}\n          {...(style ? { style } : {})}\n        />\n      ) : (\n        <AuctionList\n          auctions={auctions.auctions}\n          onSelectAuction={(auction) => {\n            if (onSelectAuction) {\n              onSelectAuction(auction);\n            } else {\n              setSelectedId(auction.id);\n            }\n          }}\n          {...(getAuctionHref ? { getAuctionHref } : {})}\n          interceptLinks={Boolean(onSelectAuction)}\n          showLineup={showLineup}\n        />\n      )}\n    </section>\n  );\n}\n\nfunction AuctionList({\n  auctions,\n  showLineup,\n  onSelectAuction,\n  getAuctionHref,\n  interceptLinks,\n}: {\n  auctions: Auction[] | null;\n  showLineup: boolean;\n  onSelectAuction: (auction: Auction) => void;\n  getAuctionHref?: (auction: Auction) => string;\n  interceptLinks: boolean;\n}) {\n  if (!auctions) {\n    return null;\n  }\n  if (!auctions.length) {\n    return (\n      <div className=\"lockerverse-auctions__catalog-empty\">\n        <h3>No auctions yet.</h3>\n        <p>Published auctions will appear here once they are available.</p>\n      </div>\n    );\n  }\n  return (\n    <>\n      {showLineup ? (\n        <div className=\"lockerverse-auctions__catalog-lineup\">\n          <div>\n            <h3>Auction lineup</h3>\n            <p>Browse the current collection.</p>\n          </div>\n          <span>\n            {auctions.length} {auctions.length === 1 ? \"auction\" : \"auctions\"}\n          </span>\n        </div>\n      ) : null}\n      <ul className=\"lockerverse-auctions__catalog-grid\">\n        {auctions.map((auction) => (\n          <li key={auction.id}>\n            <AuctionCard\n              auction={auction}\n              {...(getAuctionHref ? { href: getAuctionHref(auction) } : {})}\n              {...(!getAuctionHref || interceptLinks\n                ? { onSelect: () => onSelectAuction(auction) }\n                : {})}\n            />\n          </li>\n        ))}\n      </ul>\n    </>\n  );\n}\n"],"mappings":"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"}
+{"version":3,"file":"auctions.js","names":[],"sources":["../src/lockerverse-auctions.tsx"],"sourcesContent":["import type { LockerverseAuction as Auction } from \"@lockerverse/sdk/auctions\";\nimport { ArrowRight, Gavel, ListChecks } from \"lucide-react\";\nimport { useEffect, useRef, useState } from \"react\";\nimport {\n  CatalogImage,\n  Metric,\n  STATUS_LABELS,\n  Timing,\n} from \"./auction-catalog-parts.tsx\";\nimport { AuctionDescription } from \"./auction-description.tsx\";\nimport { getAuctionDisplayStatus } from \"./auction-display.ts\";\nimport {\n  AuctionContent,\n  type LockerverseAuctionProps,\n} from \"./lockerverse-auction.tsx\";\nimport { useAuctionBoundary } from \"./use-auction-boundary.ts\";\nimport type { UseLockerverseAuctionsResult } from \"./use-lockerverse-auctions.ts\";\n\nexport type LockerverseAuctionsProps = Omit<\n  LockerverseAuctionProps,\n  \"auction\" | \"onBack\"\n> & {\n  auctions: UseLockerverseAuctionsResult;\n  getAuctionHref?: (auction: Auction) => string;\n  onSelectAuction?: (auction: Auction) => void;\n};\n\nfunction AuctionCard({\n  auction,\n  onSelect,\n  href,\n}: {\n  auction: Auction;\n  onSelect?: () => void;\n  href?: string;\n}) {\n  useAuctionBoundary(auction.startAt, auction.endAt, auction.items);\n  const fallback =\n    auction.configuration.image ||\n    auction.items.find((item) => item.image || item.images.length)?.image ||\n    auction.items.find((item) => item.images.length)?.images[0] ||\n    auction.community?.banner ||\n    auction.community?.thumbnail;\n  const description =\n    auction.description ||\n    {\n      active: \"Bidding is open on available items.\",\n      draft: \"Preview the lineup before bidding opens.\",\n      finished: \"Bidding has wrapped. Review the completed items.\",\n    }[getAuctionDisplayStatus(auction)];\n  return (\n    <article className=\"lockerverse-auctions__catalog-card\">\n      {href ? (\n        <a\n          aria-label={`View items in ${auction.name}`}\n          className=\"lockerverse-auctions__catalog-select\"\n          data-auction-id={auction.id}\n          href={href}\n          onClick={(event) => {\n            if (\n              onSelect &&\n              event.button === 0 &&\n              !event.metaKey &&\n              !event.ctrlKey &&\n              !event.shiftKey &&\n              !event.altKey\n            ) {\n              event.preventDefault();\n              onSelect();\n            }\n          }}\n        >\n          <span className=\"lockerverse-auctions__visually-hidden\">\n            View items in {auction.name}\n          </span>\n        </a>\n      ) : (\n        <button\n          aria-label={`View items in ${auction.name}`}\n          className=\"lockerverse-auctions__catalog-select\"\n          data-auction-id={auction.id}\n          onClick={onSelect}\n          type=\"button\"\n        />\n      )}\n      <div className=\"lockerverse-auctions__catalog-media\">\n        <CatalogImage fallback={fallback} name={auction.name} />\n        <div className=\"lockerverse-auctions__catalog-chips\">\n          <span className=\"lockerverse-auctions__catalog-chip\">\n            {STATUS_LABELS[getAuctionDisplayStatus(auction)]}\n          </span>\n          <Timing auction={auction} />\n        </div>\n        <dl className=\"lockerverse-auctions__catalog-metrics\">\n          <Metric\n            icon={<ListChecks aria-hidden=\"true\" size={16} />}\n            label=\"Items\"\n            value={String(auction.items.length)}\n          />\n          <Metric\n            icon={<Gavel aria-hidden=\"true\" size={16} />}\n            label=\"Bids\"\n            value={String(\n              auction.items.reduce((sum, item) => sum + item.bidCount, 0)\n            )}\n          />\n        </dl>\n      </div>\n      <div className=\"lockerverse-auctions__catalog-body\">\n        <h3>{auction.name}</h3>\n        <AuctionDescription\n          className=\"lockerverse-auctions__catalog-description\"\n          description={description}\n        />\n        <div className=\"lockerverse-auctions__catalog-footer\">\n          <span className=\"lockerverse-auctions__catalog-cta\">\n            {getAuctionDisplayStatus(auction) === \"draft\"\n              ? \"Preview items\"\n              : \"View items\"}\n          </span>\n          <span className=\"lockerverse-auctions__catalog-arrow\">\n            <ArrowRight aria-hidden=\"true\" size={16} />\n          </span>\n        </div>\n      </div>\n    </article>\n  );\n}\n\n/** Optional auction browser. Select an auction to show its items. */\nexport function LockerverseAuctions({\n  auctions,\n  theme = \"dark\",\n  style,\n  className,\n  showFilters = true,\n  showHeader = true,\n  showLineup = true,\n  getAuctionHref,\n  onSelectAuction,\n  ...contentProps\n}: LockerverseAuctionsProps) {\n  const [selectedId, setSelectedId] = useState<string | null>(null);\n  const headingRef = useRef<HTMLHeadingElement>(null);\n  const sectionRef = useRef<HTMLElement>(null);\n  const previousId = useRef(selectedId);\n  const selected = auctions.auctions?.find(\n    (auction) => auction.id === selectedId\n  );\n  useEffect(() => {\n    if (previousId.current !== selectedId) {\n      if (selectedId === null) {\n        const card = [\n          ...(sectionRef.current?.querySelectorAll<HTMLButtonElement>(\n            \"button[data-auction-id]\"\n          ) ?? []),\n        ].find((button) => button.dataset.auctionId === previousId.current);\n        (headingRef.current ?? card ?? sectionRef.current)?.focus();\n      }\n      previousId.current = selectedId;\n    }\n  }, [selectedId]);\n  return (\n    <section\n      aria-busy={auctions.loading}\n      aria-label=\"Auctions\"\n      className={[\n        \"lockerverse-auctions\",\n        \"lockerverse-auctions--catalog\",\n        className,\n      ]\n        .filter(Boolean)\n        .join(\" \")}\n      data-lockerverse-theme={theme}\n      ref={sectionRef}\n      style={style}\n      tabIndex={-1}\n    >\n      {!selected && showHeader ? (\n        <header className=\"lockerverse-auctions__catalog-header\">\n          <h2 ref={headingRef} tabIndex={-1}>\n            Auctions\n          </h2>\n        </header>\n      ) : null}\n      {auctions.loading ? (\n        <p role=\"status\">\n          {auctions.auctions ? \"Refreshing auctions…\" : \"Loading auctions…\"}\n        </p>\n      ) : null}\n      {auctions.error ? (\n        <div role=\"alert\">\n          <p>{auctions.error.message}</p>\n          <button onClick={auctions.refresh} type=\"button\">\n            Try again\n          </button>\n        </div>\n      ) : null}\n      {selected ? (\n        <AuctionContent\n          auction={selected}\n          key={selected.id}\n          onBack={() => setSelectedId(null)}\n          {...contentProps}\n          showFilters={showFilters}\n          showHeader={showHeader}\n          showLineup={showLineup}\n          theme={theme}\n          {...(style ? { style } : {})}\n        />\n      ) : (\n        <AuctionList\n          auctions={auctions.auctions}\n          onSelectAuction={(auction) => {\n            if (onSelectAuction) {\n              onSelectAuction(auction);\n            } else {\n              setSelectedId(auction.id);\n            }\n          }}\n          {...(getAuctionHref ? { getAuctionHref } : {})}\n          interceptLinks={Boolean(onSelectAuction)}\n          showLineup={showLineup}\n        />\n      )}\n    </section>\n  );\n}\n\nfunction AuctionList({\n  auctions,\n  showLineup,\n  onSelectAuction,\n  getAuctionHref,\n  interceptLinks,\n}: {\n  auctions: Auction[] | null;\n  showLineup: boolean;\n  onSelectAuction: (auction: Auction) => void;\n  getAuctionHref?: (auction: Auction) => string;\n  interceptLinks: boolean;\n}) {\n  if (!auctions) {\n    return null;\n  }\n  if (!auctions.length) {\n    return (\n      <div className=\"lockerverse-auctions__catalog-empty\">\n        <h3>No auctions yet.</h3>\n        <p>Published auctions will appear here once they are available.</p>\n      </div>\n    );\n  }\n  return (\n    <>\n      {showLineup ? (\n        <div className=\"lockerverse-auctions__catalog-lineup\">\n          <div>\n            <h3>Auction lineup</h3>\n            <p>Browse the current collection.</p>\n          </div>\n          <span>\n            {auctions.length} {auctions.length === 1 ? \"auction\" : \"auctions\"}\n          </span>\n        </div>\n      ) : null}\n      <ul className=\"lockerverse-auctions__catalog-grid\">\n        {auctions.map((auction) => (\n          <li key={auction.id}>\n            <AuctionCard\n              auction={auction}\n              {...(getAuctionHref ? { href: getAuctionHref(auction) } : {})}\n              {...(!getAuctionHref || interceptLinks\n                ? { onSelect: () => onSelectAuction(auction) }\n                : {})}\n            />\n          </li>\n        ))}\n      </ul>\n    </>\n  );\n}\n"],"mappings":"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"}

package/dist/use-lockerverse-auctions.d.ts

@@ -1,4 +1,10 @@
 import { CreateLockerverseAuctionOptions, LockerverseAuction, LockerverseAuctionClient, LockerverseSdkError } from "@lockerverse/sdk/auctions";
+//#region src/use-auction-return-refresh.d.ts
+type AuctionRefreshOptions = {
+  /** Refresh after a hidden-to-visible transition. Defaults to true. */
+  refreshOnReturn?: boolean;
+};
+//#endregion
 //#region src/use-lockerverse-auctions.d.ts
 type UseLockerverseAuctionsResult = {
   client: LockerverseAuctionClient;
@@ -7,7 +13,7 @@ type UseLockerverseAuctionsResult = {
   error: LockerverseSdkError | null;
   refresh: () => void;
 };
-declare function useLockerverseAuctions(options: CreateLockerverseAuctionOptions): UseLockerverseAuctionsResult;
+declare function useLockerverseAuctions(options: CreateLockerverseAuctionOptions, refreshOptions?: AuctionRefreshOptions): UseLockerverseAuctionsResult;
 //#endregion
-export { useLockerverseAuctions as n, UseLockerverseAuctionsResult as t };
+export { useLockerverseAuctions as n, AuctionRefreshOptions as r, UseLockerverseAuctionsResult as t };
 //# sourceMappingURL=use-lockerverse-auctions.d.ts.map

package/dist/use-lockerverse-auctions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"use-lockerverse-auctions.d.ts","names":[],"sources":["../src/use-lockerverse-auctions.ts"],"mappings":";;KAUY;EACV,QAAQ;EACR,UAAU;EACV;EACA,OAAO;EACP;;iBAQc,uBACd,SAAS,kCACR"}
+{"version":3,"file":"use-lockerverse-auctions.d.ts","names":[],"sources":["../src/use-auction-return-refresh.ts","../src/use-lockerverse-auctions.ts"],"mappings":";;KAEY;;EAEV;;;;KCUU;EACV,QAAQ;EACR,UAAU;EACV;EACA,OAAO;EACP;;iBAQc,uBACd,SAAS,iCACT,iBAAgB,wBACf"}

package/dist/use-lockerverse-auctions.js

@@ -1,2 +1,2 @@
-import{t as e}from"./immutable-resource-identity.js";import{useCallback as t,useEffect as n,useRef as r,useState as i}from"react";import{createLockerverseAuctionClient as a}from"@lockerverse/sdk/auctions";function o(o){e(`auctions`,{apiBaseUrl:o.apiBaseUrl,communitySlug:o.communitySlug,environment:o.environment,mediaBaseUrl:o.mediaBaseUrl,slug:``});let s=r(o.onError);s.current=o.onError;let[c]=i(()=>a({...o,onError:e=>s.current?.(e)})),[l,u]=i(0),[d,f]=i({auctions:null,error:null});n(()=>{let e=!0;return c.list().then(t=>{e&&f({auctions:t,error:null})},t=>{e&&f({auctions:null,error:t})}),()=>{e=!1}},[c,l]);let p=t(()=>{f({auctions:null,error:null}),u(e=>e+1)},[]);return{...d,client:c,loading:d.auctions===null&&d.error===null,refresh:p}}export{o as t};
+import{t as e}from"./immutable-resource-identity.js";import{useCallback as t,useEffect as n,useRef as r,useState as i}from"react";import{createLockerverseAuctionClient as a}from"@lockerverse/sdk/auctions";function o(e,{refreshOnReturn:i=!0}){let a=r(e);a.current=e;let o=r({active:!1,pending:new Set,queued:!1,reserved:!1}),s=t(()=>{let{current:e}=o;!(e.active&&e.queued)||e.reserved||e.pending.size>0||document.visibilityState!==`visible`||(e.reserved=!0,a.current())},[]);return n(()=>{let{current:e}=o;if(e.active=i,!i)return;let t=document.visibilityState===`hidden`,n=()=>{let n=t;t=document.visibilityState===`hidden`,n&&!t&&(e.queued=!0,s())};return document.addEventListener(`visibilitychange`,n),()=>{e.active=!1,e.queued=!1,e.reserved=!1,document.removeEventListener(`visibilitychange`,n)}},[i,s]),t(()=>{let{current:e}=o,t=Symbol(`auction read`);return e.pending.add(t),e.queued=!1,e.reserved=!1,()=>{e.pending.delete(t),s()}},[s])}function s(s,c={}){e(`auctions`,{apiBaseUrl:s.apiBaseUrl,communitySlug:s.communitySlug,environment:s.environment,mediaBaseUrl:s.mediaBaseUrl,slug:``});let l=r(s.onError);l.current=s.onError;let[u]=i(()=>a({...s,onError:e=>l.current?.(e)})),d=r(0),[f,p]=i(0),[m,h]=i({auctions:null,error:null,loading:!0}),g=t(()=>{d.current+=1,h(e=>({...e,error:null,loading:!0})),p(e=>e+1)},[]),_=o(g,c);return n(()=>{let e=!0,t=d.current,n=_();return u.list().then(n=>{e&&t===d.current&&h({auctions:n,error:null,loading:!1})},n=>{e&&t===d.current&&h(e=>({...e,error:n,loading:!1}))}).finally(n),()=>{e=!1}},[u,f,_]),{...m,client:u,refresh:g}}export{o as n,s as t};
 //# sourceMappingURL=use-lockerverse-auctions.js.map

package/dist/use-lockerverse-auctions.js.map

@@ -1 +1 @@
-{"version":3,"file":"use-lockerverse-auctions.js","names":[],"sources":["../src/use-lockerverse-auctions.ts"],"sourcesContent":["import {\n  type CreateLockerverseAuctionOptions,\n  createLockerverseAuctionClient,\n  type LockerverseAuction,\n  type LockerverseAuctionClient,\n  type LockerverseSdkError,\n} from \"@lockerverse/sdk/auctions\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useImmutableResourceIdentity } from \"./immutable-resource-identity.ts\";\n\nexport type UseLockerverseAuctionsResult = {\n  client: LockerverseAuctionClient;\n  auctions: LockerverseAuction[] | null;\n  loading: boolean;\n  error: LockerverseSdkError | null;\n  refresh: () => void;\n};\n\ntype AuctionLoadState = Pick<\n  UseLockerverseAuctionsResult,\n  \"auctions\" | \"error\"\n>;\n\nexport function useLockerverseAuctions(\n  options: CreateLockerverseAuctionOptions\n): UseLockerverseAuctionsResult {\n  useImmutableResourceIdentity(\"auctions\", {\n    apiBaseUrl: options.apiBaseUrl,\n    communitySlug: options.communitySlug,\n    environment: options.environment,\n    mediaBaseUrl: options.mediaBaseUrl,\n    slug: \"\",\n  });\n  const onErrorRef = useRef(options.onError);\n  onErrorRef.current = options.onError;\n  const [client] = useState(() =>\n    createLockerverseAuctionClient({\n      ...options,\n      onError: (error) => onErrorRef.current?.(error),\n    })\n  );\n  const [revision, setRevision] = useState(0);\n  const [state, setState] = useState<AuctionLoadState>({\n    auctions: null,\n    error: null,\n  });\n  useEffect(() => {\n    let active = true;\n    client.list().then(\n      (auctions) => {\n        if (active) {\n          setState({ auctions, error: null });\n        }\n      },\n      (error: LockerverseSdkError) => {\n        if (active) {\n          setState({ auctions: null, error });\n        }\n      }\n    );\n    return () => {\n      active = false;\n    };\n  }, [client, revision]);\n  const refresh = useCallback(() => {\n    setState({ auctions: null, error: null });\n    setRevision((value) => value + 1);\n  }, []);\n  return {\n    ...state,\n    client,\n    loading: state.auctions === null && state.error === null,\n    refresh,\n  };\n}\n"],"mappings":"6MAuBA,SAAgB,EACd,EAC8B,CAC9B,EAA6B,WAAY,CACvC,WAAY,EAAQ,WACpB,cAAe,EAAQ,cACvB,YAAa,EAAQ,YACrB,aAAc,EAAQ,aACtB,KAAM,EACR,CAAC,EACD,IAAM,EAAa,EAAO,EAAQ,OAAO,EACzC,EAAW,QAAU,EAAQ,QAC7B,GAAM,CAAC,GAAU,MACf,EAA+B,CAC7B,GAAG,EACH,QAAU,GAAU,EAAW,UAAU,CAAK,CAChD,CAAC,CACH,EACM,CAAC,EAAU,GAAe,EAAS,CAAC,EACpC,CAAC,EAAO,GAAY,EAA2B,CACnD,SAAU,KACV,MAAO,IACT,CAAC,EACD,MAAgB,CACd,IAAI,EAAS,GAab,OAZA,EAAO,KAAK,CAAC,CAAC,KACX,GAAa,CACR,GACF,EAAS,CAAE,WAAU,MAAO,IAAK,CAAC,CAEtC,EACC,GAA+B,CAC1B,GACF,EAAS,CAAE,SAAU,KAAM,OAAM,CAAC,CAEtC,CACF,MACa,CACX,EAAS,EACX,CACF,EAAG,CAAC,EAAQ,CAAQ,CAAC,EACrB,IAAM,EAAU,MAAkB,CAChC,EAAS,CAAE,SAAU,KAAM,MAAO,IAAK,CAAC,EACxC,EAAa,GAAU,EAAQ,CAAC,CAClC,EAAG,CAAC,CAAC,EACL,MAAO,CACL,GAAG,EACH,SACA,QAAS,EAAM,WAAa,MAAQ,EAAM,QAAU,KACpD,SACF,CACF"}
+{"version":3,"file":"use-lockerverse-auctions.js","names":[],"sources":["../src/use-auction-return-refresh.ts","../src/use-lockerverse-auctions.ts"],"sourcesContent":["import { useCallback, useEffect, useRef } from \"react\";\n\nexport type AuctionRefreshOptions = {\n  /** Refresh after a hidden-to-visible transition. Defaults to true. */\n  refreshOnReturn?: boolean;\n};\n\n/** Browser lifecycle only; each hook keeps ownership of its data and stale-response guard. */\nexport function useAuctionReturnRefresh(\n  refresh: () => void,\n  { refreshOnReturn = true }: AuctionRefreshOptions\n) {\n  const refreshRef = useRef(refresh);\n  refreshRef.current = refresh;\n  const lifecycle = useRef<{\n    active: boolean;\n    queued: boolean;\n    reserved: boolean;\n    pending: Set<symbol>;\n  }>({\n    active: false,\n    pending: new Set<symbol>(),\n    queued: false,\n    reserved: false,\n  });\n  const schedule = useCallback(() => {\n    const { current } = lifecycle;\n    if (\n      // biome-ignore lint/suspicious/noUnnecessaryConditions: Effects and visibility callbacks mutate this ref after the callback is created.\n      !(current.active && current.queued) ||\n      current.reserved ||\n      current.pending.size > 0 ||\n      document.visibilityState !== \"visible\"\n    ) {\n      return;\n    }\n    // Reserve before React starts the next effect, so repeated events coalesce.\n    current.reserved = true;\n    refreshRef.current();\n  }, []);\n\n  useEffect(() => {\n    const { current } = lifecycle;\n    current.active = refreshOnReturn;\n    if (!refreshOnReturn) {\n      return;\n    }\n    let hidden = document.visibilityState === \"hidden\";\n    const onVisibilityChange = () => {\n      const wasHidden = hidden;\n      hidden = document.visibilityState === \"hidden\";\n      if (wasHidden && !hidden) {\n        current.queued = true;\n        schedule();\n      }\n    };\n    document.addEventListener(\"visibilitychange\", onVisibilityChange);\n    return () => {\n      current.active = false;\n      current.queued = false;\n      current.reserved = false;\n      document.removeEventListener(\"visibilitychange\", onVisibilityChange);\n    };\n  }, [refreshOnReturn, schedule]);\n\n  const startRead = useCallback(() => {\n    const { current } = lifecycle;\n    const request = Symbol(\"auction read\");\n    current.pending.add(request);\n    // A request started after a return satisfies that return, including a manual read.\n    current.queued = false;\n    current.reserved = false;\n    return () => {\n      current.pending.delete(request);\n      schedule();\n    };\n  }, [schedule]);\n  return startRead;\n}\n","import {\n  type CreateLockerverseAuctionOptions,\n  createLockerverseAuctionClient,\n  type LockerverseAuction,\n  type LockerverseAuctionClient,\n  type LockerverseSdkError,\n} from \"@lockerverse/sdk/auctions\";\nimport { useCallback, useEffect, useRef, useState } from \"react\";\nimport { useImmutableResourceIdentity } from \"./immutable-resource-identity.ts\";\nimport {\n  type AuctionRefreshOptions,\n  useAuctionReturnRefresh,\n} from \"./use-auction-return-refresh.ts\";\n\nexport type UseLockerverseAuctionsResult = {\n  client: LockerverseAuctionClient;\n  auctions: LockerverseAuction[] | null;\n  loading: boolean;\n  error: LockerverseSdkError | null;\n  refresh: () => void;\n};\n\ntype AuctionLoadState = Pick<\n  UseLockerverseAuctionsResult,\n  \"auctions\" | \"error\" | \"loading\"\n>;\n\nexport function useLockerverseAuctions(\n  options: CreateLockerverseAuctionOptions,\n  refreshOptions: AuctionRefreshOptions = {}\n): UseLockerverseAuctionsResult {\n  useImmutableResourceIdentity(\"auctions\", {\n    apiBaseUrl: options.apiBaseUrl,\n    communitySlug: options.communitySlug,\n    environment: options.environment,\n    mediaBaseUrl: options.mediaBaseUrl,\n    slug: \"\",\n  });\n  const onErrorRef = useRef(options.onError);\n  onErrorRef.current = options.onError;\n  const [client] = useState(() =>\n    createLockerverseAuctionClient({\n      ...options,\n      onError: (error) => onErrorRef.current?.(error),\n    })\n  );\n  const generation = useRef(0);\n  const [revision, setRevision] = useState(0);\n  const [state, setState] = useState<AuctionLoadState>({\n    auctions: null,\n    error: null,\n    loading: true,\n  });\n  const refresh = useCallback(() => {\n    generation.current += 1;\n    setState((current) => ({ ...current, error: null, loading: true }));\n    setRevision((value) => value + 1);\n  }, []);\n  const startRead = useAuctionReturnRefresh(refresh, refreshOptions);\n\n  useEffect(() => {\n    let active = true;\n    const requestGeneration = generation.current;\n    const settleRead = startRead();\n    client\n      .list()\n      .then(\n        (auctions) => {\n          if (active && requestGeneration === generation.current) {\n            setState({ auctions, error: null, loading: false });\n          }\n        },\n        (error: LockerverseSdkError) => {\n          if (active && requestGeneration === generation.current) {\n            setState((current) => ({ ...current, error, loading: false }));\n          }\n        }\n      )\n      .finally(settleRead);\n    return () => {\n      active = false;\n    };\n  }, [client, revision, startRead]);\n\n  return {\n    ...state,\n    client,\n    refresh,\n  };\n}\n"],"mappings":"6MAQA,SAAgB,EACd,EACA,CAAE,kBAAkB,IACpB,CACA,IAAM,EAAa,EAAO,CAAO,EACjC,EAAW,QAAU,EACrB,IAAM,EAAY,EAKf,CACD,OAAQ,GACR,QAAS,IAAI,IACb,OAAQ,GACR,SAAU,EACZ,CAAC,EACK,EAAW,MAAkB,CACjC,GAAM,CAAE,WAAY,EAGlB,EAAE,EAAQ,QAAU,EAAQ,SAC5B,EAAQ,UACR,EAAQ,QAAQ,KAAO,GACvB,SAAS,kBAAoB,YAK/B,EAAQ,SAAW,GACnB,EAAW,QAAQ,EACrB,EAAG,CAAC,CAAC,EAsCL,OApCA,MAAgB,CACd,GAAM,CAAE,WAAY,EAEpB,GADA,EAAQ,OAAS,EACb,CAAC,EACH,OAEF,IAAI,EAAS,SAAS,kBAAoB,SACpC,MAA2B,CAC/B,IAAM,EAAY,EAClB,EAAS,SAAS,kBAAoB,SAClC,GAAa,CAAC,IAChB,EAAQ,OAAS,GACjB,EAAS,EAEb,EAEA,OADA,SAAS,iBAAiB,mBAAoB,CAAkB,MACnD,CACX,EAAQ,OAAS,GACjB,EAAQ,OAAS,GACjB,EAAQ,SAAW,GACnB,SAAS,oBAAoB,mBAAoB,CAAkB,CACrE,CACF,EAAG,CAAC,EAAiB,CAAQ,CAAC,EAEZ,MAAkB,CAClC,GAAM,CAAE,WAAY,EACd,EAAU,OAAO,cAAc,EAKrC,OAJA,EAAQ,QAAQ,IAAI,CAAO,EAE3B,EAAQ,OAAS,GACjB,EAAQ,SAAW,OACN,CACX,EAAQ,QAAQ,OAAO,CAAO,EAC9B,EAAS,CACX,CACF,EAAG,CAAC,CAAQ,CACG,CACjB,CCnDA,SAAgB,EACd,EACA,EAAwC,CAAC,EACX,CAC9B,EAA6B,WAAY,CACvC,WAAY,EAAQ,WACpB,cAAe,EAAQ,cACvB,YAAa,EAAQ,YACrB,aAAc,EAAQ,aACtB,KAAM,EACR,CAAC,EACD,IAAM,EAAa,EAAO,EAAQ,OAAO,EACzC,EAAW,QAAU,EAAQ,QAC7B,GAAM,CAAC,GAAU,MACf,EAA+B,CAC7B,GAAG,EACH,QAAU,GAAU,EAAW,UAAU,CAAK,CAChD,CAAC,CACH,EACM,EAAa,EAAO,CAAC,EACrB,CAAC,EAAU,GAAe,EAAS,CAAC,EACpC,CAAC,EAAO,GAAY,EAA2B,CACnD,SAAU,KACV,MAAO,KACP,QAAS,EACX,CAAC,EACK,EAAU,MAAkB,CAChC,EAAW,SAAW,EACtB,EAAU,IAAa,CAAE,GAAG,EAAS,MAAO,KAAM,QAAS,EAAK,EAAE,EAClE,EAAa,GAAU,EAAQ,CAAC,CAClC,EAAG,CAAC,CAAC,EACC,EAAY,EAAwB,EAAS,CAAc,EA0BjE,OAxBA,MAAgB,CACd,IAAI,EAAS,GACP,EAAoB,EAAW,QAC/B,EAAa,EAAU,EAgB7B,OAfA,EACG,KAAK,CAAC,CACN,KACE,GAAa,CACR,GAAU,IAAsB,EAAW,SAC7C,EAAS,CAAE,WAAU,MAAO,KAAM,QAAS,EAAM,CAAC,CAEtD,EACC,GAA+B,CAC1B,GAAU,IAAsB,EAAW,SAC7C,EAAU,IAAa,CAAE,GAAG,EAAS,QAAO,QAAS,EAAM,EAAE,CAEjE,CACF,CAAC,CACA,QAAQ,CAAU,MACR,CACX,EAAS,EACX,CACF,EAAG,CAAC,EAAQ,EAAU,CAAS,CAAC,EAEzB,CACL,GAAG,EACH,SACA,SACF,CACF"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lockerverse/react",
-  "version": "0.2.127-dev.1",
+  "version": "0.2.129-dev.1",
   "description": "Tree-shakable React payment and signup UI for Lockerverse",
   "repository": {
     "type": "git",
@@ -127,7 +127,7 @@
     "embla-carousel-react": "8.6.0",
     "lucide-react": "0.536.0",
     "valibot": "1.4.2",
-    "@lockerverse/sdk": "0.2.127-dev.1"
+    "@lockerverse/sdk": "0.2.129-dev.1"
   },
   "devDependencies": {
     "@size-limit/file": "13.0.3",