@nexus-cross/pop 1.3.10-beta.2

package/dist/index.d.ts

@@ -0,0 +1,102 @@
+import { S as SafeDropChainPort, a as SafeDropApiPort, C as CryptoPort, D as DepositParams, b as DepositResult, B as BatchClaimParams, c as BatchClaimResult, d as ClaimSignerPort, W as WithdrawParams, e as WithdrawResult, R as RefundParams, f as RefundResult, A as Address, g as Secret } from './createSafeDrop-qoNG59jB.js';
+export { h as BatchClaimSignature, i as DropInbox, j as DropSender, k as DropState, E as Envelope, H as Hex, l as HistoryEntry, m as HistoryPage, I as Id, L as LeaderboardEntry, O as OAuthProof, P as PendingDrop, n as PopEventName, o as SafeDrop, p as SafeDropConfig, q as SafeDropDeps, r as SafeDropError, s as SafeDropErrorCode, t as SecretHash, u as SocialIdentifier, v as SocialProvider, X as XConnection, w as createSafeDrop } from './createSafeDrop-qoNG59jB.js';
+export { X as XAuthPort, a as XTokenResult } from './XAuthPort-BNJePosj.js';
+
+/**
+ * 예치: 임시 claim 지갑 생성 → secretHash 커밋 → (permit | approve) → deposit →
+ * 수령 링크 생성. chain 어댑터가 depositWithPermit을 구현하면 approve tx를 생략한다.
+ * secret은 링크 fragment에만 담기고 어떤 포트로도 전송되지 않는다.
+ * (expiry/salt는 컨트랙트가 결정.)
+ */
+declare class DepositUseCase {
+    private readonly chain;
+    private readonly api;
+    private readonly crypto;
+    /** 수령 링크 base URL. */
+    private readonly claimBaseUrl;
+    constructor(chain: SafeDropChainPort, api: SafeDropApiPort, crypto: CryptoPort, 
+    /** 수령 링크 base URL. */
+    claimBaseUrl: string);
+    execute(params: DepositParams): Promise<DepositResult>;
+    /** permit 미지원 배포본: ERC20 approve tx → deposit tx. */
+    private approveThenDeposit;
+}
+
+/**
+ * 일괄 수령: 한 id에 쌓인 드롭 전부를 validator 서명 1건으로 회수한다.
+ * 개별 수령과 달리 secret이 필요 없다 — 게이트는 validator 서명이다.
+ *
+ * 흐름 (온체인 계약이 정한 순서 그대로):
+ *   1. nonce  = validatorNonceById(keccak256(utf8(id)))   ← id를 **해시**로 키잉
+ *   2. 백엔드에 (id, nonce, deadline) + X 토큰으로 서명 요청
+ *      → recipient는 **응답값**을 쓴다(SIWE 주소에 바인딩되어 서명됨)
+ *   3. digest = validatorClaimDigest(recipient, id, nonce, deadline)  ← 온체인 값
+ *      recover(digest, signature) == validator() 인지 **가스 전에** 검증
+ *   4. liveDropCountById(id)이 0이 될 때까지 withdrawByValidator(..., maxCount, sig)
+ *      반복. maxCount는 서명 대상이 아니라 페이지 크기 → **서명 재사용**.
+ *
+ * 3번이 이 usecase의 존재 이유다: 백엔드가 다른 domain/type/nonce/recipient로
+ * 서명하면 온체인에서는 `ECDSAInvalidSignature`로만 드러나 원인을 못 찾는다.
+ */
+declare class BatchClaimUseCase {
+    private readonly chain;
+    private readonly api;
+    private readonly crypto;
+    /** 테스트 주입용 시계. 기본 Date.now(). */
+    private readonly now;
+    constructor(chain: SafeDropChainPort, api: SafeDropApiPort, crypto: CryptoPort, 
+    /** 테스트 주입용 시계. 기본 Date.now(). */
+    now?: () => number);
+    execute(params: BatchClaimParams): Promise<BatchClaimResult>;
+    /**
+     * 일괄 수령의 목적지가 **개별 수령으로 이미 확정된 주소**인지 온체인에서 확인한다.
+     * `claimedRecipientOf(id)`가 zero면 이 id는 아직 개별 수령을 하지 않은 상태 —
+     * API의 `has_claimed_before` 게이트와 같은 조건이다(첫 수령은 개별로).
+     * 어댑터가 이 read를 지원하지 않으면 검사를 생략한다(플로우는 유지).
+     */
+    private assertRecipientPinnedOnChain;
+    /**
+     * 사전 검증. `recoverAddress`가 없는 CryptoPort면 조용히 건너뛴다 — 최종 관문은
+     * 어차피 컨트랙트이고, 이 검사는 "가스 쓰기 전에 원인을 알려주는" 용도다.
+     */
+    private assertSignedByValidator;
+    private liveCount;
+}
+
+/**
+ * 수령: drops(claimAddr)에서 id·salt 조회 → claimDigest 읽기 → 임시 키로 digest
+ * raw 서명 → withdraw tx(임시 지갑이 직접 전송, 가스 대납). id/salt는 온체인
+ * 드롭 값을 그대로 써서 IdMismatch/SaltMismatch를 원천 차단한다.
+ */
+declare class WithdrawUseCase {
+    private readonly chain;
+    private readonly signer;
+    constructor(chain: SafeDropChainPort, signer: ClaimSignerPort);
+    execute(params: WithdrawParams): Promise<WithdrawResult>;
+}
+
+/** 환불: 만료 후 sponsor(msg.sender)만 호출 가능. 만료/권한 검증은 컨트랙트가 최종 강제. */
+declare class RefundUseCase {
+    private readonly chain;
+    constructor(chain: SafeDropChainPort);
+    execute(params: RefundParams): Promise<RefundResult>;
+}
+
+declare function buildWithdrawLink(params: {
+    /** claim 페이지 base URL. 예: https://one-pop.example/claim */
+    baseUrl: string;
+    sender: Address;
+    secret: Secret;
+}): string;
+declare function parseWithdrawLink(href: string): {
+    sender: Address | null;
+    secret: Secret | null;
+};
+/** X DM 안내 문구. */
+declare function buildDmText(claimUrl: string): string;
+/** X DM 작성창 URL. recipientId가 있으면 대상 지정, 없으면 수신자 선택 화면. */
+declare function buildComposeUrl(text: string, recipientId?: string): string;
+
+declare function normalizeHandle(handle: string): string;
+
+export { Address, BatchClaimParams, BatchClaimResult, BatchClaimUseCase, ClaimSignerPort, CryptoPort, DepositParams, DepositResult, DepositUseCase, RefundParams, RefundResult, RefundUseCase, SafeDropApiPort, SafeDropChainPort, Secret, WithdrawParams, WithdrawResult, WithdrawUseCase, buildComposeUrl, buildDmText, buildWithdrawLink, normalizeHandle, parseWithdrawLink };

