@fractalshq/sync 0.0.3 → 0.0.5

package/dist/index.d.ts

@@ -1,3 +1,3 @@
 export { ApiAuthRequest, GET, POST, SyncHandlerOptions, SyncServerClient, SyncServerOptions, createMethodHandler, syncRouteHandler } from './server/index.js';
-export { DEFAULT_RPC_ENDPOINT, DISTRIBUTION_MEMO_PREFIX, MEMO_PROGRAM_ID, XNET_2022_MINT, assertTruthy, buildDistributionMemoTag } from './core/index.js';
-export { B as BuildClaimTransactionRequest, l as BuildClaimTransactionResponse, C as ClaimAllocation, e as ClaimCommitRequest, p as ClaimHistoryItem, q as ClaimHistoryResponse, b as ClaimTransactionInstruction, c as ClaimTransactionRequest, d as ClaimTransactionResponse, f as ClaimableDistribution, o as ClaimableResponse, m as CommitClaimRequest, n as CommitClaimResponse, j as CommitDistributionRequest, k as CommitDistributionResponse, h as CreateDistributionRequest, i as CreateDistributionResponse, a as Distribution, D as DistributionStatus, H as HealthResponse, L as ListDistributionsRequest, g as ListDistributionsResponse } from './api-CQqyHbnT.js';
+export { DEFAULT_RPC_ENDPOINT, DISTRIBUTION_MEMO_PREFIX, MEMO_PROGRAM_ID, PERSISTENCE_WARNING_EVENT, PersistenceWarningRecord, XNET_2022_MINT, assertTruthy, buildDistributionMemoTag, clearPersistenceWarning, handlePersistenceWarningResponse, loadPersistenceWarnings, recordPersistenceWarning } from './core/index.js';
+export { r as BuildClaimTransactionRequest, s as BuildClaimTransactionResponse, B as BuildDistributionTransactionRequest, m as BuildDistributionTransactionResponse, C as ClaimAllocation, e as ClaimCommitRequest, w as ClaimHistoryItem, x as ClaimHistoryResponse, b as ClaimTransactionInstruction, c as ClaimTransactionRequest, d as ClaimTransactionResponse, f as ClaimableDistribution, v as ClaimableResponse, t as CommitClaimRequest, u as CommitClaimResponse, o as CommitDistributionRequest, p as CommitDistributionResponse, q as CommitDistributionSignatureInput, l as CreateDistributionRequest, n as CreateDistributionResponse, G as DEFAULT_BASE_PATH, a as Distribution, i as DistributionInstruction, j as DistributionPersistenceWarning, h as DistributionRecipientInput, D as DistributionStatus, k as DistributionTransactionPayload, F as Fetcher, H as HealthResponse, L as ListDistributionsRequest, g as ListDistributionsResponse, P as PrepareDistributionDraftRequest, y as PrepareDistributionDraftResponse, K as SyncReactError, I as SyncRequestConfig, S as SyncRequestOptions, z as buildDistributionTransaction, Q as buildUrl, A as commitDistributionSignature, R as isAbsoluteUrl, T as isRelativeUrl, E as prepareDistributionDraft, M as requestJSON, N as resolveFetcher, J as resolveRequestConfig, O as sanitizeBasePath } from './api-Cl-FACri.js';

package/dist/index.js

