@fractalshq/sync 0.1.1 → 0.1.2

package/README.md

@@ -58,8 +58,35 @@ const buildTx = useClaimTransaction();
 buildTx.mutateAsync({ distributionId, claimant: wallet });
 ```
 
+### UI-only flow (bring your own signer)
+
+V2 is build-only: it returns a transaction payload and you wire signing/sending yourself.
+Show the signature optimistically, then rely on eventual consistency for history.
+
+```tsx
+import { useClaimTransaction } from "@fractalshq/sync/v2/react";
+
+const buildTx = useClaimTransaction();
+
+async function handleClaim(item: { distributorId: string }, wallet: string) {
+  const payload = await buildTx.mutateAsync({
+    distributionId: item.distributorId,
+    claimant: wallet,
+  });
+
+  // App-owned: build a Transaction from payload.transaction (base64) or payload.instructions.
+  const tx = buildTransactionFromPayload(payload);
+  const signed = await signTransaction(tx);
+  const signature = await connection.sendRawTransaction(signed.serialize());
+
+  // UI-owned: optimistic link + pending state until the next refresh.
+  setOptimisticSignature(signature);
+}
+```
+
 Notes:
-- Default base path is `/api/v2` (override via `NEXT_PUBLIC_SYNC_V2_PATH`).
+- Default base path is `https://sync.fractals.fun/api/v2` (override via `NEXT_PUBLIC_SYNC_V2_PATH`).
+- For other environments, set `NEXT_PUBLIC_SYNC_V2_PATH` to an absolute `/api/v2` base URL.
 - V2 requests are `credentials: "omit"` for public CORS mode.
 - If `wallet` is omitted, `useClaims` falls back to the Solana wallet adapter context (`@solana/wallet-adapter-react`).
 

package/dist/chunk-4VKCXC52.mjs

