@liberfi.io/react-redpacket 0.1.1

package/README.md

@@ -0,0 +1,12 @@
+# @liberfi.io/react-redpacket
+
+Redpacket domain runtime and React bindings.
+
+This package is wallet-agnostic. ChainStream, Pinata, Privy, Next, and
+browser routes stay in the application Adapter.
+
+## Installation
+
+```bash
+pnpm add @liberfi.io/react-redpacket
+```

package/dist/index.d.mts

@@ -0,0 +1,107 @@
+import * as react from 'react';
+import { PropsWithChildren } from 'react';
+import { Chain } from '@liberfi.io/types';
+
+declare const redPacketQueryKeys: {
+    packet: (idOrShareId: string) => readonly ["redPacket", string];
+    walletClaims: (address: string, cursor?: string) => readonly ["walletClaims", string, string];
+    packetClaims: (redPacketId: string, cursor?: string) => readonly ["redPacketClaims", string, string];
+    walletPackets: (address: string, cursor?: string) => readonly ["walletRedPackets", string, string];
+};
+
+interface CreateFixedAmountRedPacketIntent {
+    chain: Chain;
+    creator: string;
+    mint: string;
+    maxClaims: number;
+    fixedAmount: string;
+    memo?: string;
+    password?: string;
+}
+interface CreateRandomAmountRedPacketIntent {
+    chain: Chain;
+    creator: string;
+    mint: string;
+    maxClaims: number;
+    totalAmount: string;
+    memo?: string;
+    password?: string;
+}
+interface ClaimRedPacketIntent {
+    chain: Chain;
+    shareId: string;
+    claimer: string;
+    password?: string;
+}
+type RedpacketPacketStatus = "ongoing" | "finished" | "expired";
+interface RedpacketRecord {
+    id: string;
+    shareId: string;
+    status: RedpacketPacketStatus;
+    totalAmount: string;
+    claimedAmount?: string;
+    claimedCount?: number;
+    maxClaims: number;
+    memo?: string;
+    mint?: string;
+    creator?: string;
+    expiredAt?: number;
+}
+declare function redpacketRecordStatus(record: Pick<RedpacketRecord, "claimedAmount" | "totalAmount" | "claimedCount" | "maxClaims" | "expiredAt">): RedpacketPacketStatus;
+type RedpacketIntentStatus = "idle" | "validating" | "signing" | "submitting" | "succeeded" | "failed" | "rejected" | "already-claimed";
+
+type RedpacketCommand = {
+    kind: "create-fixed";
+    intent: CreateFixedAmountRedPacketIntent;
+} | {
+    kind: "create-random";
+    intent: CreateRandomAmountRedPacketIntent;
+} | {
+    kind: "claim";
+    intent: ClaimRedPacketIntent;
+};
+interface RedpacketSnapshot {
+    status: RedpacketIntentStatus;
+    command?: RedpacketCommand;
+    packetId?: string;
+    error?: Error;
+}
+interface RedpacketSignerPort {
+    sign(command: RedpacketCommand): Promise<string>;
+}
+interface RedpacketExecutionPort {
+    submit(signed: string, command: RedpacketCommand): Promise<{
+        packetId: string;
+        alreadyClaimed?: boolean;
+    }>;
+}
+declare function validateRedpacketCommand(command: RedpacketCommand): void;
+declare function createRedpacketRuntime(options: {
+    signer?: RedpacketSignerPort;
+    execution: RedpacketExecutionPort;
+    onChange?: (snapshot: RedpacketSnapshot) => void;
+}): {
+    snapshot(): RedpacketSnapshot;
+    submit(command: RedpacketCommand): Promise<RedpacketSnapshot>;
+};
+declare function createInMemoryRedpacketPorts(options?: {
+    signError?: Error;
+    alreadyClaimed?: boolean;
+    timeout?: boolean;
+}): {
+    signer: {
+        sign(): Promise<string>;
+    };
+    execution: {
+        submit(signed: string, command: RedpacketCommand): Promise<{
+            packetId: string;
+            alreadyClaimed: boolean | undefined;
+        }>;
+    };
+};
+
+declare const PACKAGE_NAME: "@liberfi.io/react-redpacket";
+declare function RedpacketProvider({ children }: PropsWithChildren): react.FunctionComponentElement<react.ProviderProps<boolean>>;
+declare function useRedpacketReady(): boolean;
+
+export { type ClaimRedPacketIntent, type CreateFixedAmountRedPacketIntent, type CreateRandomAmountRedPacketIntent, PACKAGE_NAME, type RedpacketCommand, type RedpacketExecutionPort, type RedpacketIntentStatus, type RedpacketPacketStatus, RedpacketProvider, type RedpacketRecord, type RedpacketSignerPort, type RedpacketSnapshot, createInMemoryRedpacketPorts, createRedpacketRuntime, redPacketQueryKeys, redpacketRecordStatus, useRedpacketReady, validateRedpacketCommand };

