@fractalshq/sync 0.0.3 → 0.0.5

package/dist/react/index.mjs

@@ -1,15 +1,20 @@
+import {
+  DEFAULT_BASE_PATH,
+  SyncReactError,
+  buildDistributionTransaction,
+  commitDistributionSignature,
+  requestJSON,
+  resolveFetcher,
+  sanitizeBasePath
+} from "../chunk-VXNOPXKB.mjs";
 import {
   __spreadProps,
   __spreadValues
-} from "../chunk-I4E63NIC.mjs";
+} from "../chunk-FWCSY2DS.mjs";
 
 // src/react/index.tsx
-import { createContext, createElement, useContext, useMemo } from "react";
+import { createContext, createElement, useCallback, useContext, useMemo, useState } from "react";
 import { useMutation, useQuery } from "@tanstack/react-query";
-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);
 var SyncContext = createContext({ basePath: DEFAULT_BASE_PATH });
 function SyncProvider({ basePath, fetcher, children }) {
   const value = useMemo(
@@ -22,13 +27,11 @@ function SyncProvider({ basePath, fetcher, children }) {
   return createElement(SyncContext.Provider, { value }, children);
 }
 function useSyncClient() {
-  const context = 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 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) => {
@@ -39,35 +42,111 @@ function useSyncClient() {
         return request(path, finalInit);
       }
     };
-  }, [basePath, 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";
-  }
-};
-function useDistributions(options) {
+  }, [requestConfig]);
+}
+function useDistributions(paramsOrOptions, optionsMaybe) {
+  var _a, _b;
   const client = useSyncClient();
+  const { params, options } = resolveDistributionsArgs(paramsOrOptions, optionsMaybe);
+  const path = buildDistributionsPath(params);
   return useQuery(__spreadValues({
-    queryKey: ["sync", "distributions", "me"],
-    queryFn: () => client.get("/distributions/me")
+    queryKey: ["sync", "distributions", "me", (_a = params == null ? void 0 : params.role) != null ? _a : "claimant", (_b = params == null ? void 0 : params.status) != null ? _b : "all"],
+    queryFn: () => client.get(path)
   }, options));
 }
 function useDistribution(distributionId, options) {
-  var _a2;
+  var _a;
   const client = useSyncClient();
   const id = distributionId ? encodeURIComponent(distributionId) : "";
   return useQuery(__spreadProps(__spreadValues({
     queryKey: ["sync", "distribution", id],
     queryFn: () => client.get(`/distributions/me/${id}`)
   }, options), {
-    enabled: Boolean(id) && ((_a2 = options == null ? void 0 : options.enabled) != null ? _a2 : true)
+    enabled: Boolean(id) && ((_a = options == null ? void 0 : options.enabled) != null ? _a : true)
   }));
 }
+function useDistributionTransaction(options) {
+  const requestConfig = useSyncRequestConfig();
+  return 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 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 _a, _b;
+  const buildMutation = useDistributionTransaction();
+  const commitMutation = useCommitDistribution();
+  const [latestPayload, setLatestPayload] = useState(null);
+  const [latestInput, setLatestInput] = useState(null);
+  const build = useCallback(
+    async (input) => {
+      const payload = await buildMutation.mutateAsync(input);
+      setLatestPayload(payload);
+      setLatestInput(cloneDistributionInput(input));
+      return payload;
+    },
+    [buildMutation]
+  );
+  const doCommit = 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 = useCallback(() => {
+    setLatestPayload(null);
+    setLatestInput(null);
+    buildMutation.reset();
+    commitMutation.reset();
+  }, [buildMutation, commitMutation]);
+  const error = (_b = (_a = buildMutation.error) != null ? _a : commitMutation.error) != null ? _b : null;
+  const state = 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 useQuery(__spreadValues({
@@ -105,78 +184,85 @@ function useCommitClaim(distributionId, options) {
     }
   }, options));
 }
