@civitai/blocks-react 0.24.0 → 0.26.0

package/README.md

@@ -223,6 +223,76 @@ if (!loading && balance) console.log(`Yellow: ${balance.yellow}`);
 > `body.accountType` (`'blue' | 'green' | 'yellow'`) — a *preference* for which
 > pool funds the generation; the host clamps it server-side.
 
+### `useViewer()`
+
+The signed-in viewer as an on-demand authoritative self-read (`{ id, username,
+status, buzzBudget }`) — distinct from `useBlockContext().viewer`, the coarse
+`BLOCK_INIT`-time snapshot. `status` is `'active' | 'muted'`; `username`
+(`string | null`) and `buzzBudget` (`number | null`) are present-but-nullable, so
+handle the null case. Host-mediated over `GET_VIEWER` → `VIEWER_RESULT` (the host
+resolves the viewer from the block token via `blocks.getMyViewer`); an anonymous /
+banned viewer comes back as `error`. Fetches on mount; `refetch` for on-demand
+refreshes.
+
+```tsx
+const { viewer, loading, error, refetch } = useViewer();
+// `viewer` is null until the first successful fetch. An anon / banned viewer,
+// missing scope, or host failure → `error`. `username`/`buzzBudget` may be null.
+if (!loading && viewer) console.log(`${viewer.username ?? 'anon'} · budget ${viewer.buzzBudget ?? 0}`);
+```
+
+### `useBuzzTransactions(params?)`
+
+The signed-in viewer's Buzz-transaction ledger (a paged, host-projected read of
+the Buzz dashboard). Returns `{ transactions, cursor, loading, error, refetch }`;
+`transactions` rows are rehydrated so `date` is a `Date`. Pass the returned
+`cursor` back as `params.cursor` to page forward. Requires the `buzz:read:self`
+scope; host-mediated over `GET_BUZZ_TRANSACTIONS`.
+
+```tsx
+const { transactions, cursor, loading, error } = useBuzzTransactions({ type: 'Tip', limit: 20 });
+if (!loading && transactions) transactions.forEach((t) => console.log(t.type, t.amount, t.date));
+```
+
+### `useBuzzAccounts()`
+
+The viewer's all-pool Buzz balances — the three spendable pools **plus** the
+creator payout pools (`{ accountType, balance }[]`), a superset of
+`useBuzzBalance`. Returns `{ accounts, loading, error, refetch }`. Requires
+`buzz:read:self`; host-mediated over `GET_BUZZ_ACCOUNTS`.
+
+```tsx
+const { accounts, loading, error } = useBuzzAccounts();
+if (!loading && accounts) accounts.forEach((a) => console.log(a.accountType, a.balance));
+```
+
+### `useDailyCompensation(params)`
+
+Per-modelVersion generation-compensation for the month containing `params.date`
+(Buzz totals + cash totals in pennies). Returns `{ resources,
+hasPublishedResources, loading, error, refetch }`. Requires `buzz:read:self`;
+host-mediated over `GET_DAILY_COMPENSATION`.
+
+```tsx
+const { resources, hasPublishedResources } = useDailyCompensation({ date: '2026-07-01' });
+```
+
+### `useWildcardPack(modelVersionId)`
+
+Import a wildcard pack's parsed prompt lists by model version — the host
+resolves + fetches + unzips + parses it **in the user's own page session** (every
+download gate enforced), so the untrusted iframe never sees the bytes. Returns
+`{ pack, loading, error, refetch }`. On failure `error` is a `WildcardPackError`
+with a discriminated `code` (`not-found` / `forbidden` / `too-large` /
+`parse-failed` / `busy` — `busy` is retryable), not free text.
+
+```tsx
+const { pack, loading, error, refetch } = useWildcardPack(modelVersionId);
+// `error.code === 'busy'` is retryable — call refetch(); the other codes are terminal.
+if (error instanceof WildcardPackError && error.code === 'busy') void refetch();
+if (!loading && pack) console.log(Object.keys(pack.lists));
+```
+
 ### `useAppStorage()`
 
 Per-(block instance, viewer) KV datastore, host-mediated. 64 KB per value,