package/dist/index.d.ts

@@ -0,0 +1,107 @@
+import * as react from 'react';
+import { PropsWithChildren } from 'react';
+import { Chain } from '@liberfi.io/types';
+
+declare const redPacketQueryKeys: {
+    packet: (idOrShareId: string) => readonly ["redPacket", string];
+    walletClaims: (address: string, cursor?: string) => readonly ["walletClaims", string, string];
+    packetClaims: (redPacketId: string, cursor?: string) => readonly ["redPacketClaims", string, string];
+    walletPackets: (address: string, cursor?: string) => readonly ["walletRedPackets", string, string];
+};
+
+interface CreateFixedAmountRedPacketIntent {
+    chain: Chain;
+    creator: string;
+    mint: string;
+    maxClaims: number;
+    fixedAmount: string;
+    memo?: string;
+    password?: string;
+}
+interface CreateRandomAmountRedPacketIntent {
+    chain: Chain;
+    creator: string;
+    mint: string;
+    maxClaims: number;
+    totalAmount: string;
+    memo?: string;
+    password?: string;
+}
+interface ClaimRedPacketIntent {
+    chain: Chain;
+    shareId: string;
+    claimer: string;
+    password?: string;
+}
+type RedpacketPacketStatus = "ongoing" | "finished" | "expired";
+interface RedpacketRecord {
+    id: string;
+    shareId: string;
+    status: RedpacketPacketStatus;
+    totalAmount: string;
+    claimedAmount?: string;
+    claimedCount?: number;
+    maxClaims: number;
+    memo?: string;
+    mint?: string;
+    creator?: string;
+    expiredAt?: number;
+}
+declare function redpacketRecordStatus(record: Pick<RedpacketRecord, "claimedAmount" | "totalAmount" | "claimedCount" | "maxClaims" | "expiredAt">): RedpacketPacketStatus;
+type RedpacketIntentStatus = "idle" | "validating" | "signing" | "submitting" | "succeeded" | "failed" | "rejected" | "already-claimed";
+
+type RedpacketCommand = {
+    kind: "create-fixed";
+    intent: CreateFixedAmountRedPacketIntent;
+} | {
+    kind: "create-random";
+    intent: CreateRandomAmountRedPacketIntent;
+} | {
+    kind: "claim";
+    intent: ClaimRedPacketIntent;
+};
+interface RedpacketSnapshot {
+    status: RedpacketIntentStatus;
+    command?: RedpacketCommand;
+    packetId?: string;
+    error?: Error;
+}
+interface RedpacketSignerPort {
+    sign(command: RedpacketCommand): Promise<string>;
+}
+interface RedpacketExecutionPort {
+    submit(signed: string, command: RedpacketCommand): Promise<{
+        packetId: string;
+        alreadyClaimed?: boolean;
+    }>;
+}
+declare function validateRedpacketCommand(command: RedpacketCommand): void;
+declare function createRedpacketRuntime(options: {
+    signer?: RedpacketSignerPort;
+    execution: RedpacketExecutionPort;
+    onChange?: (snapshot: RedpacketSnapshot) => void;
+}): {
+    snapshot(): RedpacketSnapshot;
+    submit(command: RedpacketCommand): Promise<RedpacketSnapshot>;
+};
+declare function createInMemoryRedpacketPorts(options?: {
+    signError?: Error;
+    alreadyClaimed?: boolean;
+    timeout?: boolean;
+}): {
+    signer: {
+        sign(): Promise<string>;
+    };
+    execution: {
+        submit(signed: string, command: RedpacketCommand): Promise<{
+            packetId: string;
+            alreadyClaimed: boolean | undefined;
+        }>;
+    };
+};
+
+declare const PACKAGE_NAME: "@liberfi.io/react-redpacket";
+declare function RedpacketProvider({ children }: PropsWithChildren): react.FunctionComponentElement<react.ProviderProps<boolean>>;
+declare function useRedpacketReady(): boolean;
+
+export { type ClaimRedPacketIntent, type CreateFixedAmountRedPacketIntent, type CreateRandomAmountRedPacketIntent, PACKAGE_NAME, type RedpacketCommand, type RedpacketExecutionPort, type RedpacketIntentStatus, type RedpacketPacketStatus, RedpacketProvider, type RedpacketRecord, type RedpacketSignerPort, type RedpacketSnapshot, createInMemoryRedpacketPorts, createRedpacketRuntime, redPacketQueryKeys, redpacketRecordStatus, useRedpacketReady, validateRedpacketCommand };