package/dist/index.js

@@ -0,0 +1 @@
+import{a as r,b as e,c as o,d as t,e as p,f as a,g as s,h as i,i as f,j as m,k as n}from"./chunk-KEW4FB4S.js";export{i as BatchClaimUseCase,s as DepositUseCase,m as RefundUseCase,r as SafeDropError,f as WithdrawUseCase,a as buildComposeUrl,p as buildDmText,o as buildWithdrawLink,n as createSafeDrop,e as normalizeHandle,t as parseWithdrawLink};

package/dist/react/index.d.ts

@@ -0,0 +1,12 @@
+import * as react from 'react';
+import { ReactNode } from 'react';
+import { o as SafeDrop } from '../createSafeDrop-qoNG59jB.js';
+
+interface SafeDropProviderProps {
+    client: SafeDrop;
+    children?: ReactNode;
+}
+declare function SafeDropProvider({ client, children }: SafeDropProviderProps): react.FunctionComponentElement<react.ProviderProps<SafeDrop | null>>;
+declare function useSafeDrop(): SafeDrop;
+
+export { SafeDropProvider, type SafeDropProviderProps, useSafeDrop };

package/dist/react/index.js

@@ -0,0 +1 @@
+import{createContext as t,createElement as p,useContext as a}from"react";var r=t(null);function f({client:e,children:o}){return p(r.Provider,{value:e},o)}function i(){let e=a(r);if(!e)throw new Error("useSafeDrop must be used within <SafeDropProvider>");return e}export{f as SafeDropProvider,i as useSafeDrop};

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@nexus-cross/pop",
+  "version": "1.3.10-beta.2",
+  "description": "pop — framework-agnostic core + React adapter.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js"
+    },
+    "./adapters": {
+      "types": "./dist/adapters/index.d.ts",
+      "import": "./dist/adapters/index.js"
+    },
+    "./AGENTS.md": "./AGENTS.md",
+    "./openapi.json": "./src/infrastructure/openapi.json"
+  },
+  "files": [
+    "dist",
+    "AGENTS.md",
+    "src/infrastructure/openapi.json"
+  ],
+  "sideEffects": false,
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org",
+    "access": "public"
+  },
+  "peerDependencies": {
+    "react": "^18.0.0 || ^19.0.0",
+    "viem": "^2.0.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": true
+    },
+    "viem": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/react": "^19.0.0",
+    "react": "^19.0.0",
+    "tsup": "^8.4.0",
+    "typescript": "^5.7.0",
+    "viem": "^2.21.0"
+  },
+  "license": "MIT",
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "vitest run",
+    "typecheck": "tsc --noEmit"
+  }
+}