package/dist/hooks/useBuzzAccounts.d.ts

@@ -0,0 +1,39 @@
+import type { BlockBuzzAccount } from '@civitai/app-sdk/blocks';
+/**
+ * What {@link useBuzzAccounts} returns.
+ */
+export interface UseBuzzAccounts {
+    /**
+     * The viewer's all-pool balances — the three spendable pools PLUS the creator
+     * payout pools (`creatorProgramBank`, `cashSettled`, …) the spendable-only
+     * {@link useBuzzBalance} omits. `null` until the first successful fetch.
+     */
+    accounts: BlockBuzzAccount[] | null;
+    /** `true` while a fetch (initial or `refetch`) is in flight. */
+    loading: boolean;
+    /**
+     * The last fetch's failure — a host-reported error (anon viewer / missing
+     * `buzz:read:self` scope / host failure) or the transport timeout. Free-text.
+     * Cleared at the start of the next fetch.
+     */
+    error: Error | null;
+    /** Re-request the balances. */
+    refetch: () => void;
+}
+/**
+ * Read the signed-in viewer's ALL-pool Buzz balances through the host-mediated
+ * `GET_BUZZ_ACCOUNTS` → `BUZZ_ACCOUNTS_RESULT` bridge. Token-bound: the host
+ * self-binds off the block token and reads via its `blocks.getMyBuzzAccounts`
+ * mutation (scope `buzz:read:self`). Unlike {@link useBuzzBalance} (the three
+ * spendable pools), this returns every pool in the block API's set — including
+ * the creator payout pools — as `{ accountType, balance }` rows.
+ *
+ * Fetches once on mount and exposes `refetch`. A host that never answers surfaces
+ * as an `error` after the transport timeout; late post-unmount responses are
+ * ignored.
+ *
+ * @example
+ * const { accounts, loading, error } = useBuzzAccounts();
+ */
+export declare function useBuzzAccounts(): UseBuzzAccounts;
+//# sourceMappingURL=useBuzzAccounts.d.ts.map

package/dist/hooks/useBuzzAccounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBuzzAccounts.d.ts","sourceRoot":"","sources":["../../src/hooks/useBuzzAccounts.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAKhE;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B;;;;OAIG;IACH,QAAQ,EAAE,gBAAgB,EAAE,GAAG,IAAI,CAAC;IACpC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,+BAA+B;IAC/B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,eAAe,IAAI,eAAe,CA2CjD"}

package/dist/hooks/useBuzzAccounts.js