package/dist/index.js

@@ -0,0 +1,147 @@
+'use strict';
+
+var react = require('react');
+
+// src/index.ts
+
+// src/query-keys.ts
+var redPacketQueryKeys = {
+  packet: (idOrShareId) => ["redPacket", idOrShareId],
+  walletClaims: (address, cursor = "") => ["walletClaims", address, cursor],
+  packetClaims: (redPacketId, cursor = "") => ["redPacketClaims", redPacketId, cursor],
+  walletPackets: (address, cursor = "") => ["walletRedPackets", address, cursor]
+};
+
+// src/types.ts
+function redpacketRecordStatus(record) {
+  if (Number(record.claimedAmount ?? 0) >= Number(record.totalAmount) || (record.claimedCount ?? 0) >= record.maxClaims) {
+    return "finished";
+  }
+  if ((record.expiredAt ?? Number.POSITIVE_INFINITY) > Date.now()) {
+    return "ongoing";
+  }
+  return "expired";
+}
+
+// src/redpacket-runtime.ts
+function validateRedpacketCommand(command) {
+  if (command.kind === "create-fixed") {
+    const n = Number(command.intent.fixedAmount);
+    if (!Number.isFinite(n) || n <= 0) throw new Error("invalid amount");
+    if (command.intent.maxClaims < 1) throw new Error("invalid claim count");
+  }
+  if (command.kind === "create-random") {
+    const n = Number(command.intent.totalAmount);
+    if (!Number.isFinite(n) || n <= 0) throw new Error("invalid amount");
+    if (command.intent.maxClaims < 1) throw new Error("invalid claim count");
+  }
+  if (command.kind === "claim" && !command.intent.shareId) {
+    throw new Error("missing packet");
+  }
+}
+function createRedpacketRuntime(options) {
+  let current = { status: "idle" };
+  const claimed = /* @__PURE__ */ new Set();
+  const set = (next) => {
+    current = next;
+    options.onChange?.(next);
+    return next;
+  };
+  return {
+    snapshot() {
+      return current;
+    },
+    async submit(command) {
+      if (command.kind === "claim" && claimed.has(command.intent.shareId)) {
+        return set({
+          status: "already-claimed",
+          command,
+          error: new Error("already claimed")
+        });
+      }
+      set({ status: "validating", command });
+      try {
+        validateRedpacketCommand(command);
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return set({ status: "failed", command, error: err });
+      }
+      if (!options.signer) {
+        return set({
+          status: "rejected",
+          command,
+          error: new Error("missing signer")
+        });
+      }
+      set({ status: "signing", command });
+      let signed;
+      try {
+        signed = await options.signer.sign(command);
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return set({ status: "rejected", command, error: err });
+      }
+      set({ status: "submitting", command });
+      try {
+        const result = await options.execution.submit(signed, command);
+        if (result.alreadyClaimed) {
+          claimed.add(command.kind === "claim" ? command.intent.shareId : result.packetId);
+          return set({
+            status: "already-claimed",
+            command,
+            packetId: result.packetId
+          });
+        }
+        if (command.kind === "claim") claimed.add(command.intent.shareId);
+        return set({
+          status: "succeeded",
+          command,
+          packetId: result.packetId
+        });
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return set({ status: "failed", command, error: err });
+      }
+    }
+  };
+}
+function createInMemoryRedpacketPorts(options = {}) {
+  return {
+    signer: {
+      async sign() {
+        if (options.signError) throw options.signError;
+        return "signed";
+      }
+    },
+    execution: {
+      async submit(signed, command) {
+        if (options.timeout) throw new Error("submit timeout");
+        return {
+          packetId: command.kind === "claim" ? command.intent.shareId : "packet-memory",
+          alreadyClaimed: options.alreadyClaimed
+        };
+      }
+    }
+  };
+}
+
+// src/index.ts
+var PACKAGE_NAME = "@liberfi.io/react-redpacket";
+var ReadyContext = react.createContext(true);
+function RedpacketProvider({ children }) {
+  return react.createElement(ReadyContext.Provider, { value: true }, children);
+}
+function useRedpacketReady() {
+  return react.useContext(ReadyContext);
+}
+
+exports.PACKAGE_NAME = PACKAGE_NAME;
+exports.RedpacketProvider = RedpacketProvider;
+exports.createInMemoryRedpacketPorts = createInMemoryRedpacketPorts;
+exports.createRedpacketRuntime = createRedpacketRuntime;
+exports.redPacketQueryKeys = redPacketQueryKeys;
+exports.redpacketRecordStatus = redpacketRecordStatus;
+exports.useRedpacketReady = useRedpacketReady;
+exports.validateRedpacketCommand = validateRedpacketCommand;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query-keys.ts","../src/types.ts","../src/redpacket-runtime.ts","../src/index.ts"],"names":["createContext","createElement","useContext"],"mappings":"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","file":"index.js","sourcesContent":["export const redPacketQueryKeys = {\n  packet: (idOrShareId: string) => [\"redPacket\", idOrShareId] as const,\n  walletClaims: (address: string, cursor = \"\") =>\n    [\"walletClaims\", address, cursor] as const,\n  packetClaims: (redPacketId: string, cursor = \"\") =>\n    [\"redPacketClaims\", redPacketId, cursor] as const,\n  walletPackets: (address: string, cursor = \"\") =>\n    [\"walletRedPackets\", address, cursor] as const,\n};\n","import type { Chain } from \"@liberfi.io/types\";\n\nexport interface CreateFixedAmountRedPacketIntent {\n  chain: Chain;\n  creator: string;\n  mint: string;\n  maxClaims: number;\n  fixedAmount: string;\n  memo?: string;\n  password?: string;\n}\n\nexport interface CreateRandomAmountRedPacketIntent {\n  chain: Chain;\n  creator: string;\n  mint: string;\n  maxClaims: number;\n  totalAmount: string;\n  memo?: string;\n  password?: string;\n}\n\nexport interface ClaimRedPacketIntent {\n  chain: Chain;\n  shareId: string;\n  claimer: string;\n  password?: string;\n}\n\nexport type RedpacketPacketStatus = \"ongoing\" | \"finished\" | \"expired\";\n\nexport interface RedpacketRecord {\n  id: string;\n  shareId: string;\n  status: RedpacketPacketStatus;\n  totalAmount: string;\n  claimedAmount?: string;\n  claimedCount?: number;\n  maxClaims: number;\n  memo?: string;\n  mint?: string;\n  creator?: string;\n  expiredAt?: number;\n}\n\nexport function redpacketRecordStatus(\n  record: Pick<\n    RedpacketRecord,\n    \"claimedAmount\" | \"totalAmount\" | \"claimedCount\" | \"maxClaims\" | \"expiredAt\"\n  >,\n): RedpacketPacketStatus {\n  if (\n    Number(record.claimedAmount ?? 0) >= Number(record.totalAmount) ||\n    (record.claimedCount ?? 0) >= record.maxClaims\n  ) {\n    return \"finished\";\n  }\n  if ((record.expiredAt ?? Number.POSITIVE_INFINITY) > Date.now()) {\n    return \"ongoing\";\n  }\n  return \"expired\";\n}\n\nexport type RedpacketIntentStatus =\n  | \"idle\"\n  | \"validating\"\n  | \"signing\"\n  | \"submitting\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"rejected\"\n  | \"already-claimed\";\n","import type {\n  ClaimRedPacketIntent,\n  CreateFixedAmountRedPacketIntent,\n  CreateRandomAmountRedPacketIntent,\n  RedpacketIntentStatus,\n} from \"./types\";\n\nexport type RedpacketCommand =\n  | { kind: \"create-fixed\"; intent: CreateFixedAmountRedPacketIntent }\n  | { kind: \"create-random\"; intent: CreateRandomAmountRedPacketIntent }\n  | { kind: \"claim\"; intent: ClaimRedPacketIntent };\n\nexport interface RedpacketSnapshot {\n  status: RedpacketIntentStatus;\n  command?: RedpacketCommand;\n  packetId?: string;\n  error?: Error;\n}\n\nexport interface RedpacketSignerPort {\n  sign(command: RedpacketCommand): Promise<string>;\n}\n\nexport interface RedpacketExecutionPort {\n  submit(\n    signed: string,\n    command: RedpacketCommand,\n  ): Promise<{ packetId: string; alreadyClaimed?: boolean }>;\n}\n\nexport function validateRedpacketCommand(command: RedpacketCommand): void {\n  if (command.kind === \"create-fixed\") {\n    const n = Number(command.intent.fixedAmount);\n    if (!Number.isFinite(n) || n <= 0) throw new Error(\"invalid amount\");\n    if (command.intent.maxClaims < 1) throw new Error(\"invalid claim count\");\n  }\n  if (command.kind === \"create-random\") {\n    const n = Number(command.intent.totalAmount);\n    if (!Number.isFinite(n) || n <= 0) throw new Error(\"invalid amount\");\n    if (command.intent.maxClaims < 1) throw new Error(\"invalid claim count\");\n  }\n  if (command.kind === \"claim\" && !command.intent.shareId) {\n    throw new Error(\"missing packet\");\n  }\n}\n\nexport function createRedpacketRuntime(options: {\n  signer?: RedpacketSignerPort;\n  execution: RedpacketExecutionPort;\n  onChange?: (snapshot: RedpacketSnapshot) => void;\n}) {\n  let current: RedpacketSnapshot = { status: \"idle\" };\n  const claimed = new Set<string>();\n  const set = (next: RedpacketSnapshot) => {\n    current = next;\n    options.onChange?.(next);\n    return next;\n  };\n\n  return {\n    snapshot() {\n      return current;\n    },\n    async submit(command: RedpacketCommand) {\n      if (command.kind === \"claim\" && claimed.has(command.intent.shareId)) {\n        return set({\n          status: \"already-claimed\",\n          command,\n          error: new Error(\"already claimed\"),\n        });\n      }\n      set({ status: \"validating\", command });\n      try {\n        validateRedpacketCommand(command);\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        return set({ status: \"failed\", command, error: err });\n      }\n      if (!options.signer) {\n        return set({\n          status: \"rejected\",\n          command,\n          error: new Error(\"missing signer\"),\n        });\n      }\n      set({ status: \"signing\", command });\n      let signed: string;\n      try {\n        signed = await options.signer.sign(command);\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        return set({ status: \"rejected\", command, error: err });\n      }\n      set({ status: \"submitting\", command });\n      try {\n        const result = await options.execution.submit(signed, command);\n        if (result.alreadyClaimed) {\n          claimed.add(command.kind === \"claim\" ? command.intent.shareId : result.packetId);\n          return set({\n            status: \"already-claimed\",\n            command,\n            packetId: result.packetId,\n          });\n        }\n        if (command.kind === \"claim\") claimed.add(command.intent.shareId);\n        return set({\n          status: \"succeeded\",\n          command,\n          packetId: result.packetId,\n        });\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        return set({ status: \"failed\", command, error: err });\n      }\n    },\n  };\n}\n\nexport function createInMemoryRedpacketPorts(options: {\n  signError?: Error;\n  alreadyClaimed?: boolean;\n  timeout?: boolean;\n} = {}) {\n  return {\n    signer: {\n      async sign() {\n        if (options.signError) throw options.signError;\n        return \"signed\";\n      },\n    },\n    execution: {\n      async submit(signed: string, command: RedpacketCommand) {\n        void signed;\n        if (options.timeout) throw new Error(\"submit timeout\");\n        return {\n          packetId:\n            command.kind === \"claim\" ? command.intent.shareId : \"packet-memory\",\n          alreadyClaimed: options.alreadyClaimed,\n        };\n      },\n    },\n  };\n}\n","import {\n  createContext,\n  createElement,\n  useContext,\n  type PropsWithChildren,\n} from \"react\";\n\nexport const PACKAGE_NAME = \"@liberfi.io/react-redpacket\" as const;\n\nconst ReadyContext = createContext(true);\n\nexport function RedpacketProvider({ children }: PropsWithChildren) {\n  return createElement(ReadyContext.Provider, { value: true }, children);\n}\n\nexport function useRedpacketReady(): boolean {\n  return useContext(ReadyContext);\n}\n\nexport { redPacketQueryKeys } from \"./query-keys\";\nexport type {\n  ClaimRedPacketIntent,\n  CreateFixedAmountRedPacketIntent,\n  CreateRandomAmountRedPacketIntent,\n  RedpacketIntentStatus,\n  RedpacketPacketStatus,\n  RedpacketRecord,\n} from \"./types\";\nexport { redpacketRecordStatus } from \"./types\";\nexport {\n  createInMemoryRedpacketPorts,\n  createRedpacketRuntime,\n  validateRedpacketCommand,\n} from \"./redpacket-runtime\";\nexport type {\n  RedpacketCommand,\n  RedpacketExecutionPort,\n  RedpacketSignerPort,\n  RedpacketSnapshot,\n} from \"./redpacket-runtime\";\n"]}

