@fractalshq/sync 0.0.4 → 0.0.6

package/dist/react/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 });
@@ -38,23 +50,191 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var react_exports = {};
 __export(react_exports, {
   SyncProvider: () => SyncProvider,
-  SyncReactError: () => SyncReactError,
   useClaimFlow: () => useClaimFlow,
   useClaimHistory: () => useClaimHistory,
   useClaimTransaction: () => useClaimTransaction,
   useClaimableDistributions: () => useClaimableDistributions,
   useCommitClaim: () => useCommitClaim,
+  useCommitDistribution: () => useCommitDistribution,
   useDistribution: () => useDistribution,
+  useDistributionFlow: () => useDistributionFlow,
+  useDistributionTransaction: () => useDistributionTransaction,
   useDistributions: () => useDistributions,
   useSyncClient: () => useSyncClient
 });
 module.exports = __toCommonJS(react_exports);
 var import_react = require("react");
 var import_react_query = require("@tanstack/react-query");
+
+// src/core/constants.ts
+var DEFAULT_RPC_ENDPOINT = process.env.NEXT_PUBLIC_SOLANA_RPC_URL || "https://api.mainnet-beta.solana.com";
+
+// 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
+  });
+}
+
+// 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)
+    }
+  );
+}
+
+// src/react/index.tsx
 var SyncContext = (0, import_react.createContext)({ basePath: DEFAULT_BASE_PATH });
 function SyncProvider({ basePath, fetcher, children }) {
   const value = (0, import_react.useMemo)(
@@ -67,13 +247,11 @@ function SyncProvider({ basePath, fetcher, children }) {
   return (0, import_react.createElement)(SyncContext.Provider, { value }, children);
 }
 function useSyncClient() {
-  const context = (0, import_react.useContext)(SyncContext);
-  const basePath = sanitizeBasePath((context == null ? void 0 : context.basePath) || DEFAULT_BASE_PATH);
-  const fetcher = resolveFetcher(context == null ? void 0 : context.fetcher);
+  const requestConfig = useSyncRequestConfig();
   return (0, import_react.useMemo)(() => {
-    const request = (path, init) => requestJSON({ basePath, fetcher }, path, init);
+    const request = (path, init) => requestJSON(requestConfig, path, init);
     return {
-      basePath,
+      basePath: requestConfig.basePath,
       request,
       get: (path, init) => request(path, __spreadProps(__spreadValues({}, init), { method: "GET" })),
       post: (path, body, init) => {
@@ -84,22 +262,16 @@ function useSyncClient() {
         return request(path, finalInit);
       }
     };
-  }, [basePath, fetcher]);
+  }, [requestConfig]);
 }
-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";
-  }
-};
-function useDistributions(options) {
+function useDistributions(paramsOrOptions, optionsMaybe) {
+  var _a2, _b2;
   const client = useSyncClient();
+  const { params, options } = resolveDistributionsArgs(paramsOrOptions, optionsMaybe);
+  const path = buildDistributionsPath(params);
   return (0, import_react_query.useQuery)(__spreadValues({
-    queryKey: ["sync", "distributions", "me"],
-    queryFn: () => client.get("/distributions/me")
+    queryKey: ["sync", "distributions", "me", (_a2 = params == null ? void 0 : params.role) != null ? _a2 : "claimant", (_b2 = params == null ? void 0 : params.status) != null ? _b2 : "all"],
+    queryFn: () => client.get(path)
   }, options));
 }
 function useDistribution(distributionId, options) {
@@ -113,6 +285,88 @@ function useDistribution(distributionId, options) {
     enabled: Boolean(id) && ((_a2 = options == null ? void 0 : options.enabled) != null ? _a2 : true)
   }));
 }