@@ -0,0 +1,57 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/**
+ * Read the signed-in viewer's ALL-pool Buzz balances through the host-mediated
+ * `GET_BUZZ_ACCOUNTS` → `BUZZ_ACCOUNTS_RESULT` bridge. Token-bound: the host
+ * self-binds off the block token and reads via its `blocks.getMyBuzzAccounts`
+ * mutation (scope `buzz:read:self`). Unlike {@link useBuzzBalance} (the three
+ * spendable pools), this returns every pool in the block API's set — including
+ * the creator payout pools — as `{ accountType, balance }` rows.
+ *
+ * Fetches once on mount and exposes `refetch`. A host that never answers surfaces
+ * as an `error` after the transport timeout; late post-unmount responses are
+ * ignored.
+ *
+ * @example
+ * const { accounts, loading, error } = useBuzzAccounts();
+ */
+export function useBuzzAccounts() {
+    const [accounts, setAccounts] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refetch = useCallback(() => {
+        setLoading(true);
+        setError(null);
+        sendTypedRequest(getTransport(), { type: 'GET_BUZZ_ACCOUNTS', payload: {} }, 'BUZZ_ACCOUNTS_RESULT')
+            .then((result) => {
+            if (!mountedRef.current)
+                return;
+            if (result.error || !result.result) {
+                setError(new Error(result.error ?? 'failed to fetch buzz accounts'));
+                setLoading(false);
+                return;
+            }
+            setAccounts(result.result.accounts);
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (!mountedRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setLoading(false);
+        });
+    }, []);
+    useEffect(() => {
+        refetch();
+    }, [refetch]);
+    return { accounts, loading, error, refetch };
+}
+//# sourceMappingURL=useBuzzAccounts.js.map

package/dist/hooks/useBuzzAccounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBuzzAccounts.js","sourceRoot":"","sources":["../../src/hooks/useBuzzAccounts.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAwB5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe;IAC7B,MAAM,CAAC,QAAQ,EAAE,WAAW,CAAC,GAAG,QAAQ,CAA4B,IAAI,CAAC,CAAC;IAC1E,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,gBAAgB,CACd,YAAY,EAAE,EACd,EAAE,IAAI,EAAE,mBAAmB,EAAE,OAAO,EAAE,EAAE,EAAE,EAC1C,sBAAsB,CACvB;aACE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC,CAAC;gBACrE,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;YACpC,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC/C,CAAC"}

package/dist/hooks/useBuzzTransactions.d.ts

@@ -0,0 +1,52 @@
+import type { BlockBuzzTransaction, BlockBuzzTransactionsParams } from '@civitai/app-sdk/blocks';
+/**
+ * One Buzz-transaction row, REHYDRATED for block consumption: identical to the
+ * wire {@link BlockBuzzTransaction} except `date` is a `Date` (rehydrated from
+ * the ISO string / `Date` the host sends — see the DATE WIRE CAVEAT on
+ * `BlockBuzzTransaction`).
+ */
+export interface BuzzTransaction extends Omit<BlockBuzzTransaction, 'date'> {
+    date: Date;
+}
+/**
+ * What {@link useBuzzTransactions} returns.
+ */
+export interface UseBuzzTransactions {
+    /** The current page's rows (newest-first), or `null` until the first successful fetch. */
+    transactions: BuzzTransaction[] | null;
+    /**
+     * The next-page cursor (ISO-8601), or `null` when there's no further page.
+     * Pass it back as `params.cursor` on a subsequent call to page forward.
+     */
+    cursor: string | null;
+    /** `true` while a fetch (initial or `refetch`) is in flight. */
+    loading: boolean;
+    /**
+     * The last fetch's failure — a host-reported error (anon viewer / missing
+     * `buzz:read:self` scope / host failure) or the transport timeout. Free-text
+     * (the buzz bridge does not use a discriminated error enum). Cleared at the
+     * start of the next fetch.
+     */
+    error: Error | null;
+    /** Re-request the current page. */
+    refetch: () => void;
+}
+/**
+ * Read the signed-in viewer's Buzz-transaction ledger through the host-mediated
+ * `GET_BUZZ_TRANSACTIONS` → `BUZZ_TRANSACTIONS_RESULT` bridge. Token-bound: the
+ * host self-binds the account off the block token and reads via its
+ * `blocks.getMyBuzzTransactions` mutation (scope `buzz:read:self`) — the block
+ * never touches the ledger API or credentials directly (same trust model as
+ * {@link useBuzzBalance}).
+ *
+ * Fetches on mount and whenever `params` change (by value), and exposes `refetch`.
+ * A host that never answers surfaces as an `error` after the transport's request
+ * timeout — the hook never hangs. Late responses that arrive after unmount are
+ * ignored. Transaction `date`s are rehydrated to `Date`; `cursor` is normalized
+ * to an ISO string for round-tripping.
+ *
+ * @example
+ * const { transactions, cursor, loading, error } = useBuzzTransactions({ type: 'Tip', limit: 20 });
+ */
+export declare function useBuzzTransactions(params?: BlockBuzzTransactionsParams): UseBuzzTransactions;
+//# sourceMappingURL=useBuzzTransactions.d.ts.map

package/dist/hooks/useBuzzTransactions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBuzzTransactions.d.ts","sourceRoot":"","sources":["../../src/hooks/useBuzzTransactions.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,MAAM,yBAAyB,CAAC;AAKjG;;;;;GAKG;AACH,MAAM,WAAW,eAAgB,SAAQ,IAAI,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACzE,IAAI,EAAE,IAAI,CAAC;CACZ;AAED;;GAEG;AACH,MAAM,WAAW,mBAAmB;IAClC,0FAA0F;IAC1F,YAAY,EAAE,eAAe,EAAE,GAAG,IAAI,CAAC;IACvC;;;OAGG;IACH,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;;OAKG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,mCAAmC;IACnC,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAWD;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,CAAC,EAAE,2BAA2B,GAAG,mBAAmB,CAqD7F"}

package/dist/hooks/useBuzzTransactions.js

@@ -0,0 +1,77 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/** Rehydrate the host's `date`/`cursor` (a `Date` instance OR an ISO string). */
+function toDate(v) {
+    return v instanceof Date ? v : new Date(v);
+}
+function toIso(v) {
+    if (v === undefined || v === null)
+        return null;
+    return v instanceof Date ? v.toISOString() : String(v);
+}
+/**
+ * Read the signed-in viewer's Buzz-transaction ledger through the host-mediated
+ * `GET_BUZZ_TRANSACTIONS` → `BUZZ_TRANSACTIONS_RESULT` bridge. Token-bound: the
+ * host self-binds the account off the block token and reads via its
+ * `blocks.getMyBuzzTransactions` mutation (scope `buzz:read:self`) — the block
+ * never touches the ledger API or credentials directly (same trust model as
+ * {@link useBuzzBalance}).
+ *
+ * Fetches on mount and whenever `params` change (by value), and exposes `refetch`.
+ * A host that never answers surfaces as an `error` after the transport's request
+ * timeout — the hook never hangs. Late responses that arrive after unmount are
+ * ignored. Transaction `date`s are rehydrated to `Date`; `cursor` is normalized
+ * to an ISO string for round-tripping.
+ *
+ * @example
+ * const { transactions, cursor, loading, error } = useBuzzTransactions({ type: 'Tip', limit: 20 });
+ */
+export function useBuzzTransactions(params) {
+    const [transactions, setTransactions] = useState(null);
+    const [cursor, setCursor] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    // Serialize the params to a stable key so `refetch`'s identity only changes
+    // when the params VALUE changes (not on every render's fresh object). The
+    // callback re-parses the key so it closes over NOTHING but the key.
+    const paramsKey = params ? JSON.stringify(params) : '';
+    const refetch = useCallback(() => {
+        setLoading(true);
+        setError(null);
+        const parsed = paramsKey ? JSON.parse(paramsKey) : undefined;
+        const payload = parsed ? { params: parsed } : {};
+        sendTypedRequest(getTransport(), { type: 'GET_BUZZ_TRANSACTIONS', payload }, 'BUZZ_TRANSACTIONS_RESULT')
+            .then((result) => {
+            if (!mountedRef.current)
+                return;
+            if (result.error || !result.result) {
+                setError(new Error(result.error ?? 'failed to fetch buzz transactions'));
+                setLoading(false);
+                return;
+            }
+            const wire = result.result;
+            setTransactions(wire.transactions.map((t) => ({ ...t, date: toDate(t.date) })));
+            setCursor(toIso(wire.cursor));
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (!mountedRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setLoading(false);
+        });
+    }, [paramsKey]);
+    useEffect(() => {
+        refetch();
+    }, [refetch]);
+    return { transactions, cursor, loading, error, refetch };
+}
+//# sourceMappingURL=useBuzzTransactions.js.map

package/dist/hooks/useBuzzTransactions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useBuzzTransactions.js","sourceRoot":"","sources":["../../src/hooks/useBuzzTransactions.ts"],"names":[],"mappings":"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"}

package/dist/hooks/useDailyCompensation.d.ts

@@ -0,0 +1,44 @@
+import type { BlockDailyCompensationParams, BlockDailyCompensationResource } from '@civitai/app-sdk/blocks';
+/**
+ * What {@link useDailyCompensation} returns.
+ */
+export interface UseDailyCompensation {
+    /**
+     * Per-modelVersion generation-compensation rows for the month of the requested
+     * `date`, or `null` until the first successful fetch. `data`/`cashData`
+     * `createdAt` are `YYYY-MM-DD` day-strings (NOT rehydrated to `Date`).
+     */
+    resources: BlockDailyCompensationResource[] | null;
+    /**
+     * Whether the viewer has ANY published resource — `false` distinguishes "no
+     * published models" from "published models that earned nothing this month"
+     * (both give `resources: []`). `null` until the first successful fetch.
+     */
+    hasPublishedResources: boolean | null;
+    /** `true` while a fetch (initial or `refetch`) is in flight. */
+    loading: boolean;
+    /**
+     * The last fetch's failure — a host-reported error (anon viewer / missing
+     * `buzz:read:self` scope / a ClickHouse blip surfaced as a retryable error) or
+     * the transport timeout. Free-text. Cleared at the start of the next fetch.
+     */
+    error: Error | null;
+    /** Re-request the compensation for the current `params`. */
+    refetch: () => void;
+}
+/**
+ * Read the signed-in viewer's per-modelVersion generation compensation for the
+ * MONTH containing `params.date`, through the host-mediated
+ * `GET_DAILY_COMPENSATION` → `DAILY_COMPENSATION_RESULT` bridge. Token-bound: the
+ * host self-binds off the block token and reads via its
+ * `blocks.getMyDailyCompensation` mutation (scope `buzz:read:self`).
+ *
+ * Fetches on mount and whenever `params` change (by value), and exposes `refetch`.
+ * A host that never answers surfaces as an `error` after the transport timeout;
+ * late post-unmount responses are ignored.
+ *
+ * @example
+ * const { resources, hasPublishedResources } = useDailyCompensation({ date: '2026-07-01' });
+ */
+export declare function useDailyCompensation(params: BlockDailyCompensationParams): UseDailyCompensation;
+//# sourceMappingURL=useDailyCompensation.d.ts.map

package/dist/hooks/useDailyCompensation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDailyCompensation.d.ts","sourceRoot":"","sources":["../../src/hooks/useDailyCompensation.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EACV,4BAA4B,EAC5B,8BAA8B,EAC/B,MAAM,yBAAyB,CAAC;AAKjC;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,SAAS,EAAE,8BAA8B,EAAE,GAAG,IAAI,CAAC;IACnD;;;;OAIG;IACH,qBAAqB,EAAE,OAAO,GAAG,IAAI,CAAC;IACtC,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,4DAA4D;IAC5D,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,4BAA4B,GAAG,oBAAoB,CAkD/F"}

package/dist/hooks/useDailyCompensation.js

@@ -0,0 +1,62 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/**
+ * Read the signed-in viewer's per-modelVersion generation compensation for the
+ * MONTH containing `params.date`, through the host-mediated
+ * `GET_DAILY_COMPENSATION` → `DAILY_COMPENSATION_RESULT` bridge. Token-bound: the
+ * host self-binds off the block token and reads via its
+ * `blocks.getMyDailyCompensation` mutation (scope `buzz:read:self`).
+ *
+ * Fetches on mount and whenever `params` change (by value), and exposes `refetch`.
+ * A host that never answers surfaces as an `error` after the transport timeout;
+ * late post-unmount responses are ignored.
+ *
+ * @example
+ * const { resources, hasPublishedResources } = useDailyCompensation({ date: '2026-07-01' });
+ */
+export function useDailyCompensation(params) {
+    const [resources, setResources] = useState(null);
+    const [hasPublishedResources, setHasPublishedResources] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    // Stable params key so `refetch`'s identity only changes when the params VALUE
+    // changes; the callback re-parses it so it closes over nothing but the key.
+    const paramsKey = JSON.stringify(params);
+    const refetch = useCallback(() => {
+        setLoading(true);
+        setError(null);
+        const parsed = JSON.parse(paramsKey);
+        sendTypedRequest(getTransport(), { type: 'GET_DAILY_COMPENSATION', payload: { params: parsed } }, 'DAILY_COMPENSATION_RESULT')
+            .then((result) => {
+            if (!mountedRef.current)
+                return;
+            if (result.error || !result.result) {
+                setError(new Error(result.error ?? 'failed to fetch daily compensation'));
+                setLoading(false);
+                return;
+            }
+            setResources(result.result.resources);
+            setHasPublishedResources(result.result.hasPublishedResources);
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (!mountedRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setLoading(false);
+        });
+    }, [paramsKey]);
+    useEffect(() => {
+        refetch();
+    }, [refetch]);
+    return { resources, hasPublishedResources, loading, error, refetch };
+}
+//# sourceMappingURL=useDailyCompensation.js.map

package/dist/hooks/useDailyCompensation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDailyCompensation.js","sourceRoot":"","sources":["../../src/hooks/useDailyCompensation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAOjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AA8B5D;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoC;IACvE,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAA0C,IAAI,CAAC,CAAC;IAC1F,MAAM,CAAC,qBAAqB,EAAE,wBAAwB,CAAC,GAAG,QAAQ,CAAiB,IAAI,CAAC,CAAC;IACzF,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,+EAA+E;IAC/E,4EAA4E;IAC5E,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;IAEzC,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAiC,CAAC;QACrE,gBAAgB,CACd,YAAY,EAAE,EACd,EAAE,IAAI,EAAE,wBAAwB,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,EAC/D,2BAA2B,CAC5B;aACE,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,oCAAoC,CAAC,CAAC,CAAC;gBAC1E,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,YAAY,CAAC,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;YACtC,wBAAwB,CAAC,MAAM,CAAC,MAAM,CAAC,qBAAqB,CAAC,CAAC;YAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhB,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,SAAS,EAAE,qBAAqB,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AACvE,CAAC"}

package/dist/hooks/useViewer.d.ts

@@ -0,0 +1,45 @@
+import type { BlockViewer } from '@civitai/app-sdk/blocks';
+/**
+ * What {@link useViewer} returns.
+ */
+export interface UseViewer {
+    /** The signed-in viewer, or `null` until the first successful fetch. */
+    viewer: BlockViewer | null;
+    /** `true` while a fetch (initial or `refetch`) is in flight. */
+    loading: boolean;
+    /**
+     * The last fetch's failure — a host-reported error (anon / banned viewer /
+     * missing scope / host failure) or the transport timeout when the host never
+     * answers. Cleared at the start of the next fetch.
+     */
+    error: Error | null;
+    /** Re-request the viewer. */
+    refetch: () => void;
+}
+/**
+ * Read the signed-in viewer (id / username / status + optional buzzBudget)
+ * through the host-mediated `GET_VIEWER` → `VIEWER_RESULT` bridge. Token-bound:
+ * the host resolves the viewer from the block token and reads via its
+ * `blocks.getMyViewer` tRPC mutation — the block never touches the viewer API or
+ * credentials directly (same trust model as {@link useBuzzBalance}).
+ *
+ * Distinct from `useBlockContext().viewer`, which is the coarse BLOCK_INIT-time
+ * snapshot ({@link ViewerInfo}, `status` optional): `useViewer` is the on-demand
+ * authoritative self-read (`active`/`muted` status + the viewer's current
+ * `buzzBudget`). `username` and `buzzBudget` are surfaced as-is and may be `null`
+ * (a viewer with no handle / a token lacking the budget claim) — the block
+ * handles the null case.
+ *
+ * Fetches once on mount and exposes `refetch` for on-demand refreshes. A host
+ * that never answers surfaces as an `error` after the transport's request
+ * timeout — the hook never hangs. Late responses that arrive after unmount are
+ * ignored (no state update).
+ *
+ * @example
+ * const { viewer, loading, error, refetch } = useViewer();
+ * if (loading) return <Spinner />;
+ * if (error) return <RetryButton onClick={refetch} />;
+ * return <span>{viewer?.username}</span>;
+ */
+export declare function useViewer(): UseViewer;
+//# sourceMappingURL=useViewer.d.ts.map

package/dist/hooks/useViewer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewer.d.ts","sourceRoot":"","sources":["../../src/hooks/useViewer.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AAK3D;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,wEAAwE;IACxE,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,6BAA6B;IAC7B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,SAAS,IAAI,SAAS,CA0CrC"}

package/dist/hooks/useViewer.js

@@ -0,0 +1,70 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { getTransport } from '../internal/singleton.js';
+import { sendTypedRequest } from '../internal/transport.js';
+/**
+ * Read the signed-in viewer (id / username / status + optional buzzBudget)
+ * through the host-mediated `GET_VIEWER` → `VIEWER_RESULT` bridge. Token-bound:
+ * the host resolves the viewer from the block token and reads via its
+ * `blocks.getMyViewer` tRPC mutation — the block never touches the viewer API or
+ * credentials directly (same trust model as {@link useBuzzBalance}).
+ *
+ * Distinct from `useBlockContext().viewer`, which is the coarse BLOCK_INIT-time
+ * snapshot ({@link ViewerInfo}, `status` optional): `useViewer` is the on-demand
+ * authoritative self-read (`active`/`muted` status + the viewer's current
+ * `buzzBudget`). `username` and `buzzBudget` are surfaced as-is and may be `null`
+ * (a viewer with no handle / a token lacking the budget claim) — the block
+ * handles the null case.
+ *
+ * Fetches once on mount and exposes `refetch` for on-demand refreshes. A host
+ * that never answers surfaces as an `error` after the transport's request
+ * timeout — the hook never hangs. Late responses that arrive after unmount are
+ * ignored (no state update).
+ *
+ * @example
+ * const { viewer, loading, error, refetch } = useViewer();
+ * if (loading) return <Spinner />;
+ * if (error) return <RetryButton onClick={refetch} />;
+ * return <span>{viewer?.username}</span>;
+ */
+export function useViewer() {
+    const [viewer, setViewer] = useState(null);
+    const [loading, setLoading] = useState(true);
+    const [error, setError] = useState(null);
+    // Guards against a late response resolving after the component unmounted
+    // (React would warn about a state update on an unmounted component, and the
+    // work is wasted anyway).
+    const mountedRef = useRef(true);
+    useEffect(() => {
+        mountedRef.current = true;
+        return () => {
+            mountedRef.current = false;
+        };
+    }, []);
+    const refetch = useCallback(() => {
+        setLoading(true);
+        setError(null);
+        sendTypedRequest(getTransport(), { type: 'GET_VIEWER', payload: {} }, 'VIEWER_RESULT')
+            .then((result) => {
+            if (!mountedRef.current)
+                return;
+            if (result.error || !result.viewer) {
+                setError(new Error(result.error ?? 'failed to fetch viewer'));
+                setLoading(false);
+                return;
+            }
+            setViewer(result.viewer);
+            setLoading(false);
+        })
+            .catch((err) => {
+            if (!mountedRef.current)
+                return;
+            setError(err instanceof Error ? err : new Error(String(err)));
+            setLoading(false);
+        });
+    }, []);
+    useEffect(() => {
+        refetch();
+    }, [refetch]);
+    return { viewer, loading, error, refetch };
+}
+//# sourceMappingURL=useViewer.js.map

package/dist/hooks/useViewer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useViewer.js","sourceRoot":"","sources":["../../src/hooks/useViewer.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,OAAO,CAAC;AAIjE,OAAO,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,0BAA0B,CAAC;AAoB5D;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,SAAS;IACvB,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAqB,IAAI,CAAC,CAAC;IAC/D,MAAM,CAAC,OAAO,EAAE,UAAU,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAe,IAAI,CAAC,CAAC;IAEvD,yEAAyE;IACzE,4EAA4E;IAC5E,0BAA0B;IAC1B,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;IAChC,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,OAAO,GAAG,IAAI,CAAC;QAC1B,OAAO,GAAG,EAAE;YACV,UAAU,CAAC,OAAO,GAAG,KAAK,CAAC;QAC7B,CAAC,CAAC;IACJ,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,MAAM,OAAO,GAAG,WAAW,CAAC,GAAG,EAAE;QAC/B,UAAU,CAAC,IAAI,CAAC,CAAC;QACjB,QAAQ,CAAC,IAAI,CAAC,CAAC;QACf,gBAAgB,CAAC,YAAY,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAAE,EAAE,EAAE,eAAe,CAAC;aACnF,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE;YACf,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,IAAI,MAAM,CAAC,KAAK,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC;gBACnC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,wBAAwB,CAAC,CAAC,CAAC;gBAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;gBAClB,OAAO;YACT,CAAC;YACD,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;YACzB,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC;aACD,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;YACtB,IAAI,CAAC,UAAU,CAAC,OAAO;gBAAE,OAAO;YAChC,QAAQ,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YAC9D,UAAU,CAAC,KAAK,CAAC,CAAC;QACpB,CAAC,CAAC,CAAC;IACP,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,SAAS,CAAC,GAAG,EAAE;QACb,OAAO,EAAE,CAAC;IACZ,CAAC,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IAEd,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC"}

package/dist/hooks/useWildcardPack.d.ts

@@ -0,0 +1,49 @@
+import type { BlockWildcardPack, BlockWildcardPackErrorCode } from '@civitai/app-sdk/blocks';
+export type { BlockWildcardPack, BlockWildcardPackErrorCode };
+/**
+ * A wildcard-pack import failure. Unlike the buzz bridges' free-text errors, the
+ * host returns a DISCRIMINATED code — this error carries it on `.code` so a block
+ * can branch on the exact reason (`busy` is retryable; `too-large`/`forbidden`/
+ * `not-found`/`parse-failed` are terminal). `.message` equals the code.
+ */
+export declare class WildcardPackError extends Error {
+    readonly code: BlockWildcardPackErrorCode;
+    constructor(code: BlockWildcardPackErrorCode);
+}
+/**
+ * What {@link useWildcardPack} returns.
+ */
+export interface UseWildcardPack {
+    /** The parsed pack, or `null` until the first successful fetch. */
+    pack: BlockWildcardPack | null;
+    /** `true` while a fetch (initial or `refetch`) is in flight. */
+    loading: boolean;
+    /**
+     * The last fetch's failure as a {@link WildcardPackError} (`.code` is the
+     * discriminated reason), or a plain `Error` on a transport timeout. Cleared at
+     * the start of the next fetch.
+     */
+    error: Error | null;
+    /** Re-request the pack. */
+    refetch: () => void;
+}
+/**
+ * Import a wildcard pack's parsed prompt lists by model-version id, through the
+ * host-mediated `GET_WILDCARD_PACK` → `WILDCARD_PACK_RESULT` bridge.
+ * TOKEN-INDEPENDENT (no block scope): the host resolves + fetches + unzips +
+ * parses the pack in the viewer's authenticated page session — enforcing every
+ * real download gate — and returns only the parsed JSON. The untrusted iframe
+ * never sees the session, the signed URL, or the raw bytes.
+ *
+ * Fetches on mount and whenever `modelVersionId` changes; exposes `refetch` (e.g.
+ * to retry a `busy` result). On failure `error` is a {@link WildcardPackError}
+ * whose `.code` is the discriminated reason. A non-positive `modelVersionId` is a
+ * no-op (nothing to fetch). A host that never answers surfaces as an `error`
+ * after the transport timeout; late post-unmount responses are ignored.
+ *
+ * @example
+ * const { pack, loading, error } = useWildcardPack(modelVersionId);
+ * if (error instanceof WildcardPackError && error.code === 'busy') return <RetryLater />;
+ */
+export declare function useWildcardPack(modelVersionId: number): UseWildcardPack;
+//# sourceMappingURL=useWildcardPack.d.ts.map

package/dist/hooks/useWildcardPack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useWildcardPack.d.ts","sourceRoot":"","sources":["../../src/hooks/useWildcardPack.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,MAAM,yBAAyB,CAAC;AAK7F,YAAY,EAAE,iBAAiB,EAAE,0BAA0B,EAAE,CAAC;AAE9D;;;;;GAKG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,0BAA0B,CAAC;gBAC9B,IAAI,EAAE,0BAA0B;CAK7C;AAED;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,mEAAmE;IACnE,IAAI,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC/B,gEAAgE;IAChE,OAAO,EAAE,OAAO,CAAC;IACjB;;;;OAIG;IACH,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IACpB,2BAA2B;IAC3B,OAAO,EAAE,MAAM,IAAI,CAAC;CACrB;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,eAAe,CAAC,cAAc,EAAE,MAAM,GAAG,eAAe,CAmDvE"}