package/dist/index.mjs

@@ -0,0 +1,138 @@
+import { createContext, createElement, useContext } from 'react';
+
+// src/index.ts
+
+// src/query-keys.ts
+var redPacketQueryKeys = {
+  packet: (idOrShareId) => ["redPacket", idOrShareId],
+  walletClaims: (address, cursor = "") => ["walletClaims", address, cursor],
+  packetClaims: (redPacketId, cursor = "") => ["redPacketClaims", redPacketId, cursor],
+  walletPackets: (address, cursor = "") => ["walletRedPackets", address, cursor]
+};
+
+// src/types.ts
+function redpacketRecordStatus(record) {
+  if (Number(record.claimedAmount ?? 0) >= Number(record.totalAmount) || (record.claimedCount ?? 0) >= record.maxClaims) {
+    return "finished";
+  }
+  if ((record.expiredAt ?? Number.POSITIVE_INFINITY) > Date.now()) {
+    return "ongoing";
+  }
+  return "expired";
+}
+
+// src/redpacket-runtime.ts
+function validateRedpacketCommand(command) {
+  if (command.kind === "create-fixed") {
+    const n = Number(command.intent.fixedAmount);
+    if (!Number.isFinite(n) || n <= 0) throw new Error("invalid amount");
+    if (command.intent.maxClaims < 1) throw new Error("invalid claim count");
+  }
+  if (command.kind === "create-random") {
+    const n = Number(command.intent.totalAmount);
+    if (!Number.isFinite(n) || n <= 0) throw new Error("invalid amount");
+    if (command.intent.maxClaims < 1) throw new Error("invalid claim count");
+  }
+  if (command.kind === "claim" && !command.intent.shareId) {
+    throw new Error("missing packet");
+  }
+}
+function createRedpacketRuntime(options) {
+  let current = { status: "idle" };
+  const claimed = /* @__PURE__ */ new Set();
+  const set = (next) => {
+    current = next;
+    options.onChange?.(next);
+    return next;
+  };
+  return {
+    snapshot() {
+      return current;
+    },
+    async submit(command) {
+      if (command.kind === "claim" && claimed.has(command.intent.shareId)) {
+        return set({
+          status: "already-claimed",
+          command,
+          error: new Error("already claimed")
+        });
+      }
+      set({ status: "validating", command });
+      try {
+        validateRedpacketCommand(command);
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return set({ status: "failed", command, error: err });
+      }
+      if (!options.signer) {
+        return set({
+          status: "rejected",
+          command,
+          error: new Error("missing signer")
+        });
+      }
+      set({ status: "signing", command });
+      let signed;
+      try {
+        signed = await options.signer.sign(command);
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return set({ status: "rejected", command, error: err });
+      }
+      set({ status: "submitting", command });
+      try {
+        const result = await options.execution.submit(signed, command);
+        if (result.alreadyClaimed) {
+          claimed.add(command.kind === "claim" ? command.intent.shareId : result.packetId);
+          return set({
+            status: "already-claimed",
+            command,
+            packetId: result.packetId
+          });
+        }
+        if (command.kind === "claim") claimed.add(command.intent.shareId);
+        return set({
+          status: "succeeded",
+          command,
+          packetId: result.packetId
+        });
+      } catch (error) {
+        const err = error instanceof Error ? error : new Error(String(error));
+        return set({ status: "failed", command, error: err });
+      }
+    }
+  };
+}
+function createInMemoryRedpacketPorts(options = {}) {
+  return {
+    signer: {
+      async sign() {
+        if (options.signError) throw options.signError;
+        return "signed";
+      }
+    },
+    execution: {
+      async submit(signed, command) {
+        if (options.timeout) throw new Error("submit timeout");
+        return {
+          packetId: command.kind === "claim" ? command.intent.shareId : "packet-memory",
+          alreadyClaimed: options.alreadyClaimed
+        };
+      }
+    }
+  };
+}
+
+// src/index.ts
+var PACKAGE_NAME = "@liberfi.io/react-redpacket";
+var ReadyContext = createContext(true);
+function RedpacketProvider({ children }) {
+  return createElement(ReadyContext.Provider, { value: true }, children);
+}
+function useRedpacketReady() {
+  return useContext(ReadyContext);
+}
+
+export { PACKAGE_NAME, RedpacketProvider, createInMemoryRedpacketPorts, createRedpacketRuntime, redPacketQueryKeys, redpacketRecordStatus, useRedpacketReady, validateRedpacketCommand };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/query-keys.ts","../src/types.ts","../src/redpacket-runtime.ts","../src/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["export const redPacketQueryKeys = {\n  packet: (idOrShareId: string) => [\"redPacket\", idOrShareId] as const,\n  walletClaims: (address: string, cursor = \"\") =>\n    [\"walletClaims\", address, cursor] as const,\n  packetClaims: (redPacketId: string, cursor = \"\") =>\n    [\"redPacketClaims\", redPacketId, cursor] as const,\n  walletPackets: (address: string, cursor = \"\") =>\n    [\"walletRedPackets\", address, cursor] as const,\n};\n","import type { Chain } from \"@liberfi.io/types\";\n\nexport interface CreateFixedAmountRedPacketIntent {\n  chain: Chain;\n  creator: string;\n  mint: string;\n  maxClaims: number;\n  fixedAmount: string;\n  memo?: string;\n  password?: string;\n}\n\nexport interface CreateRandomAmountRedPacketIntent {\n  chain: Chain;\n  creator: string;\n  mint: string;\n  maxClaims: number;\n  totalAmount: string;\n  memo?: string;\n  password?: string;\n}\n\nexport interface ClaimRedPacketIntent {\n  chain: Chain;\n  shareId: string;\n  claimer: string;\n  password?: string;\n}\n\nexport type RedpacketPacketStatus = \"ongoing\" | \"finished\" | \"expired\";\n\nexport interface RedpacketRecord {\n  id: string;\n  shareId: string;\n  status: RedpacketPacketStatus;\n  totalAmount: string;\n  claimedAmount?: string;\n  claimedCount?: number;\n  maxClaims: number;\n  memo?: string;\n  mint?: string;\n  creator?: string;\n  expiredAt?: number;\n}\n\nexport function redpacketRecordStatus(\n  record: Pick<\n    RedpacketRecord,\n    \"claimedAmount\" | \"totalAmount\" | \"claimedCount\" | \"maxClaims\" | \"expiredAt\"\n  >,\n): RedpacketPacketStatus {\n  if (\n    Number(record.claimedAmount ?? 0) >= Number(record.totalAmount) ||\n    (record.claimedCount ?? 0) >= record.maxClaims\n  ) {\n    return \"finished\";\n  }\n  if ((record.expiredAt ?? Number.POSITIVE_INFINITY) > Date.now()) {\n    return \"ongoing\";\n  }\n  return \"expired\";\n}\n\nexport type RedpacketIntentStatus =\n  | \"idle\"\n  | \"validating\"\n  | \"signing\"\n  | \"submitting\"\n  | \"succeeded\"\n  | \"failed\"\n  | \"rejected\"\n  | \"already-claimed\";\n","import type {\n  ClaimRedPacketIntent,\n  CreateFixedAmountRedPacketIntent,\n  CreateRandomAmountRedPacketIntent,\n  RedpacketIntentStatus,\n} from \"./types\";\n\nexport type RedpacketCommand =\n  | { kind: \"create-fixed\"; intent: CreateFixedAmountRedPacketIntent }\n  | { kind: \"create-random\"; intent: CreateRandomAmountRedPacketIntent }\n  | { kind: \"claim\"; intent: ClaimRedPacketIntent };\n\nexport interface RedpacketSnapshot {\n  status: RedpacketIntentStatus;\n  command?: RedpacketCommand;\n  packetId?: string;\n  error?: Error;\n}\n\nexport interface RedpacketSignerPort {\n  sign(command: RedpacketCommand): Promise<string>;\n}\n\nexport interface RedpacketExecutionPort {\n  submit(\n    signed: string,\n    command: RedpacketCommand,\n  ): Promise<{ packetId: string; alreadyClaimed?: boolean }>;\n}\n\nexport function validateRedpacketCommand(command: RedpacketCommand): void {\n  if (command.kind === \"create-fixed\") {\n    const n = Number(command.intent.fixedAmount);\n    if (!Number.isFinite(n) || n <= 0) throw new Error(\"invalid amount\");\n    if (command.intent.maxClaims < 1) throw new Error(\"invalid claim count\");\n  }\n  if (command.kind === \"create-random\") {\n    const n = Number(command.intent.totalAmount);\n    if (!Number.isFinite(n) || n <= 0) throw new Error(\"invalid amount\");\n    if (command.intent.maxClaims < 1) throw new Error(\"invalid claim count\");\n  }\n  if (command.kind === \"claim\" && !command.intent.shareId) {\n    throw new Error(\"missing packet\");\n  }\n}\n\nexport function createRedpacketRuntime(options: {\n  signer?: RedpacketSignerPort;\n  execution: RedpacketExecutionPort;\n  onChange?: (snapshot: RedpacketSnapshot) => void;\n}) {\n  let current: RedpacketSnapshot = { status: \"idle\" };\n  const claimed = new Set<string>();\n  const set = (next: RedpacketSnapshot) => {\n    current = next;\n    options.onChange?.(next);\n    return next;\n  };\n\n  return {\n    snapshot() {\n      return current;\n    },\n    async submit(command: RedpacketCommand) {\n      if (command.kind === \"claim\" && claimed.has(command.intent.shareId)) {\n        return set({\n          status: \"already-claimed\",\n          command,\n          error: new Error(\"already claimed\"),\n        });\n      }\n      set({ status: \"validating\", command });\n      try {\n        validateRedpacketCommand(command);\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        return set({ status: \"failed\", command, error: err });\n      }\n      if (!options.signer) {\n        return set({\n          status: \"rejected\",\n          command,\n          error: new Error(\"missing signer\"),\n        });\n      }\n      set({ status: \"signing\", command });\n      let signed: string;\n      try {\n        signed = await options.signer.sign(command);\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        return set({ status: \"rejected\", command, error: err });\n      }\n      set({ status: \"submitting\", command });\n      try {\n        const result = await options.execution.submit(signed, command);\n        if (result.alreadyClaimed) {\n          claimed.add(command.kind === \"claim\" ? command.intent.shareId : result.packetId);\n          return set({\n            status: \"already-claimed\",\n            command,\n            packetId: result.packetId,\n          });\n        }\n        if (command.kind === \"claim\") claimed.add(command.intent.shareId);\n        return set({\n          status: \"succeeded\",\n          command,\n          packetId: result.packetId,\n        });\n      } catch (error) {\n        const err = error instanceof Error ? error : new Error(String(error));\n        return set({ status: \"failed\", command, error: err });\n      }\n    },\n  };\n}\n\nexport function createInMemoryRedpacketPorts(options: {\n  signError?: Error;\n  alreadyClaimed?: boolean;\n  timeout?: boolean;\n} = {}) {\n  return {\n    signer: {\n      async sign() {\n        if (options.signError) throw options.signError;\n        return \"signed\";\n      },\n    },\n    execution: {\n      async submit(signed: string, command: RedpacketCommand) {\n        void signed;\n        if (options.timeout) throw new Error(\"submit timeout\");\n        return {\n          packetId:\n            command.kind === \"claim\" ? command.intent.shareId : \"packet-memory\",\n          alreadyClaimed: options.alreadyClaimed,\n        };\n      },\n    },\n  };\n}\n","import {\n  createContext,\n  createElement,\n  useContext,\n  type PropsWithChildren,\n} from \"react\";\n\nexport const PACKAGE_NAME = \"@liberfi.io/react-redpacket\" as const;\n\nconst ReadyContext = createContext(true);\n\nexport function RedpacketProvider({ children }: PropsWithChildren) {\n  return createElement(ReadyContext.Provider, { value: true }, children);\n}\n\nexport function useRedpacketReady(): boolean {\n  return useContext(ReadyContext);\n}\n\nexport { redPacketQueryKeys } from \"./query-keys\";\nexport type {\n  ClaimRedPacketIntent,\n  CreateFixedAmountRedPacketIntent,\n  CreateRandomAmountRedPacketIntent,\n  RedpacketIntentStatus,\n  RedpacketPacketStatus,\n  RedpacketRecord,\n} from \"./types\";\nexport { redpacketRecordStatus } from \"./types\";\nexport {\n  createInMemoryRedpacketPorts,\n  createRedpacketRuntime,\n  validateRedpacketCommand,\n} from \"./redpacket-runtime\";\nexport type {\n  RedpacketCommand,\n  RedpacketExecutionPort,\n  RedpacketSignerPort,\n  RedpacketSnapshot,\n} from \"./redpacket-runtime\";\n"]}

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@liberfi.io/react-redpacket",
+  "version": "0.1.1",
+  "description": "Redpacket domain runtime and React bindings",
+  "main": "dist/index.js",
+  "module": "dist/index.mjs",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": {
+        "types": "./dist/index.d.mts",
+        "default": "./dist/index.mjs"
+      },
+      "require": {
+        "types": "./dist/index.d.ts",
+        "default": "./dist/index.js"
+      }
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "dist"
+  ],
+  "peerDependencies": {
+    "@tanstack/react-query": ">=5",
+    "react": ">=18",
+    "react-dom": ">=18"
+  },
+  "dependencies": {
+    "@liberfi.io/types": "0.4.74",
+    "@liberfi.io/utils": "0.2.73"
+  },
+  "devDependencies": {
+    "@tanstack/react-query": "^5.90.2",
+    "@testing-library/jest-dom": "^6.9.1",
+    "@testing-library/react": "^16.3.0",
+    "@types/jest": "^30.0.0",
+    "@types/react": "^19.1.13",
+    "@types/react-dom": "^19.1.9",
+    "jest": "^30.2.0",
+    "jest-environment-jsdom": "^30.2.0",
+    "react": "^19.1.1",
+    "react-dom": "^19.1.1",
+    "rimraf": "^5.0.5",
+    "ts-jest": "^29.4.5",
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.2",
+    "tsconfig": "0.1.257"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "dev": "tsup --watch",
+    "build": "rimraf -rf dist && tsup",
+    "test": "jest --config jest.config.cjs --runInBand --detectOpenHandles",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "lint": "eslint src"
+  }
+}