@fractalshq/sync 0.0.5 → 0.0.7

package/LICENSE

@@ -0,0 +1,24 @@
+MIT License
+
+Copyright (c) 2025 Fractals
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+
+
+

package/dist/api-C0dGK-PK.d.mts

@@ -0,0 +1,203 @@
+type DistributionStatus = "draft" | "committed" | "clawed_back" | "hidden";
+interface Distribution {
+    id: string;
+    orgId: string;
+    mint: string;
+    status: DistributionStatus;
+    createdAt: string;
+    updatedAt?: string;
+    totalUnlocked?: string;
+    totalLocked?: string;
+}
+interface ClaimAllocation {
+    distributorId: string;
+    claimant: string;
+    amountUnlocked: string;
+    amountLocked?: string;
+    proof?: string[];
+    idx?: number;
+}
+interface ClaimTransactionInstruction {
+    programId: string;
+    keys: Array<{
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }>;
+    data: string;
+}
+interface ClaimTransactionRequest {
+    distributionId: string;
+    claimant: string;
+    index?: number;
+    proof?: string[];
+    unlockedAmount?: number;
+    lockedAmount?: number;
+    mint?: string;
+    distributorPda?: string;
+    rpcEndpoint?: string;
+}
+interface ClaimTransactionResponse {
+    label: string;
+    instructions: ClaimTransactionInstruction[];
+    transaction?: string;
+}
+interface ClaimCommitRequest {
+    distributionId: string;
+    signature: string;
+}
+interface ClaimableDistribution {
+    distributorId: string;
+    distributorName?: string;
+    tokenMint: string;
+    tokenSymbol?: string;
+    owedAmount: string;
+    status: "claimable" | "vesting" | "locked";
+    fees?: {
+        fixedFee?: string;
+        solFee?: string;
+    };
+}
+
+type Fetcher = typeof fetch;
+declare const DEFAULT_BASE_PATH: string;
+interface SyncRequestOptions {
+    basePath?: string;
+    fetcher?: Fetcher;
+}
+interface SyncRequestConfig {
+    basePath: string;
+    fetcher: Fetcher;
+}
+declare function resolveRequestConfig(options?: SyncRequestOptions): SyncRequestConfig;
+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);
+}
+declare function requestJSON<T>(config: SyncRequestConfig, path: string, init?: RequestInit): Promise<T>;
+declare function resolveFetcher(custom?: Fetcher): Fetcher;
+declare function sanitizeBasePath(path: string): string;
+declare function buildUrl(basePath: string, path: string): string;
+declare function isAbsoluteUrl(path: string): boolean;
+declare function isRelativeUrl(path: string): boolean;
+
+interface ListDistributionsRequest {
+    orgId?: string;
+    status?: DistributionStatus;
+    mint?: string;
+    limit?: number;
+    cursor?: string;
+}
+interface ListDistributionsResponse {
+    items: Distribution[];
+    nextCursor: string | null;
+}
+interface DistributionRecipientInput {
+    address: string;
+    shareBps: number;
+}
+interface DistributionInstruction {
+    programId: string;
+    keys: Array<{
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }>;
+    data: string;
+}
+interface DistributionPersistenceWarning {
+    id?: string;
+    reason: string;
+    message: string;
+    distributionId?: string;
+    detail?: unknown;
+    exportJson?: unknown;
+}
+interface DistributionTransactionPayload {
+    distributionId: string;
+    label?: string;
+    instructions: DistributionInstruction[];
+    transaction?: string;
+    preview?: unknown;
+    exportJson?: unknown;
+    persistenceWarning?: DistributionPersistenceWarning;
+    title?: string | null;
+    [key: string]: unknown;
+}
+interface BuildDistributionTransactionRequest {
+    owner: string;
+    amountUi: number;
+    recipients: DistributionRecipientInput[];
+    mint: string;
+    distributionId?: string;
+    rpcEndpoint?: string;
+    title?: string;
+    [key: string]: unknown;
+}
+type CreateDistributionRequest = BuildDistributionTransactionRequest;
+type BuildDistributionTransactionResponse = DistributionTransactionPayload;
+type CreateDistributionResponse = DistributionTransactionPayload;
+interface CommitDistributionRequest {
+    transaction?: string;
+    signedTransactionBase64?: string;
+    signature?: string;
+    exportJson?: unknown;
+    [key: string]: unknown;
+}
+interface CommitDistributionResponse {
+    success: boolean;
+    distributorId: string;
+    signature?: string;
+    status?: DistributionStatus | string;
+    alreadyCommitted?: boolean;
+    [key: string]: unknown;
+}
+interface CommitDistributionSignatureInput extends CommitDistributionRequest {
+    distributionId: string;
+}
+type BuildClaimTransactionRequest = ClaimTransactionRequest;
+type BuildClaimTransactionResponse = ClaimTransactionResponse;
+interface CommitClaimRequest {
+    distributionId: string;
+    signature?: string;
+    transaction?: string;
+    signedTransactionBase64?: string;
+    claimantPubkey?: string;
+    [key: string]: unknown;
+}
+interface CommitClaimResponse {
+    ok: boolean;
+}
+interface ClaimableResponse {
+    wallet: string;
+    claimable: ClaimableDistribution[];
+}
+interface ClaimHistoryItem {
+    distributorId: string;
+    signature: string;
+    claimedAmount: string;
+    claimedAt: string;
+}
+interface ClaimHistoryResponse {
+    items: ClaimHistoryItem[];
+    nextCursor: string | null;
+}
+interface HealthResponse {
+    status: string;
+    timestamp: string;
+}
+interface PrepareDistributionDraftRequest {
+    projectId: string;
+    mint: string;
+    title?: string;
+}
+interface PrepareDistributionDraftResponse {
+    id: string;
+}
+declare function buildDistributionTransaction(input: BuildDistributionTransactionRequest, options?: SyncRequestOptions): Promise<DistributionTransactionPayload>;
+declare function commitDistributionSignature(input: CommitDistributionSignatureInput, options?: SyncRequestOptions): Promise<CommitDistributionResponse>;
+declare function prepareDistributionDraft(input: PrepareDistributionDraftRequest, options?: SyncRequestOptions): Promise<PrepareDistributionDraftResponse>;
+
+export { commitDistributionSignature as A, type BuildDistributionTransactionRequest as B, type ClaimAllocation as C, type DistributionStatus as D, prepareDistributionDraft as E, type Fetcher as F, DEFAULT_BASE_PATH as G, type HealthResponse as H, type SyncRequestConfig as I, resolveRequestConfig as J, SyncReactError as K, type ListDistributionsRequest as L, requestJSON as M, resolveFetcher as N, sanitizeBasePath as O, type PrepareDistributionDraftRequest as P, buildUrl as Q, isAbsoluteUrl as R, type SyncRequestOptions as S, isRelativeUrl as T, type Distribution as a, type ClaimTransactionInstruction as b, type ClaimTransactionRequest as c, type ClaimTransactionResponse as d, type ClaimCommitRequest as e, type ClaimableDistribution as f, type ListDistributionsResponse as g, type DistributionRecipientInput as h, type DistributionInstruction as i, type DistributionPersistenceWarning as j, type DistributionTransactionPayload as k, type CreateDistributionRequest as l, type BuildDistributionTransactionResponse as m, type CreateDistributionResponse as n, type CommitDistributionRequest as o, type CommitDistributionResponse as p, type CommitDistributionSignatureInput as q, type BuildClaimTransactionRequest as r, type BuildClaimTransactionResponse as s, type CommitClaimRequest as t, type CommitClaimResponse as u, type ClaimableResponse as v, type ClaimHistoryItem as w, type ClaimHistoryResponse as x, type PrepareDistributionDraftResponse as y, buildDistributionTransaction as z };