-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 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;
-  }
+function useClaimFlow(distributionId) {
+  var _a, _b;
+  const buildMutation = useClaimTransaction(distributionId);
+  const commitMutation = useCommitClaim(distributionId);
+  const [latestPayload, setLatestPayload] = useState(null);
+  const build = useCallback(
+    async (input) => {
+      const payload = await buildMutation.mutateAsync(input != null ? input : {});
+      setLatestPayload(payload);
+      return payload;
+    },
+    [buildMutation]
+  );
+  const claim = useCallback(
+    async (signer, input) => {
+      const payload = await build(input);
+      const signerInput = await signer(payload);
+      if (!signerInput || !signerInput.signature && !signerInput.transaction && !signerInput.signedTransactionBase64) {
+        throw new SyncReactError(400, "claim_signature_required");
+      }
+      const commit = await commitMutation.mutateAsync(signerInput);
+      return { payload, commit, signerInput };
+    },
+    [build, commitMutation]
+  );
+  const reset = useCallback(() => {
+    setLatestPayload(null);
+  }, []);
+  const state = {
+    latestPayload,
+    building: buildMutation.isPending,
+    claiming: commitMutation.isPending,
+    error: (_b = (_a = buildMutation.error) != null ? _a : commitMutation.error) != null ? _b : null
+  };
+  return { state, build, claim, reset };
 }
-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 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 useSyncRequestConfig() {
+  const context = useContext(SyncContext);
+  const basePath = sanitizeBasePath((context == null ? void 0 : context.basePath) || DEFAULT_BASE_PATH);
+  const fetcher = resolveFetcher(context == null ? void 0 : context.fetcher);
+  return useMemo(() => ({ basePath, fetcher }), [basePath, fetcher]);
+}
+function cloneDistributionInput(input) {
+  return __spreadProps(__spreadValues({}, input), {
+    recipients: input.recipients.map((recipient) => __spreadValues({}, recipient))
+  });
+}
+function resolveDistributionsArgs(paramsOrOptions, optionsMaybe) {
+  if (isDistributionsParams(paramsOrOptions)) {
+    return { params: paramsOrOptions, options: optionsMaybe };
   }
-  return `${normalizedBase}${suffix}`;
+  return { params: void 0, options: paramsOrOptions };
 }