+function useDistributionTransaction(options) {
+  const requestConfig = useSyncRequestConfig();
+  return (0, import_react_query.useMutation)(__spreadValues({
+    mutationFn: async (input) => {
+      if (!input) throw new SyncReactError(400, "distribution_input_required");
+      return buildDistributionTransaction(input, requestConfig);
+    }
+  }, options));
+}
+function useCommitDistribution(options) {
+  const requestConfig = useSyncRequestConfig();
+  return (0, import_react_query.useMutation)(__spreadValues({
+    mutationFn: async (input) => {
+      if (!(input == null ? void 0 : input.distributionId)) throw new SyncReactError(400, "distribution_id_required");
+      return commitDistributionSignature(input, requestConfig);
+    }
+  }, options));
+}
+function useDistributionFlow() {
+  var _a2, _b2;
+  const buildMutation = useDistributionTransaction();
+  const commitMutation = useCommitDistribution();
+  const [latestPayload, setLatestPayload] = (0, import_react.useState)(null);
+  const [latestInput, setLatestInput] = (0, import_react.useState)(null);
+  const build = (0, import_react.useCallback)(
+    async (input) => {
+      const payload = await buildMutation.mutateAsync(input);
+      setLatestPayload(payload);
+      setLatestInput(cloneDistributionInput(input));
+      return payload;
+    },
+    [buildMutation]
+  );
+  const doCommit = (0, import_react.useCallback)(
+    async (signer, input) => {
+      let payload = null;
+      if (input) {
+        payload = await build(input);
+      } else if (latestInput) {
+        payload = await build(latestInput);
+      } else if (latestPayload) {
+        payload = latestPayload;
+      }
+      if (!payload) {
+        throw new SyncReactError(400, "distribution_payload_missing");
+      }
+      if (!payload.distributionId) {
+        throw new SyncReactError(400, "distribution_id_required");
+      }
+      const signerInput = await signer(payload);
+      if (!signerInput || !signerInput.signature && !signerInput.transaction && !signerInput.signedTransactionBase64) {
+        throw new SyncReactError(400, "distribution_signature_required");
+      }
+      const commitPayload = __spreadProps(__spreadValues({}, signerInput), {
+        distributionId: payload.distributionId
+      });
+      if (!commitPayload.exportJson && payload.exportJson) {
+        commitPayload.exportJson = payload.exportJson;
+      }
+      const commitResult = await commitMutation.mutateAsync(commitPayload);
+      return { payload, commit: commitResult, signerInput };
+    },
+    [build, latestInput, latestPayload, commitMutation]
+  );
+  const reset = (0, import_react.useCallback)(() => {
+    setLatestPayload(null);
+    setLatestInput(null);
+    buildMutation.reset();
+    commitMutation.reset();
+  }, [buildMutation, commitMutation]);
+  const error = (_b2 = (_a2 = buildMutation.error) != null ? _a2 : commitMutation.error) != null ? _b2 : null;
+  const state = (0, import_react.useMemo)(
+    () => ({
+      latestPayload,
+      building: buildMutation.isPending,
+      committing: commitMutation.isPending,
+      error
+    }),
+    [latestPayload, buildMutation.isPending, commitMutation.isPending, error]
+  );
+  return { state, build, commit: doCommit, claim: doCommit, reset };
+}
 function useClaimableDistributions(options) {
   const client = useSyncClient();
   return (0, import_react_query.useQuery)(__spreadValues({
@@ -186,80 +440,50 @@ function useClaimFlow(distributionId) {
   };
   return { state, build, claim, reset };
 }
-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 useSyncRequestConfig() {
+  const context = (0, import_react.useContext)(SyncContext);
+  const basePath = sanitizeBasePath((context == null ? void 0 : context.basePath) || DEFAULT_BASE_PATH);
+  const fetcher = resolveFetcher(context == null ? void 0 : context.fetcher);
+  return (0, import_react.useMemo)(() => ({ basePath, fetcher }), [basePath, fetcher]);
 }
-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;
+function cloneDistributionInput(input) {
+  return __spreadProps(__spreadValues({}, input), {
+    recipients: input.recipients.map((recipient) => __spreadValues({}, recipient))
+  });
 }
-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;
+function resolveDistributionsArgs(paramsOrOptions, optionsMaybe) {
+  if (isDistributionsParams(paramsOrOptions)) {
+    return { params: paramsOrOptions, options: optionsMaybe };
   }
+  return { params: void 0, options: paramsOrOptions };
 }
-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 <SyncProvider fetcher={...}>.");
+function isDistributionsParams(arg) {
+  if (!arg || typeof arg !== "object") return false;
+  return "role" in arg || "status" in arg;
 }
-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;
+function buildDistributionsPath(params) {
+  const search = new URLSearchParams();
+  if ((params == null ? void 0 : params.role) && params.role !== "claimant") {
+    search.set("role", params.role);
   }
-  return `${normalizedBase}${suffix}`;
-}
-function isAbsoluteUrl(path) {
-  return /^https?:\/\//i.test(path);
-}
-function isRelativeUrl(path) {
-  return !isAbsoluteUrl(path);
+  if (params == null ? void 0 : params.status) {
+    search.set("status", params.status);
+  }
+  const qs = search.toString();
+  return qs ? `/distributions/me?${qs}` : "/distributions/me";
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SyncProvider,
-  SyncReactError,
   useClaimFlow,
   useClaimHistory,
   useClaimTransaction,
   useClaimableDistributions,
   useCommitClaim,
+  useCommitDistribution,
   useDistribution,
+  useDistributionFlow,
+  useDistributionTransaction,
   useDistributions,
   useSyncClient
 });