package/dist/api-C0dGK-PK.d.ts

@@ -0,0 +1,203 @@
+type DistributionStatus = "draft" | "committed" | "clawed_back" | "hidden";
+interface Distribution {
+    id: string;
+    orgId: string;
+    mint: string;
+    status: DistributionStatus;
+    createdAt: string;
+    updatedAt?: string;
+    totalUnlocked?: string;
+    totalLocked?: string;
+}
+interface ClaimAllocation {
+    distributorId: string;
+    claimant: string;
+    amountUnlocked: string;
+    amountLocked?: string;
+    proof?: string[];
+    idx?: number;
+}
+interface ClaimTransactionInstruction {
+    programId: string;
+    keys: Array<{
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }>;
+    data: string;
+}
+interface ClaimTransactionRequest {
+    distributionId: string;
+    claimant: string;
+    index?: number;
+    proof?: string[];
+    unlockedAmount?: number;
+    lockedAmount?: number;
+    mint?: string;
+    distributorPda?: string;
+    rpcEndpoint?: string;
+}
+interface ClaimTransactionResponse {
+    label: string;
+    instructions: ClaimTransactionInstruction[];
+    transaction?: string;
+}
+interface ClaimCommitRequest {
+    distributionId: string;
+    signature: string;
+}
+interface ClaimableDistribution {
+    distributorId: string;
+    distributorName?: string;
+    tokenMint: string;
+    tokenSymbol?: string;
+    owedAmount: string;
+    status: "claimable" | "vesting" | "locked";
+    fees?: {
+        fixedFee?: string;
+        solFee?: string;
+    };
+}
+
+type Fetcher = typeof fetch;
+declare const DEFAULT_BASE_PATH: string;
+interface SyncRequestOptions {
+    basePath?: string;
+    fetcher?: Fetcher;
+}
+interface SyncRequestConfig {
+    basePath: string;
+    fetcher: Fetcher;
+}
+declare function resolveRequestConfig(options?: SyncRequestOptions): SyncRequestConfig;
+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);
+}
+declare function requestJSON<T>(config: SyncRequestConfig, path: string, init?: RequestInit): Promise<T>;
+declare function resolveFetcher(custom?: Fetcher): Fetcher;
+declare function sanitizeBasePath(path: string): string;
+declare function buildUrl(basePath: string, path: string): string;
+declare function isAbsoluteUrl(path: string): boolean;
+declare function isRelativeUrl(path: string): boolean;
+
+interface ListDistributionsRequest {
+    orgId?: string;
+    status?: DistributionStatus;
+    mint?: string;
+    limit?: number;
+    cursor?: string;
+}
+interface ListDistributionsResponse {
+    items: Distribution[];
+    nextCursor: string | null;
+}
+interface DistributionRecipientInput {
+    address: string;
+    shareBps: number;
+}
+interface DistributionInstruction {
+    programId: string;
+    keys: Array<{
+        pubkey: string;
+        isSigner: boolean;
+        isWritable: boolean;
+    }>;
+    data: string;
+}
+interface DistributionPersistenceWarning {
+    id?: string;
+    reason: string;
+    message: string;
+    distributionId?: string;
+    detail?: unknown;
+    exportJson?: unknown;
+}
+interface DistributionTransactionPayload {
+    distributionId: string;
+    label?: string;
+    instructions: DistributionInstruction[];
+    transaction?: string;
+    preview?: unknown;
+    exportJson?: unknown;
+    persistenceWarning?: DistributionPersistenceWarning;
+    title?: string | null;
+    [key: string]: unknown;
+}
+interface BuildDistributionTransactionRequest {
+    owner: string;
+    amountUi: number;
+    recipients: DistributionRecipientInput[];
+    mint: string;
+    distributionId?: string;
+    rpcEndpoint?: string;
+    title?: string;
+    [key: string]: unknown;
+}
+type CreateDistributionRequest = BuildDistributionTransactionRequest;
+type BuildDistributionTransactionResponse = DistributionTransactionPayload;
+type CreateDistributionResponse = DistributionTransactionPayload;
+interface CommitDistributionRequest {
+    transaction?: string;
+    signedTransactionBase64?: string;
+    signature?: string;
+    exportJson?: unknown;
+    [key: string]: unknown;
+}
+interface CommitDistributionResponse {
+    success: boolean;
+    distributorId: string;
+    signature?: string;
+    status?: DistributionStatus | string;
+    alreadyCommitted?: boolean;
+    [key: string]: unknown;
+}
+interface CommitDistributionSignatureInput extends CommitDistributionRequest {
+    distributionId: string;
+}
+type BuildClaimTransactionRequest = ClaimTransactionRequest;
+type BuildClaimTransactionResponse = ClaimTransactionResponse;
+interface CommitClaimRequest {
+    distributionId: string;
+    signature?: string;
+    transaction?: string;
+    signedTransactionBase64?: string;
+    claimantPubkey?: string;
+    [key: string]: unknown;
+}
+interface CommitClaimResponse {
+    ok: boolean;
+}
+interface ClaimableResponse {
+    wallet: string;
+    claimable: ClaimableDistribution[];
+}
+interface ClaimHistoryItem {
+    distributorId: string;
+    signature: string;
+    claimedAmount: string;
+    claimedAt: string;
+}
+interface ClaimHistoryResponse {
+    items: ClaimHistoryItem[];
+    nextCursor: string | null;
+}
+interface HealthResponse {
+    status: string;
+    timestamp: string;
+}
+interface PrepareDistributionDraftRequest {
+    projectId: string;
+    mint: string;
+    title?: string;
+}
+interface PrepareDistributionDraftResponse {
+    id: string;
+}
+declare function buildDistributionTransaction(input: BuildDistributionTransactionRequest, options?: SyncRequestOptions): Promise<DistributionTransactionPayload>;
+declare function commitDistributionSignature(input: CommitDistributionSignatureInput, options?: SyncRequestOptions): Promise<CommitDistributionResponse>;
+declare function prepareDistributionDraft(input: PrepareDistributionDraftRequest, options?: SyncRequestOptions): Promise<PrepareDistributionDraftResponse>;
+
+export { commitDistributionSignature as A, type BuildDistributionTransactionRequest as B, type ClaimAllocation as C, type DistributionStatus as D, prepareDistributionDraft as E, type Fetcher as F, DEFAULT_BASE_PATH as G, type HealthResponse as H, type SyncRequestConfig as I, resolveRequestConfig as J, SyncReactError as K, type ListDistributionsRequest as L, requestJSON as M, resolveFetcher as N, sanitizeBasePath as O, type PrepareDistributionDraftRequest as P, buildUrl as Q, isAbsoluteUrl as R, type SyncRequestOptions as S, isRelativeUrl as T, type Distribution as a, type ClaimTransactionInstruction as b, type ClaimTransactionRequest as c, type ClaimTransactionResponse as d, type ClaimCommitRequest as e, type ClaimableDistribution as f, type ListDistributionsResponse as g, type DistributionRecipientInput as h, type DistributionInstruction as i, type DistributionPersistenceWarning as j, type DistributionTransactionPayload as k, type CreateDistributionRequest as l, type BuildDistributionTransactionResponse as m, type CreateDistributionResponse as n, type CommitDistributionRequest as o, type CommitDistributionResponse as p, type CommitDistributionSignatureInput as q, type BuildClaimTransactionRequest as r, type BuildClaimTransactionResponse as s, type CommitClaimRequest as t, type CommitClaimResponse as u, type ClaimableResponse as v, type ClaimHistoryItem as w, type ClaimHistoryResponse as x, type PrepareDistributionDraftResponse as y, buildDistributionTransaction as z };

