@fractalshq/sync 0.0.1

package/README.md

@@ -0,0 +1,24 @@
+# @fractalshq/sync
+
+Fractals Sync is the all-in-one SDK for the distribution platform. It ships as a single package with subpath exports so integrators can pick only what they need:
+
+```
+@fractalshq/sync/core     // shared types + helpers (pure TS)
+@fractalshq/sync/server   // Node/Next client that talks to /api/v1
+@fractalshq/sync/react    // hooks that assume AuthProvider + wallet context
+@fractalshq/sync/widgets  // drop-in UI with its own provider stack
+```
+
+## Layout
+
+```
+packages/sync/
+├── src/
+│   ├── core/      // typed constants, schemas, memo builders
+│   ├── server/    // moved from @fractalshq/distribution-server
+│   ├── react/     // hooks + helpers (will absorb old distribution-client work)
+│   └── widgets/   // claim panels, buttons, etc.
+└── package.json   // exports map for subpaths
+```
+
+See `docs/distro-sdk.md` and `docs/distribution-sdk-auth-facts.md` for the full design notes / TODOs.

package/dist/api-CQqyHbnT.d.mts

@@ -0,0 +1,136 @@
+type DistributionStatus = "draft" | "committed" | "clawed_back" | "hidden";
+interface Distribution {
+    id: string;
+    orgId: string;
+    projectId: 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;
+    };
+}
+
+interface ListDistributionsRequest {
+    orgId?: string;
+    status?: DistributionStatus;
+    mint?: string;
+    limit?: number;
+    cursor?: string;
+}
+interface ListDistributionsResponse {
+    items: Distribution[];
+    nextCursor: string | null;
+}
+interface CreateDistributionRequest {
+    projectId: string;
+    mint: string;
+    title?: string;
+    version?: number;
+    recipients: Array<{
+        address: string;
+        shareBps: number;
+    }>;
+    amountUi: number;
+    rpcEndpoint?: string;
+}
+interface CreateDistributionResponse {
+    distributorId: string;
+    status: DistributionStatus;
+}
+interface CommitDistributionRequest {
+    fundVaultSignature?: string;
+    transaction?: string;
+    signature?: string;
+    exportJson?: unknown;
+    [key: string]: unknown;
+}
+interface CommitDistributionResponse {
+    distributorId: string;
+    rootHex: string;
+    vaultAta: string;
+    onchainTxSignature: string;
+    committedAt: 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;
+}
+
+export type { BuildClaimTransactionRequest as B, ClaimAllocation as C, DistributionStatus as D, HealthResponse as H, ListDistributionsRequest as L, Distribution as a, ClaimTransactionInstruction as b, ClaimTransactionRequest as c, ClaimTransactionResponse as d, ClaimCommitRequest as e, ClaimableDistribution as f, ListDistributionsResponse as g, CreateDistributionRequest as h, CreateDistributionResponse as i, CommitDistributionRequest as j, CommitDistributionResponse as k, BuildClaimTransactionResponse as l, CommitClaimRequest as m, CommitClaimResponse as n, ClaimableResponse as o, ClaimHistoryItem as p, ClaimHistoryResponse as q };

package/dist/api-CQqyHbnT.d.ts

@@ -0,0 +1,136 @@
+type DistributionStatus = "draft" | "committed" | "clawed_back" | "hidden";
+interface Distribution {
+    id: string;
+    orgId: string;
+    projectId: 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;
+    };
+}
+
+interface ListDistributionsRequest {
+    orgId?: string;
+    status?: DistributionStatus;
+    mint?: string;
+    limit?: number;
+    cursor?: string;
+}
+interface ListDistributionsResponse {
+    items: Distribution[];
+    nextCursor: string | null;
+}
+interface CreateDistributionRequest {
+    projectId: string;
+    mint: string;
+    title?: string;
+    version?: number;
+    recipients: Array<{
+        address: string;
+        shareBps: number;
+    }>;
+    amountUi: number;
+    rpcEndpoint?: string;
+}
+interface CreateDistributionResponse {
+    distributorId: string;
+    status: DistributionStatus;
+}
+interface CommitDistributionRequest {
+    fundVaultSignature?: string;
+    transaction?: string;
+    signature?: string;
+    exportJson?: unknown;
+    [key: string]: unknown;
+}
+interface CommitDistributionResponse {
+    distributorId: string;
+    rootHex: string;
+    vaultAta: string;
+    onchainTxSignature: string;
+    committedAt: 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;
+}
+
+export type { BuildClaimTransactionRequest as B, ClaimAllocation as C, DistributionStatus as D, HealthResponse as H, ListDistributionsRequest as L, Distribution as a, ClaimTransactionInstruction as b, ClaimTransactionRequest as c, ClaimTransactionResponse as d, ClaimCommitRequest as e, ClaimableDistribution as f, ListDistributionsResponse as g, CreateDistributionRequest as h, CreateDistributionResponse as i, CommitDistributionRequest as j, CommitDistributionResponse as k, BuildClaimTransactionResponse as l, CommitClaimRequest as m, CommitClaimResponse as n, ClaimableResponse as o, ClaimHistoryItem as p, ClaimHistoryResponse as q };

package/dist/chunk-I4E63NIC.mjs

@@ -0,0 +1,24 @@
+var __defProp = Object.defineProperty;
+var __defProps = Object.defineProperties;
+var __getOwnPropDescs = Object.getOwnPropertyDescriptors;
+var __getOwnPropSymbols = Object.getOwnPropertySymbols;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __propIsEnum = Object.prototype.propertyIsEnumerable;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __spreadValues = (a, b) => {
+  for (var prop in b || (b = {}))
+    if (__hasOwnProp.call(b, prop))
+      __defNormalProp(a, prop, b[prop]);
+  if (__getOwnPropSymbols)
+    for (var prop of __getOwnPropSymbols(b)) {
+      if (__propIsEnum.call(b, prop))
+        __defNormalProp(a, prop, b[prop]);
+    }
+  return a;
+};
+var __spreadProps = (a, b) => __defProps(a, __getOwnPropDescs(b));
+
+export {
+  __spreadValues,
+  __spreadProps
+};