-function isAbsoluteUrl(path) {
-  return /^https?:\/\//i.test(path);
+function isDistributionsParams(arg) {
+  if (!arg || typeof arg !== "object") return false;
+  return "role" in arg || "status" in arg;
 }
-function isRelativeUrl(path) {
-  return !isAbsoluteUrl(path);
+function buildDistributionsPath(params) {
+  const search = new URLSearchParams();
+  if ((params == null ? void 0 : params.role) && params.role !== "claimant") {
+    search.set("role", params.role);
+  }
+  if (params == null ? void 0 : params.status) {
+    search.set("status", params.status);
+  }
+  const qs = search.toString();
+  return qs ? `/distributions/me?${qs}` : "/distributions/me";
 }
 export {
   SyncProvider,
-  SyncReactError,
+  useClaimFlow,
   useClaimHistory,
   useClaimTransaction,
   useClaimableDistributions,
   useCommitClaim,
+  useCommitDistribution,
   useDistribution,
+  useDistributionFlow,
+  useDistributionTransaction,
   useDistributions,
   useSyncClient
 };

package/dist/server/index.d.mts

@@ -1,4 +1,4 @@
-import { L as ListDistributionsRequest, g as ListDistributionsResponse, h as CreateDistributionRequest, i as CreateDistributionResponse, j as CommitDistributionRequest, k as CommitDistributionResponse, B as BuildClaimTransactionRequest, d as ClaimTransactionResponse, m as CommitClaimRequest, n as CommitClaimResponse, o as ClaimableResponse, a as Distribution, q as ClaimHistoryResponse, H as HealthResponse } from '../api-CQqyHbnT.mjs';
+import { L as ListDistributionsRequest, g as ListDistributionsResponse, l as CreateDistributionRequest, k as DistributionTransactionPayload, o as CommitDistributionRequest, p as CommitDistributionResponse, r as BuildClaimTransactionRequest, d as ClaimTransactionResponse, t as CommitClaimRequest, u as CommitClaimResponse, v as ClaimableResponse, a as Distribution, x as ClaimHistoryResponse, H as HealthResponse } from '../api-Cl-FACri.mjs';
 
 type QueryInit = string | URLSearchParams | Record<string, string | number | boolean | null | undefined>;
 type HeaderInjector = () => Promise<HeadersInit> | HeadersInit;
@@ -15,8 +15,8 @@ declare class SyncServerClient {
     private buildQueryString;
     private withQuery;
     listDistributions(params?: ListDistributionsRequest): Promise<ListDistributionsResponse>;
-    createDistribution(body: CreateDistributionRequest): Promise<CreateDistributionResponse>;
-    createDistributionWithId(distributionId: string, body: CreateDistributionRequest): Promise<CreateDistributionResponse>;
+    createDistribution(body: CreateDistributionRequest): Promise<DistributionTransactionPayload>;
+    createDistributionWithId(distributionId: string, body: CreateDistributionRequest): Promise<DistributionTransactionPayload>;
     commitDistribution(distributionId: string, body: CommitDistributionRequest): Promise<CommitDistributionResponse>;
     buildClaimTransaction(body: BuildClaimTransactionRequest): Promise<ClaimTransactionResponse>;
     commitClaim(body: CommitClaimRequest): Promise<CommitClaimResponse>;

package/dist/server/index.d.ts

@@ -1,4 +1,4 @@
-import { L as ListDistributionsRequest, g as ListDistributionsResponse, h as CreateDistributionRequest, i as CreateDistributionResponse, j as CommitDistributionRequest, k as CommitDistributionResponse, B as BuildClaimTransactionRequest, d as ClaimTransactionResponse, m as CommitClaimRequest, n as CommitClaimResponse, o as ClaimableResponse, a as Distribution, q as ClaimHistoryResponse, H as HealthResponse } from '../api-CQqyHbnT.js';
+import { L as ListDistributionsRequest, g as ListDistributionsResponse, l as CreateDistributionRequest, k as DistributionTransactionPayload, o as CommitDistributionRequest, p as CommitDistributionResponse, r as BuildClaimTransactionRequest, d as ClaimTransactionResponse, t as CommitClaimRequest, u as CommitClaimResponse, v as ClaimableResponse, a as Distribution, x as ClaimHistoryResponse, H as HealthResponse } from '../api-Cl-FACri.js';
 
 type QueryInit = string | URLSearchParams | Record<string, string | number | boolean | null | undefined>;
 type HeaderInjector = () => Promise<HeadersInit> | HeadersInit;
@@ -15,8 +15,8 @@ declare class SyncServerClient {
     private buildQueryString;
     private withQuery;
     listDistributions(params?: ListDistributionsRequest): Promise<ListDistributionsResponse>;
-    createDistribution(body: CreateDistributionRequest): Promise<CreateDistributionResponse>;
-    createDistributionWithId(distributionId: string, body: CreateDistributionRequest): Promise<CreateDistributionResponse>;
+    createDistribution(body: CreateDistributionRequest): Promise<DistributionTransactionPayload>;
+    createDistributionWithId(distributionId: string, body: CreateDistributionRequest): Promise<DistributionTransactionPayload>;
     commitDistribution(distributionId: string, body: CommitDistributionRequest): Promise<CommitDistributionResponse>;
     buildClaimTransaction(body: BuildClaimTransactionRequest): Promise<ClaimTransactionResponse>;
     commitClaim(body: CommitClaimRequest): Promise<CommitClaimResponse>;

package/dist/server/index.mjs

@@ -4,8 +4,8 @@ import {
   SyncServerClient,
   createMethodHandler,
   syncRouteHandler
-} from "../chunk-BHPW43XZ.mjs";
-import "../chunk-I4E63NIC.mjs";
+} from "../chunk-JZGD7RD2.mjs";
+import "../chunk-FWCSY2DS.mjs";
 export {
   GET,
   POST,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractalshq/sync",
-  "version": "0.0.3",
+  "version": "0.0.5",
   "description": "Fractals Sync SDK: shared types, server client, React hooks, and widgets",
   "main": "dist/index.js",
   "module": "dist/index.mjs",