package/dist/core/index.d.mts

@@ -1,4 +1,4 @@
-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.mjs';
+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-C0dGK-PK.mjs';
 
 declare const MEMO_PROGRAM_ID = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
 declare const XNET_2022_MINT = "xNETbUB7cRb3AAu2pNG2pUwQcJ2BHcktfvSB8x1Pq6L";

package/dist/core/index.d.ts

@@ -1,4 +1,4 @@
-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';
+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-C0dGK-PK.js';
 
 declare const MEMO_PROGRAM_ID = "MemoSq4gqABAXKb96qnH8TysNcWxMyWCqXgDLGmfcHr";
 declare const XNET_2022_MINT = "xNETbUB7cRb3AAu2pNG2pUwQcJ2BHcktfvSB8x1Pq6L";

package/dist/index.d.mts

@@ -1,3 +1,3 @@
 export { ApiAuthRequest, GET, POST, SyncHandlerOptions, SyncServerClient, SyncServerOptions, createMethodHandler, syncRouteHandler } from './server/index.mjs';
 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.mjs';
-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.mjs';
+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-C0dGK-PK.mjs';

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, 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';
+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-C0dGK-PK.js';

package/dist/react/index.d.mts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { UseQueryOptions, UseQueryResult, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
-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';
+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-C0dGK-PK.mjs';
 
 interface SyncContextValue {
     basePath: string;
@@ -79,5 +79,33 @@ interface ClaimFlowResult {
     reset: () => void;
 }
 declare function useClaimFlow(distributionId: string | null | undefined): ClaimFlowResult;
+interface RecipientComposerRow {
+    id: string;
+    address: string;
+    amount: string;
+}
+type RecipientRow = RecipientComposerRow;
+interface RecipientComposerState {
+    rows: RecipientComposerRow[];
+    totals: {
+        count: number;
+        totalAmount: number;
+        normalized: Array<{
+            id: string;
+            address: string;
+            amount: number;
+            shareBps: number;
+        }>;
+    };
+}
+interface RecipientComposerApi {
+    state: RecipientComposerState;
+    addRow: () => void;
+    removeRow: (id: string) => void;
+    updateRow: (id: string, patch: Partial<Omit<RecipientComposerRow, "id">>) => void;
+    replaceRows: (rows: Array<Pick<RecipientComposerRow, "address" | "amount">>) => void;
+    clearRows: () => void;
+}
+declare function useRecipientComposer(initial?: Array<Pick<RecipientComposerRow, "address" | "amount">>): RecipientComposerApi;
 
-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 };
+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 RecipientComposerApi, type RecipientComposerRow, type RecipientComposerState, type RecipientRow, type SyncClient, SyncProvider, type SyncProviderProps, useClaimFlow, useClaimHistory, useClaimTransaction, useClaimableDistributions, useCommitClaim, useCommitDistribution, useDistribution, useDistributionFlow, useDistributionTransaction, useDistributions, useRecipientComposer, useSyncClient };