@@ -20,6 +20,18 @@ var __spreadValues = (a, b) => {
   return a;
 };
 var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+var __objRest = (source, exclude) => {
+  var target = {};
+  for (var prop in source)
+    if (__hasOwnProp.call(source, prop) && exclude.indexOf(prop) < 0)
+      target[prop] = source[prop];
+  if (source != null && __getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(source)) {
+      if (exclude.indexOf(prop) < 0 && __propIsEnum.call(source, prop))
+        target[prop] = source[prop];
+    }
+  return target;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -37,16 +49,33 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var index_exports = {};
 __export(index_exports, {
+  DEFAULT_BASE_PATH: () => DEFAULT_BASE_PATH,
   DEFAULT_RPC_ENDPOINT: () => DEFAULT_RPC_ENDPOINT,
   DISTRIBUTION_MEMO_PREFIX: () => DISTRIBUTION_MEMO_PREFIX,
   GET: () => GET,
   MEMO_PROGRAM_ID: () => MEMO_PROGRAM_ID,
+  PERSISTENCE_WARNING_EVENT: () => PERSISTENCE_WARNING_EVENT,
   POST: () => POST,
+  SyncReactError: () => SyncReactError,
   SyncServerClient: () => SyncServerClient,
   XNET_2022_MINT: () => XNET_2022_MINT,
   assertTruthy: () => assertTruthy,
   buildDistributionMemoTag: () => buildDistributionMemoTag,
+  buildDistributionTransaction: () => buildDistributionTransaction,
+  buildUrl: () => buildUrl,
+  clearPersistenceWarning: () => clearPersistenceWarning,
+  commitDistributionSignature: () => commitDistributionSignature,
   createMethodHandler: () => createMethodHandler,
+  handlePersistenceWarningResponse: () => handlePersistenceWarningResponse,
+  isAbsoluteUrl: () => isAbsoluteUrl,
+  isRelativeUrl: () => isRelativeUrl,
+  loadPersistenceWarnings: () => loadPersistenceWarnings,
+  prepareDistributionDraft: () => prepareDistributionDraft,
+  recordPersistenceWarning: () => recordPersistenceWarning,
+  requestJSON: () => requestJSON,
+  resolveFetcher: () => resolveFetcher,
+  resolveRequestConfig: () => resolveRequestConfig,
+  sanitizeBasePath: () => sanitizeBasePath,
   syncRouteHandler: () => syncRouteHandler
 });
 module.exports = __toCommonJS(index_exports);
@@ -195,9 +224,9 @@ function normalizeRole(role) {
   return String(role).trim().toLowerCase();
 }
 function resolveWalletFromMe(me) {
-  var _a, _b, _c, _d, _e;
+  var _a2, _b2, _c, _d, _e;
   if (!me || typeof me !== "object") return null;
-  const candidate = (me == null ? void 0 : me.wallet) || ((_a = me == null ? void 0 : me.user) == null ? void 0 : _a.wallet) || ((_b = me == null ? void 0 : me.user) == null ? void 0 : _b.pubkey) || ((_c = me == null ? void 0 : me.user) == null ? void 0 : _c.name) || ((_d = me == null ? void 0 : me.user) == null ? void 0 : _d.id) || null;
+  const candidate = (me == null ? void 0 : me.wallet) || ((_a2 = me == null ? void 0 : me.user) == null ? void 0 : _a2.wallet) || ((_b2 = me == null ? void 0 : me.user) == null ? void 0 : _b2.pubkey) || ((_c = me == null ? void 0 : me.user) == null ? void 0 : _c.name) || ((_d = me == null ? void 0 : me.user) == null ? void 0 : _d.id) || null;
   if (candidate && typeof candidate === "string" && candidate.length > 0) return candidate;
   const accounts = Array.isArray(me == null ? void 0 : me.accounts) ? me.accounts : [];
   const walletAccount = accounts.find((acct) => typeof (acct == null ? void 0 : acct.pubkey) === "string" && acct.pubkey.length > 0);
@@ -216,12 +245,12 @@ function requireDeployer(req) {
   throw new SyncHandlerError(403, "forbidden_deployer_role");
 }
 function getSessionWallet(req) {
-  var _a, _b;
+  var _a2, _b2;
   const direct = typeof req.wallet === "string" && req.wallet.length > 0 ? req.wallet : null;
   if (direct) return direct;
-  const authWallet = typeof ((_a = req.apiAuth) == null ? void 0 : _a.wallet) === "string" && req.apiAuth.wallet.length > 0 ? req.apiAuth.wallet : null;
+  const authWallet = typeof ((_a2 = req.apiAuth) == null ? void 0 : _a2.wallet) === "string" && req.apiAuth.wallet.length > 0 ? req.apiAuth.wallet : null;
   if (authWallet) return authWallet;
-  return resolveWalletFromMe((_b = req.apiAuth) == null ? void 0 : _b.me);
+  return resolveWalletFromMe((_b2 = req.apiAuth) == null ? void 0 : _b2.me);
 }
 function requireSessionWallet(req, expected) {
   const wallet = getSessionWallet(req);
@@ -313,17 +342,17 @@ async function handleClaimBuild(ctx, distributionId) {
   return Response.json(result);
 }
 async function handleClaimCommit(ctx, distributionId) {
-  var _a, _b, _c;
+  var _a2, _b2, _c;
   const body = await readJsonBody(ctx.req);
   const explicitWallet = coerceString(body.claimantPubkey) || coerceString(body.claimant) || coerceString(body.wallet);
   const claimant = requireSessionWallet(ctx.req, explicitWallet);
   const payload = __spreadValues({}, body);
   payload.distributionId = distributionId;
   payload.claimantPubkey = claimant;
-  const signature = (_a = coerceString(payload.signature)) != null ? _a : coerceString(body.signature);
+  const signature = (_a2 = coerceString(payload.signature)) != null ? _a2 : coerceString(body.signature);
   if (signature) payload.signature = signature;
   const signedTransactionBase64 = coerceString(body.signedTransactionBase64);
-  const transaction = (_c = (_b = coerceString(payload.transaction)) != null ? _b : coerceString(body.transaction)) != null ? _c : signedTransactionBase64;
+  const transaction = (_c = (_b2 = coerceString(payload.transaction)) != null ? _b2 : coerceString(body.transaction)) != null ? _c : signedTransactionBase64;
   if (transaction) payload.transaction = transaction;
   if (signedTransactionBase64) payload.signedTransactionBase64 = signedTransactionBase64;
   const hasSignature = typeof payload.signature === "string" && payload.signature.length > 0;
@@ -367,19 +396,19 @@ async function handleDistributionsRoute(ctx) {
 
 // src/server/handler/me.ts
 async function handleClaimsMeRoute(ctx) {
-  var _a, _b;
+  var _a2, _b2;
   if (ctx.method !== "GET") return null;
   if (ctx.segments.length > 0) return null;
   requireLoggedIn(ctx.req);
-  const result = await ctx.client.getClaimsMe((_b = (_a = ctx.url) == null ? void 0 : _a.searchParams) != null ? _b : void 0);
+  const result = await ctx.client.getClaimsMe((_b2 = (_a2 = ctx.url) == null ? void 0 : _a2.searchParams) != null ? _b2 : void 0);
   return Response.json(result);
 }
 async function handleDistributionsMeRoute(ctx) {
-  var _a, _b;
+  var _a2, _b2;
   if (ctx.method !== "GET") return null;
   requireLoggedIn(ctx.req);
   if (ctx.segments.length === 0) {
-    const result = await ctx.client.getDistributionsMe((_b = (_a = ctx.url) == null ? void 0 : _a.searchParams) != null ? _b : void 0);
+    const result = await ctx.client.getDistributionsMe((_b2 = (_a2 = ctx.url) == null ? void 0 : _a2.searchParams) != null ? _b2 : void 0);
     return Response.json(result);
   }
   if (ctx.segments.length === 1) {
@@ -394,7 +423,7 @@ async function handleDistributionsMeRoute(ctx) {
 var ALLOWED_METHODS = /* @__PURE__ */ new Set(["GET", "POST"]);
 var ALLOW_HEADER = "GET, POST";
 async function syncRouteHandler(req, context = {}, options = {}) {
-  var _a;
+  var _a2;
   const method = (req.method || "GET").toUpperCase();
   if (!ALLOWED_METHODS.has(method)) {
     return new Response(JSON.stringify({ error: "method_not_allowed" }), {
@@ -407,7 +436,7 @@ async function syncRouteHandler(req, context = {}, options = {}) {
   if (segments.length === 0) {
     return notFound();
   }
-  const logger = (_a = options.logger) != null ? _a : console;
+  const logger = (_a2 = options.logger) != null ? _a2 : console;
   let client;
   try {
     client = resolveClient(req, options);
@@ -457,9 +486,9 @@ function notFound() {
   return Response.json({ error: "not_found" }, { status: 404 });
 }
 function resolveClient(req, options) {
-  var _a, _b, _c;
+  var _a2, _b2, _c;
   if (options.client) return options.client;
-  const baseURL = (_c = (_b = (_a = options.baseURL) != null ? _a : process.env.SYNC_BASE_URL) != null ? _b : process.env.NEXT_PUBLIC_SYNC_BASE_URL) != null ? _c : "";
+  const baseURL = (_c = (_b2 = (_a2 = options.baseURL) != null ? _a2 : process.env.SYNC_BASE_URL) != null ? _b2 : process.env.NEXT_PUBLIC_SYNC_BASE_URL) != null ? _c : "";
   if (!baseURL) {
     throw new SyncHandlerError(500, "sync_base_url_missing", "SYNC_BASE_URL is not configured");
   }
@@ -472,12 +501,12 @@ function resolveClient(req, options) {
   return SyncServerClient.fromRequest(req, baseURL);
 }
 async function resolveSegments(req, context, url) {
-  var _a;
+  var _a2;
   const params = await resolveParams(context == null ? void 0 : context.params);
   if (params == null ? void 0 : params.fractalsSync) {
     return sanitizeSegments(params.fractalsSync);
   }
-  const pathname = (_a = url == null ? void 0 : url.pathname) != null ? _a : typeof req.url === "string" ? safePathname(req.url) : "";
+  const pathname = (_a2 = url == null ? void 0 : url.pathname) != null ? _a2 : typeof req.url === "string" ? safePathname(req.url) : "";
   if (!pathname) return [];
   const parts = pathname.split("/").filter(Boolean);
   if (parts.length === 0) return [];
@@ -488,10 +517,10 @@ async function resolveSegments(req, context, url) {
   return [];
 }
 async function resolveParams(params) {
-  var _a;
+  var _a2;
   if (!params) return null;
   if (typeof (params == null ? void 0 : params.then) === "function") {
-    return (_a = await params) != null ? _a : null;
+    return (_a2 = await params) != null ? _a2 : null;
   }
   return params != null ? params : null;
 }
@@ -518,14 +547,14 @@ function safePathname(url) {
   }
 }
 async function handleError(error, req, options, logger) {
-  var _a, _b;
+  var _a2, _b2;
   if (error instanceof SyncHandlerError) {
     if (error.code === "unauthorized" && options.onUnauthorized) {
       try {
         const custom = await options.onUnauthorized(req);
         if (custom) return custom;
       } catch (hookError) {
-        (_a = logger == null ? void 0 : logger.warn) == null ? void 0 : _a.call(logger, "[syncRouteHandler] onUnauthorized hook failed", hookError);
+        (_a2 = logger == null ? void 0 : logger.warn) == null ? void 0 : _a2.call(logger, "[syncRouteHandler] onUnauthorized hook failed", hookError);
       }
     }
     const payload = { error: error.code };
@@ -533,7 +562,7 @@ async function handleError(error, req, options, logger) {
     if (error.details !== void 0) payload.details = error.details;
     return Response.json(payload, { status: error.status });
   }
-  (_b = logger == null ? void 0 : logger.error) == null ? void 0 : _b.call(logger, "[syncRouteHandler] unhandled_error", error);
+  (_b2 = logger == null ? void 0 : logger.error) == null ? void 0 : _b2.call(logger, "[syncRouteHandler] unhandled_error", error);
   return Response.json({ error: "sync_handler_error" }, { status: 500 });
 }
 
@@ -553,17 +582,235 @@ function assertTruthy(value, message) {
   }
   return value;
 }
+
+// src/core/persistence.ts
+var STORAGE_PREFIX = "distribution:persistence-warning:";
+var PERSISTENCE_WARNING_EVENT = "distribution:persistence-warning";
+function isBrowser() {
+  return typeof window !== "undefined" && typeof localStorage !== "undefined";
+}
+function persistToStorage(record) {
+  if (!isBrowser()) return;
+  try {
+    localStorage.setItem(`${STORAGE_PREFIX}${record.id}`, JSON.stringify(record));
+  } catch (error) {
+    console.error("[sync:persistence-warning] Failed to write to localStorage", error);
+  }
+}
+function emitWarning(record) {
+  if (!isBrowser()) return;
+  try {
+    window.dispatchEvent(new CustomEvent(PERSISTENCE_WARNING_EVENT, { detail: record }));
+  } catch (error) {
+    console.error("[sync:persistence-warning] Failed to emit warning event", error);
+  }
+}
+function recordPersistenceWarning(input) {
+  var _a2;
+  if (!isBrowser()) return void 0;
+  const record = __spreadProps(__spreadValues({}, input), {
+    createdAt: (_a2 = input.createdAt) != null ? _a2 : Date.now()
+  });
+  persistToStorage(record);
+  emitWarning(record);
+  return record;
+}
+function handlePersistenceWarningResponse(response) {
+  var _a2;
+  if (!isBrowser() || !response || typeof response !== "object") return;
+  const warning = response.persistenceWarning;
+  if (!warning) return;
+  const distributionId = warning.distributionId || response.distributionId || "unknown";
+  const exportJson = (_a2 = response.exportJson) != null ? _a2 : warning.exportJson;
+  const reason = warning.reason || "persist_distribution_failed";
+  const message = warning.message || "We were unable to save your distribution draft. Download the JSON to avoid data loss.";
+  const key = warning.id || `${distributionId}:${reason}:${Date.now()}`;
+  recordPersistenceWarning({
+    id: key,
+    distributionId,
+    reason,
+    message,
+    detail: warning.detail,
+    exportJson
+  });
+}
+function loadPersistenceWarnings() {
+  if (!isBrowser()) return [];
+  const records = [];
+  try {
+    for (let i = 0; i < localStorage.length; i++) {
+      const key = localStorage.key(i);
+      if (!key || !key.startsWith(STORAGE_PREFIX)) continue;
+      const raw = localStorage.getItem(key);
+      if (!raw) continue;
+      try {
+        const parsed = JSON.parse(raw);
+        if (parsed && typeof parsed === "object") {
+          records.push(parsed);
+        }
+      } catch (e) {
+      }
+    }
+  } catch (error) {
+    console.error("[sync:persistence-warning] Failed to load warnings", error);
+  }
+  return records.sort((a, b) => b.createdAt - a.createdAt);
+}
+function clearPersistenceWarning(id) {
+  if (!isBrowser()) return;
+  try {
+    localStorage.removeItem(`${STORAGE_PREFIX}${id}`);
+  } catch (e) {
+  }
+}
+
+// src/core/http.ts
+var FALLBACK_BASE_PATH = "/api/v1/fractals-sync";
+var _a, _b;
+var ENV_BASE_PATH = typeof process !== "undefined" && (((_a = process.env) == null ? void 0 : _a.NEXT_PUBLIC_SYNC_PATH) || ((_b = process.env) == null ? void 0 : _b.NEXT_PUBLIC_FRACTALS_SYNC_PATH)) || void 0;
+var DEFAULT_BASE_PATH = sanitizeBasePath(ENV_BASE_PATH || FALLBACK_BASE_PATH);
+function resolveRequestConfig(options) {
+  return {
+    basePath: sanitizeBasePath((options == null ? void 0 : options.basePath) || DEFAULT_BASE_PATH),
+    fetcher: resolveFetcher(options == null ? void 0 : options.fetcher)
+  };
+}
+var SyncReactError = class extends Error {
+  constructor(status, code, details) {
+    super(code || `Sync request failed with status ${status}`);
+    this.status = status;
+    this.code = code;
+    this.details = details;
+    this.name = "SyncReactError";
+  }
+};
+async function requestJSON(config, path, init) {
+  var _a2;
+  const url = buildUrl(config.basePath, path);
+  const requestInit = prepareInit(init);
+  requestInit.credentials = (_a2 = requestInit.credentials) != null ? _a2 : isRelativeUrl(url) ? "include" : void 0;
+  const response = await config.fetcher(url, requestInit);
+  const payload = await parseResponseBody(response);
+  if (!response.ok) {
+    const errorCode = typeof payload === "object" && payload && "error" in payload ? String(payload.error) : void 0;
+    throw new SyncReactError(response.status, errorCode, payload);
+  }
+  return payload;
+}
+function resolveFetcher(custom) {
+  if (custom) return custom;
+  if (typeof fetch === "function") return fetch.bind(globalThis);
+  throw new Error("Global fetch is not available. Provide a fetcher via Sync configuration.");
+}
+function sanitizeBasePath(path) {
+  if (!path) return FALLBACK_BASE_PATH;
+  const trimmed = path.trim();
+  if (!trimmed || trimmed === "/") return "/";
+  return trimmed.replace(/\/+$/, "");
+}
+function buildUrl(basePath, path) {
+  if (path && isAbsoluteUrl(path)) return path;
+  const normalizedBase = sanitizeBasePath(basePath);
+  const suffix = path ? `/${path.replace(/^\/+/, "")}` : "";
+  if (!normalizedBase || normalizedBase === "/") {
+    return suffix ? suffix : normalizedBase;
+  }
+  return `${normalizedBase}${suffix}`;
+}
+function isAbsoluteUrl(path) {
+  return /^https?:\/\//i.test(path);
+}
+function isRelativeUrl(path) {
+  return !isAbsoluteUrl(path);
+}
+function prepareInit(init) {
+  const finalInit = __spreadValues({}, init);
+  if ((init == null ? void 0 : init.headers) instanceof Headers) {
+    const cloned = new Headers(init.headers);
+    if (!cloned.has("content-type")) cloned.set("content-type", "application/json");
+    finalInit.headers = cloned;
+    return finalInit;
+  }
+  const headers = new Headers(init == null ? void 0 : init.headers);
+  if (!headers.has("content-type")) {
+    headers.set("content-type", "application/json");
+  }
+  finalInit.headers = headers;
+  return finalInit;
+}
+async function parseResponseBody(response) {
+  if (response.status === 204) return void 0;
+  const text = await response.text();
+  if (!text) return void 0;
+  try {
+    return JSON.parse(text);
+  } catch (e) {
+    return text;
+  }
+}
+
+// src/core/api.ts
+async function buildDistributionTransaction(input, options) {
+  const config = resolveRequestConfig(options);
+  const path = (input == null ? void 0 : input.distributionId) ? `/distributions/${encodeURIComponent(input.distributionId)}/create-transaction` : "/distributions/create-transaction";
+  const payload = await requestJSON(config, path, {
+    method: "POST",
+    body: JSON.stringify(input)
+  });
+  handlePersistenceWarningResponse(payload);
+  return payload;
+}
+async function commitDistributionSignature(input, options) {
+  const distributionId = input == null ? void 0 : input.distributionId;
+  if (!distributionId) {
+    throw new SyncReactError(400, "distribution_id_required");
+  }
+  const config = resolveRequestConfig(options);
+  const _a2 = input, { distributionId: _unused } = _a2, body = __objRest(_a2, ["distributionId"]);
+  return requestJSON(
+    config,
+    `/distributions/${encodeURIComponent(distributionId)}/commit`,
+    {
+      method: "POST",
+      body: JSON.stringify(body)
+    }
+  );
+}
+async function prepareDistributionDraft(input, options) {
+  const config = resolveRequestConfig(options);
+  return requestJSON(config, "/distributions/prepare", {
+    method: "POST",
+    body: JSON.stringify(input)
+  });
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  DEFAULT_BASE_PATH,
   DEFAULT_RPC_ENDPOINT,
   DISTRIBUTION_MEMO_PREFIX,
   GET,
   MEMO_PROGRAM_ID,
+  PERSISTENCE_WARNING_EVENT,
   POST,
+  SyncReactError,
   SyncServerClient,
   XNET_2022_MINT,
   assertTruthy,
   buildDistributionMemoTag,
+  buildDistributionTransaction,
+  buildUrl,
+  clearPersistenceWarning,
+  commitDistributionSignature,
   createMethodHandler,
+  handlePersistenceWarningResponse,
+  isAbsoluteUrl,
+  isRelativeUrl,
+  loadPersistenceWarnings,
+  prepareDistributionDraft,
+  recordPersistenceWarning,
+  requestJSON,
+  resolveFetcher,
+  resolveRequestConfig,
+  sanitizeBasePath,
   syncRouteHandler
 });

package/dist/index.mjs

@@ -1,29 +1,63 @@
 import {
+  DEFAULT_BASE_PATH,
   DEFAULT_RPC_ENDPOINT,
   DISTRIBUTION_MEMO_PREFIX,
   MEMO_PROGRAM_ID,
+  PERSISTENCE_WARNING_EVENT,
+  SyncReactError,
   XNET_2022_MINT,
   assertTruthy,
-  buildDistributionMemoTag
-} from "./chunk-TCJM2GIK.mjs";
+  buildDistributionMemoTag,
+  buildDistributionTransaction,
+  buildUrl,
+  clearPersistenceWarning,
+  commitDistributionSignature,
+  handlePersistenceWarningResponse,
+  isAbsoluteUrl,
+  isRelativeUrl,
+  loadPersistenceWarnings,
+  prepareDistributionDraft,
+  recordPersistenceWarning,
+  requestJSON,
+  resolveFetcher,
+  resolveRequestConfig,
+  sanitizeBasePath
+} from "./chunk-VXNOPXKB.mjs";
 import {
   GET,
   POST,
   SyncServerClient,
   createMethodHandler,
   syncRouteHandler
-} from "./chunk-BHPW43XZ.mjs";
-import "./chunk-I4E63NIC.mjs";
+} from "./chunk-JZGD7RD2.mjs";
+import "./chunk-FWCSY2DS.mjs";
 export {
+  DEFAULT_BASE_PATH,
   DEFAULT_RPC_ENDPOINT,
   DISTRIBUTION_MEMO_PREFIX,
   GET,
   MEMO_PROGRAM_ID,
+  PERSISTENCE_WARNING_EVENT,
   POST,
+  SyncReactError,
   SyncServerClient,
   XNET_2022_MINT,
   assertTruthy,
   buildDistributionMemoTag,
+  buildDistributionTransaction,
+  buildUrl,
+  clearPersistenceWarning,
+  commitDistributionSignature,
   createMethodHandler,
+  handlePersistenceWarningResponse,
+  isAbsoluteUrl,
+  isRelativeUrl,
+  loadPersistenceWarnings,
+  prepareDistributionDraft,
+  recordPersistenceWarning,
+  requestJSON,
+  resolveFetcher,
+  resolveRequestConfig,
+  sanitizeBasePath,
   syncRouteHandler
 };

package/dist/react/index.d.mts

@@ -1,9 +1,8 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { UseQueryOptions, UseQueryResult, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
-import { g as ListDistributionsResponse, a as Distribution, o as ClaimableResponse, q as ClaimHistoryResponse, B as BuildClaimTransactionRequest, l as BuildClaimTransactionResponse, m as CommitClaimRequest, n as CommitClaimResponse } from '../api-CQqyHbnT.mjs';
+import { F as Fetcher, g as ListDistributionsResponse, K as SyncReactError, a as Distribution, B as BuildDistributionTransactionRequest, k as DistributionTransactionPayload, q as CommitDistributionSignatureInput, p as CommitDistributionResponse, v as ClaimableResponse, x as ClaimHistoryResponse, r as BuildClaimTransactionRequest, s as BuildClaimTransactionResponse, t as CommitClaimRequest, u as CommitClaimResponse } from '../api-Cl-FACri.mjs';
 
-type Fetcher = typeof fetch;
 interface SyncContextValue {
     basePath: string;
     fetcher?: Fetcher;
@@ -21,20 +20,64 @@ interface SyncClient {
     post<T>(path: string, body?: unknown, init?: RequestInit): Promise<T>;
 }
 declare function useSyncClient(): SyncClient;
-declare class SyncReactError extends Error {
-    readonly status: number;
-    readonly code?: string | undefined;
-    readonly details?: unknown | undefined;
-    constructor(status: number, code?: string | undefined, details?: unknown | undefined);
-}
 type QueryOptions<T> = Omit<UseQueryOptions<T, SyncReactError, T>, "queryKey" | "queryFn">;
-declare function useDistributions<TResponse = ListDistributionsResponse>(options?: QueryOptions<TResponse>): UseQueryResult<TResponse, SyncReactError>;
+interface DistributionsQueryParams {
+    role?: "claimant" | "creator";
+    status?: string | null;
+}
+declare function useDistributions<TResponse = ListDistributionsResponse>(paramsOrOptions?: DistributionsQueryParams | QueryOptions<TResponse>, optionsMaybe?: QueryOptions<TResponse>): UseQueryResult<TResponse, SyncReactError>;
 declare function useDistribution<TResponse = Distribution>(distributionId: string | null | undefined, options?: QueryOptions<TResponse>): UseQueryResult<TResponse, SyncReactError>;
+type DistributionTransactionInput = BuildDistributionTransactionRequest;
+declare function useDistributionTransaction(options?: UseMutationOptions<DistributionTransactionPayload, SyncReactError, DistributionTransactionInput>): UseMutationResult<DistributionTransactionPayload, SyncReactError, DistributionTransactionInput>;
+type DistributionCommitInput = CommitDistributionSignatureInput;
+declare function useCommitDistribution(options?: UseMutationOptions<CommitDistributionResponse, SyncReactError, DistributionCommitInput>): UseMutationResult<CommitDistributionResponse, SyncReactError, DistributionCommitInput>;
+interface DistributionFlowState {
+    latestPayload: DistributionTransactionPayload | null;
+    building: boolean;
+    committing: boolean;
+    error: SyncReactError | null;
+}
+type DistributionFlowSignerInput = Partial<Omit<CommitDistributionSignatureInput, "distributionId">> & {
+    [key: string]: unknown;
+};
+type DistributionFlowSigner = (payload: DistributionTransactionPayload) => Promise<DistributionFlowSignerInput> | DistributionFlowSignerInput;
+interface DistributionFlowCommitResult {
+    payload: DistributionTransactionPayload;
+    commit: CommitDistributionResponse;
+    signerInput: DistributionFlowSignerInput;
+}
+interface DistributionFlowResult {
+    state: DistributionFlowState;
+    build: (input: DistributionTransactionInput) => Promise<DistributionTransactionPayload>;
+    commit: (signer: DistributionFlowSigner, input?: DistributionTransactionInput) => Promise<DistributionFlowCommitResult>;
+    claim: (signer: DistributionFlowSigner, input?: DistributionTransactionInput) => Promise<DistributionFlowCommitResult>;
+    reset: () => void;
+}
+declare function useDistributionFlow(): DistributionFlowResult;
 declare function useClaimableDistributions<TResponse = ClaimableResponse>(options?: QueryOptions<TResponse>): UseQueryResult<TResponse, SyncReactError>;
 declare function useClaimHistory<TResponse = ClaimHistoryResponse>(options?: QueryOptions<TResponse>): UseQueryResult<TResponse, SyncReactError>;
 type ClaimTransactionInput = Partial<Omit<BuildClaimTransactionRequest, "distributionId" | "claimant">>;
 declare function useClaimTransaction(distributionId: string | null | undefined, options?: UseMutationOptions<BuildClaimTransactionResponse, SyncReactError, ClaimTransactionInput>): UseMutationResult<BuildClaimTransactionResponse, SyncReactError, ClaimTransactionInput>;
 type ClaimCommitInput = Omit<CommitClaimRequest, "distributionId">;
 declare function useCommitClaim(distributionId: string | null | undefined, options?: UseMutationOptions<CommitClaimResponse, SyncReactError, ClaimCommitInput>): UseMutationResult<CommitClaimResponse, SyncReactError, ClaimCommitInput>;
+interface ClaimFlowState {
+    latestPayload: BuildClaimTransactionResponse | null;
+    building: boolean;
+    claiming: boolean;
+    error: SyncReactError | null;
+}
+type ClaimFlowSigner = (payload: BuildClaimTransactionResponse) => Promise<ClaimCommitInput> | ClaimCommitInput;
+interface ClaimFlowClaimResult {
+    payload: BuildClaimTransactionResponse;
+    commit: CommitClaimResponse;
+    signerInput: ClaimCommitInput;
+}
+interface ClaimFlowResult {
+    state: ClaimFlowState;
+    build: (input?: ClaimTransactionInput) => Promise<BuildClaimTransactionResponse>;
+    claim: (signer: ClaimFlowSigner, input?: ClaimTransactionInput) => Promise<ClaimFlowClaimResult>;
+    reset: () => void;
+}
+declare function useClaimFlow(distributionId: string | null | undefined): ClaimFlowResult;
 
-export { type ClaimCommitInput, type ClaimTransactionInput, type SyncClient, SyncProvider, type SyncProviderProps, SyncReactError, useClaimHistory, useClaimTransaction, useClaimableDistributions, useCommitClaim, useDistribution, useDistributions, useSyncClient };
+export { type ClaimCommitInput, type ClaimFlowClaimResult, type ClaimFlowResult, type ClaimFlowSigner, type ClaimFlowState, type ClaimTransactionInput, type DistributionCommitInput, type DistributionFlowCommitResult, type DistributionFlowResult, type DistributionFlowSigner, type DistributionFlowSignerInput, type DistributionFlowState, type DistributionTransactionInput, type DistributionsQueryParams, type SyncClient, SyncProvider, type SyncProviderProps, useClaimFlow, useClaimHistory, useClaimTransaction, useClaimableDistributions, useCommitClaim, useCommitDistribution, useDistribution, useDistributionFlow, useDistributionTransaction, useDistributions, useSyncClient };