@@ -0,0 +1,129 @@
+import {
+  __objRest,
+  __spreadValues
+} from "./chunk-FWCSY2DS.mjs";
+
+// src/v2/core/http.ts
+var FALLBACK_BASE_PATH = "https://sync.fractals.fun/api/v2";
+var _a, _b;
+var ENV_BASE_PATH = typeof process !== "undefined" && (((_a = process.env) == null ? void 0 : _a.NEXT_PUBLIC_SYNC_V2_PATH) || ((_b = process.env) == null ? void 0 : _b.NEXT_PUBLIC_FRACTALS_SYNC_V2_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 : "omit";
+  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/v2/core/api.ts
+async function buildClaimTransaction(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,
+    `/claims/${encodeURIComponent(distributionId)}/create-transaction`,
+    {
+      method: "POST",
+      body: JSON.stringify(body)
+    }
+  );
+}
+async function listClaims(wallet, options) {
+  if (!wallet) {
+    throw new SyncReactError(400, "wallet_required");
+  }
+  const config = resolveRequestConfig(options);
+  const qs = new URLSearchParams({ wallet }).toString();
+  return requestJSON(config, `/claims?${qs}`, { method: "GET" });
+}
+
+export {
+  DEFAULT_BASE_PATH,
+  resolveRequestConfig,
+  SyncReactError,
+  requestJSON,
+  resolveFetcher,
+  sanitizeBasePath,
+  buildUrl,
+  isAbsoluteUrl,
+  isRelativeUrl,
+  buildClaimTransaction,
+  listClaims
+};

package/dist/index.js

@@ -61,7 +61,7 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 
 // src/v2/core/http.ts
-var FALLBACK_BASE_PATH = "/api/v2";
+var FALLBACK_BASE_PATH = "https://sync.fractals.fun/api/v2";
 var _a, _b;
 var ENV_BASE_PATH = typeof process !== "undefined" && (((_a = process.env) == null ? void 0 : _a.NEXT_PUBLIC_SYNC_V2_PATH) || ((_b = process.env) == null ? void 0 : _b.NEXT_PUBLIC_FRACTALS_SYNC_V2_PATH)) || void 0;
 var DEFAULT_BASE_PATH = sanitizeBasePath(ENV_BASE_PATH || FALLBACK_BASE_PATH);

package/dist/index.mjs

@@ -11,7 +11,7 @@ import {
   resolveFetcher,
   resolveRequestConfig,
   sanitizeBasePath
-} from "./chunk-4ZYNBLY5.mjs";
+} from "./chunk-4VKCXC52.mjs";
 import "./chunk-FWCSY2DS.mjs";
 export {
   DEFAULT_BASE_PATH,

package/dist/v1/index.mjs

@@ -1,3 +1,10 @@
+import {
+  GET,
+  POST,
+  SyncServerClient,
+  createMethodHandler,
+  syncRouteHandler
+} from "../chunk-ZIWHYEXE.mjs";
 import {
   DEFAULT_BASE_PATH,
   DEFAULT_RPC_ENDPOINT,
@@ -23,13 +30,6 @@ import {
   resolveRequestConfig,
   sanitizeBasePath
 } from "../chunk-FBL2T6BA.mjs";
-import {
-  GET,
-  POST,
-  SyncServerClient,
-  createMethodHandler,
-  syncRouteHandler
-} from "../chunk-ZIWHYEXE.mjs";
 import "../chunk-FWCSY2DS.mjs";
 export {
   DEFAULT_BASE_PATH,

package/dist/v2/core/index.js

@@ -61,7 +61,7 @@ __export(core_exports, {
 module.exports = __toCommonJS(core_exports);
 
 // src/v2/core/http.ts
-var FALLBACK_BASE_PATH = "/api/v2";
+var FALLBACK_BASE_PATH = "https://sync.fractals.fun/api/v2";
 var _a, _b;
 var ENV_BASE_PATH = typeof process !== "undefined" && (((_a = process.env) == null ? void 0 : _a.NEXT_PUBLIC_SYNC_V2_PATH) || ((_b = process.env) == null ? void 0 : _b.NEXT_PUBLIC_FRACTALS_SYNC_V2_PATH)) || void 0;
 var DEFAULT_BASE_PATH = sanitizeBasePath(ENV_BASE_PATH || FALLBACK_BASE_PATH);

package/dist/v2/core/index.mjs

@@ -10,7 +10,7 @@ import {
   resolveFetcher,
   resolveRequestConfig,
   sanitizeBasePath
-} from "../../chunk-4ZYNBLY5.mjs";
+} from "../../chunk-4VKCXC52.mjs";
 import "../../chunk-FWCSY2DS.mjs";
 export {
   DEFAULT_BASE_PATH,

package/dist/v2/index.js

@@ -61,7 +61,7 @@ __export(v2_exports, {
 module.exports = __toCommonJS(v2_exports);
 
 // src/v2/core/http.ts
-var FALLBACK_BASE_PATH = "/api/v2";
+var FALLBACK_BASE_PATH = "https://sync.fractals.fun/api/v2";
 var _a, _b;
 var ENV_BASE_PATH = typeof process !== "undefined" && (((_a = process.env) == null ? void 0 : _a.NEXT_PUBLIC_SYNC_V2_PATH) || ((_b = process.env) == null ? void 0 : _b.NEXT_PUBLIC_FRACTALS_SYNC_V2_PATH)) || void 0;
 var DEFAULT_BASE_PATH = sanitizeBasePath(ENV_BASE_PATH || FALLBACK_BASE_PATH);

package/dist/v2/index.mjs

@@ -11,7 +11,7 @@ import {
   resolveFetcher,
   resolveRequestConfig,
   sanitizeBasePath
-} from "../chunk-4ZYNBLY5.mjs";
+} from "../chunk-4VKCXC52.mjs";
 import "../chunk-FWCSY2DS.mjs";
 export {
   DEFAULT_BASE_PATH,

package/dist/v2/react/index.js

@@ -60,7 +60,7 @@ var import_wallet_adapter_react = require("@solana/wallet-adapter-react");
 var import_react_query = require("@tanstack/react-query");
 
 // src/v2/core/http.ts
-var FALLBACK_BASE_PATH = "/api/v2";
+var FALLBACK_BASE_PATH = "https://sync.fractals.fun/api/v2";
 var _a, _b;
 var ENV_BASE_PATH = typeof process !== "undefined" && (((_a = process.env) == null ? void 0 : _a.NEXT_PUBLIC_SYNC_V2_PATH) || ((_b = process.env) == null ? void 0 : _b.NEXT_PUBLIC_FRACTALS_SYNC_V2_PATH)) || void 0;
 var DEFAULT_BASE_PATH = sanitizeBasePath(ENV_BASE_PATH || FALLBACK_BASE_PATH);

package/dist/v2/react/index.mjs

@@ -6,7 +6,7 @@ import {
   requestJSON,
   resolveFetcher,
   sanitizeBasePath
-} from "../../chunk-4ZYNBLY5.mjs";
+} from "../../chunk-4VKCXC52.mjs";
 import {
   __spreadProps,
   __spreadValues

package/package.json

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