package/dist/react/index.d.ts

@@ -1,7 +1,7 @@
 import * as react from 'react';
 import { ReactNode } from 'react';
 import { UseQueryOptions, UseQueryResult, UseMutationOptions, UseMutationResult } from '@tanstack/react-query';
-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.js';
+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-C0dGK-PK.js';
 
 interface SyncContextValue {
     basePath: string;
@@ -79,5 +79,33 @@ interface ClaimFlowResult {
     reset: () => void;
 }
 declare function useClaimFlow(distributionId: string | null | undefined): ClaimFlowResult;
+interface RecipientComposerRow {
+    id: string;
+    address: string;
+    amount: string;
+}
+type RecipientRow = RecipientComposerRow;
+interface RecipientComposerState {
+    rows: RecipientComposerRow[];
+    totals: {
+        count: number;
+        totalAmount: number;
+        normalized: Array<{
+            id: string;
+            address: string;
+            amount: number;
+            shareBps: number;
+        }>;
+    };
+}
+interface RecipientComposerApi {
+    state: RecipientComposerState;
+    addRow: () => void;
+    removeRow: (id: string) => void;
+    updateRow: (id: string, patch: Partial<Omit<RecipientComposerRow, "id">>) => void;
+    replaceRows: (rows: Array<Pick<RecipientComposerRow, "address" | "amount">>) => void;
+    clearRows: () => void;
+}
+declare function useRecipientComposer(initial?: Array<Pick<RecipientComposerRow, "address" | "amount">>): RecipientComposerApi;
 
-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 };
+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 RecipientComposerApi, type RecipientComposerRow, type RecipientComposerState, type RecipientRow, type SyncClient, SyncProvider, type SyncProviderProps, useClaimFlow, useClaimHistory, useClaimTransaction, useClaimableDistributions, useCommitClaim, useCommitDistribution, useDistribution, useDistributionFlow, useDistributionTransaction, useDistributions, useRecipientComposer, useSyncClient };

package/dist/react/index.js

@@ -60,6 +60,7 @@ __export(react_exports, {
   useDistributionFlow: () => useDistributionFlow,
   useDistributionTransaction: () => useDistributionTransaction,
   useDistributions: () => useDistributions,
+  useRecipientComposer: () => useRecipientComposer,
   useSyncClient: () => useSyncClient
 });
 module.exports = __toCommonJS(react_exports);
@@ -472,6 +473,65 @@ function buildDistributionsPath(params) {
   const qs = search.toString();
   return qs ? `/distributions/me?${qs}` : "/distributions/me";
 }
+function createRecipientRowId() {
+  return `recipient-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function hydrateRecipientRow(partial) {
+  var _a2, _b2;
+  return {
+    id: createRecipientRowId(),
+    address: (_a2 = partial == null ? void 0 : partial.address) != null ? _a2 : "",
+    amount: (_b2 = partial == null ? void 0 : partial.amount) != null ? _b2 : ""
+  };
+}
+function useRecipientComposer(initial = []) {
+  const [rows, setRows] = (0, import_react.useState)(() => {
+    if (initial.length === 0) return [hydrateRecipientRow()];
+    return initial.map((row) => hydrateRecipientRow(row));
+  });
+  const addRow = (0, import_react.useCallback)(() => {
+    setRows((current) => [...current, hydrateRecipientRow()]);
+  }, []);
+  const removeRow = (0, import_react.useCallback)((id) => {
+    setRows((current) => {
+      if (current.length <= 1) return [hydrateRecipientRow()];
+      return current.filter((row) => row.id !== id);
+    });
+  }, []);
+  const updateRow = (0, import_react.useCallback)((id, patch) => {
+    setRows((current) => current.map((row) => row.id === id ? __spreadValues(__spreadValues({}, row), patch) : row));
+  }, []);
+  const replaceRows = (0, import_react.useCallback)((incoming) => {
+    if (!incoming.length) {
+      setRows([hydrateRecipientRow()]);
+      return;
+    }
+    setRows(incoming.map((row) => hydrateRecipientRow(row)));
+  }, []);
+  const clearRows = (0, import_react.useCallback)(() => {
+    setRows([hydrateRecipientRow()]);
+  }, []);
+  const totals = (0, import_react.useMemo)(() => {
+    const normalized = rows.map((row) => ({ id: row.id, address: row.address.trim(), amount: Number(row.amount) || 0 }));
+    const totalAmount = normalized.reduce((sum, row) => sum + Math.max(0, row.amount), 0);
+    const withShare = normalized.map((row) => __spreadProps(__spreadValues({}, row), {
+      shareBps: totalAmount > 0 ? Math.round(Math.max(0, row.amount) / totalAmount * 1e4) : 0
+    }));
+    return {
+      count: rows.length,
+      totalAmount,
+      normalized: withShare
+    };
+  }, [rows]);
+  return {
+    state: { rows, totals },
+    addRow,
+    removeRow,
+    updateRow,
+    replaceRows,
+    clearRows
+  };
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   SyncProvider,
@@ -485,5 +545,6 @@ function buildDistributionsPath(params) {
   useDistributionFlow,
   useDistributionTransaction,
   useDistributions,
+  useRecipientComposer,
   useSyncClient
 });

package/dist/react/index.mjs

@@ -252,6 +252,65 @@ function buildDistributionsPath(params) {
   const qs = search.toString();
   return qs ? `/distributions/me?${qs}` : "/distributions/me";
 }
+function createRecipientRowId() {
+  return `recipient-${Date.now().toString(36)}-${Math.random().toString(36).slice(2, 8)}`;
+}
+function hydrateRecipientRow(partial) {
+  var _a, _b;
+  return {
+    id: createRecipientRowId(),
+    address: (_a = partial == null ? void 0 : partial.address) != null ? _a : "",
+    amount: (_b = partial == null ? void 0 : partial.amount) != null ? _b : ""
+  };
+}
+function useRecipientComposer(initial = []) {
+  const [rows, setRows] = useState(() => {
+    if (initial.length === 0) return [hydrateRecipientRow()];
+    return initial.map((row) => hydrateRecipientRow(row));
+  });
+  const addRow = useCallback(() => {
+    setRows((current) => [...current, hydrateRecipientRow()]);
+  }, []);
+  const removeRow = useCallback((id) => {
+    setRows((current) => {
+      if (current.length <= 1) return [hydrateRecipientRow()];
+      return current.filter((row) => row.id !== id);
+    });
+  }, []);
+  const updateRow = useCallback((id, patch) => {
+    setRows((current) => current.map((row) => row.id === id ? __spreadValues(__spreadValues({}, row), patch) : row));
+  }, []);
+  const replaceRows = useCallback((incoming) => {
+    if (!incoming.length) {
+      setRows([hydrateRecipientRow()]);
+      return;
+    }
+    setRows(incoming.map((row) => hydrateRecipientRow(row)));
+  }, []);
+  const clearRows = useCallback(() => {
+    setRows([hydrateRecipientRow()]);
+  }, []);
+  const totals = useMemo(() => {
+    const normalized = rows.map((row) => ({ id: row.id, address: row.address.trim(), amount: Number(row.amount) || 0 }));
+    const totalAmount = normalized.reduce((sum, row) => sum + Math.max(0, row.amount), 0);
+    const withShare = normalized.map((row) => __spreadProps(__spreadValues({}, row), {
+      shareBps: totalAmount > 0 ? Math.round(Math.max(0, row.amount) / totalAmount * 1e4) : 0
+    }));
+    return {
+      count: rows.length,
+      totalAmount,
+      normalized: withShare
+    };
+  }, [rows]);
+  return {
+    state: { rows, totals },
+    addRow,
+    removeRow,
+    updateRow,
+    replaceRows,
+    clearRows
+  };
+}
 export {
   SyncProvider,
   useClaimFlow,
@@ -264,5 +323,6 @@ export {
   useDistributionFlow,
   useDistributionTransaction,
   useDistributions,
+  useRecipientComposer,
   useSyncClient
 };

package/dist/server/index.d.mts

@@ -1,4 +1,4 @@
-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';
+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-C0dGK-PK.mjs';
 
 type QueryInit = string | URLSearchParams | Record<string, string | number | boolean | null | undefined>;
 type HeaderInjector = () => Promise<HeadersInit> | HeadersInit;

package/dist/server/index.d.ts

@@ -1,4 +1,4 @@
-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';
+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-C0dGK-PK.js';
 
 type QueryInit = string | URLSearchParams | Record<string, string | number | boolean | null | undefined>;
 type HeaderInjector = () => Promise<HeadersInit> | HeadersInit;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fractalshq/sync",
-  "version": "0.0.5",
+  "version": "0.0.7",
   "description": "Fractals Sync SDK: shared types, server client, React hooks, and widgets",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -51,8 +51,8 @@
     "sdk",
     "fractals"
   ],
-  "author": "Fractals <hello@fractals.sh>",
-  "license": "SEE LICENSE IN LICENSE.md",
+  "author": "Fractals <max@fractals.fun>",
+  "license": "MIT",
   "dependencies": {
     "@fractalshq/auth-core": "^0.1.9",
     "@fractalshq/jito-distributor-sdk": "^1.0.7",