@echoxyz/sonar-core 0.11.0 → 0.13.0

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # @echoxyz/sonar-core
 
+## 0.13.0
+
+### Minor Changes
+
+- c551d7c: Add BasicPermitV3 type with OpensAt and ClosesAt fields for time-gated commitment windows:
+    - Add `BasicPermitV3` type with new `OpensAt` and `ClosesAt` fields
+    - Add `BASIC_V3` to `PurchasePermitType` enum
+    - Update `PurchasePermit` conditional type to handle V3
+    - Update `GeneratePurchasePermitResponse` to include `BasicPermitV3`
+    - Mark `BasicPermitV2` as deprecated
+
+- b2cd697: Rename Allocation API to Limits API to match backend changes:
+    - `fetchAllocation` → `fetchLimits`
+    - `AllocationResponse` → `LimitsResponse`
+    - Response fields renamed: `HasReservedAllocation` → `HasCustomCommitmentAmountLimit`, `ReservedAmountUSD` removed, `MaxAmountUSD` → `MaxCommitmentAmount`, added `MinCommitmentAmount`
+    - `PrePurchaseFailureReason.NO_RESERVED_ALLOCATION` → `PrePurchaseFailureReason.NO_CUSTOM_COMMITMENT_AMOUNT_LIMIT`
+
+### Patch Changes
+
+- e276112: Add `pnpm fmt` script for running prettier and format check to CI
+- 171a0db: Added support for ReadEntityInvestmentHistory API
+
+## 0.12.0
+
+### Minor Changes
+
+- cc7380c: Sync EntitySetupState and SaleEligibility with the API
+
 ## 0.11.0
 
 ### Minor Changes

package/README.md

@@ -72,6 +72,13 @@ export async function completeOAuthFromCallback() {
 export async function exampleCalls() {
     const { walletAddress } = useWallet(); // User's connected wallet.
 
+    // Get the authenticated user's profile information
+    const profile = await client.myProfile();
+    console.log(profile.EntityID); // Entity ID for the authenticated user
+    if (profile.EmailAddress) {
+        console.log(profile.EmailAddress); // Email address (only present if authorized with contact:email scope)
+    }
+
     // Read the entity for linked to the wallet for the configured sale.
     // If the authenticated user has not yet linked the wallet on Sonar, this will return a 404.
     const { Entity } = await client.readEntity({ saleUUID, walletAddress });
@@ -96,9 +103,9 @@ export async function exampleCalls() {
         console.log(permit.Signature, permit.Permit);
     }
 
-    // Fetch allocation
-    const alloc = await client.fetchAllocation({ saleUUID, walletAddress });
-    console.log(alloc);
+    // Fetch limits
+    const limits = await client.fetchLimits({ saleUUID, walletAddress });
+    console.log(limits);
 }
 ```
 

package/dist/index.cjs

@@ -279,6 +279,12 @@ var SonarClient = class {
       refresh_token: args.refreshToken
     });
   }
+  async myProfile() {
+    return this.postJSON("/externalapi.MyProfile", {});
+  }
+  async readEntityInvestmentHistory() {
+    return this.postJSON("/externalapi.ReadEntityInvestmentHistory", {});
+  }
   async prePurchaseCheck(args) {
     return this.postJSON("/externalapi.PrePurchaseCheck", {
       SaleUUID: args.saleUUID,
@@ -293,8 +299,8 @@ var SonarClient = class {
       PurchasingWalletAddress: args.walletAddress
     });
   }
-  async fetchAllocation(args) {
-    return this.postJSON("/externalapi.Allocation", {
+  async fetchLimits(args) {
+    return this.postJSON("/externalapi.Limits", {
       SaleUUID: args.saleUUID,
       WalletAddress: args.walletAddress
     });
@@ -387,18 +393,20 @@ var EntitySetupState = /* @__PURE__ */ ((EntitySetupState2) => {
   EntitySetupState2["IN_REVIEW"] = "in-review";
   EntitySetupState2["FAILURE"] = "failure";
   EntitySetupState2["FAILURE_FINAL"] = "failure-final";
+  EntitySetupState2["TECHNICAL_ISSUE"] = "technical-issue";
   EntitySetupState2["COMPLETE"] = "complete";
   return EntitySetupState2;
 })(EntitySetupState || {});
 var SaleEligibility = /* @__PURE__ */ ((SaleEligibility2) => {
   SaleEligibility2["ELIGIBLE"] = "eligible";
   SaleEligibility2["NOT_ELIGIBLE"] = "not-eligible";
-  SaleEligibility2["UNKNOWN_INCOMPLETE_SETUP"] = "unknown-incomplete-setup";
+  SaleEligibility2["UNKNOWN_SETUP_INCOMPLETE"] = "unknown-setup-incomplete";
   return SaleEligibility2;
 })(SaleEligibility || {});
 var PurchasePermitType = /* @__PURE__ */ ((PurchasePermitType2) => {
   PurchasePermitType2["BASIC"] = "basic";
   PurchasePermitType2["BASIC_V2"] = "basic-v2";
+  PurchasePermitType2["BASIC_V3"] = "basic-v3";
   PurchasePermitType2["ALLOCATION"] = "allocation";
   return PurchasePermitType2;
 })(PurchasePermitType || {});
@@ -407,7 +415,6 @@ var PrePurchaseFailureReason = /* @__PURE__ */ ((PrePurchaseFailureReason2) => {
   PrePurchaseFailureReason2["WALLET_RISK"] = "wallet-risk";
   PrePurchaseFailureReason2["MAX_WALLETS_USED"] = "max-wallets-used";
   PrePurchaseFailureReason2["REQUIRES_LIVENESS"] = "requires-liveness";
-  PrePurchaseFailureReason2["NO_RESERVED_ALLOCATION"] = "no-reserved-allocation";
   PrePurchaseFailureReason2["SALE_NOT_ACTIVE"] = "sale-not-active";
   PrePurchaseFailureReason2["WALLET_NOT_LINKED"] = "wallet-not-linked";
   return PrePurchaseFailureReason2;

package/dist/index.d.cts

@@ -40,12 +40,13 @@ declare enum EntitySetupState {
     IN_REVIEW = "in-review",
     FAILURE = "failure",
     FAILURE_FINAL = "failure-final",
+    TECHNICAL_ISSUE = "technical-issue",
     COMPLETE = "complete"
 }
 declare enum SaleEligibility {
     ELIGIBLE = "eligible",
     NOT_ELIGIBLE = "not-eligible",
-    UNKNOWN_INCOMPLETE_SETUP = "unknown-incomplete-setup"
+    UNKNOWN_SETUP_INCOMPLETE = "unknown-setup-incomplete"
 }
 type BasicPermit = {
     EntityID: Hex;
@@ -71,18 +72,31 @@ type BasicPermitV2 = {
     MaxPrice: number;
     Payload: Hex;
 };
+type BasicPermitV3 = {
+    SaleSpecificEntityID: Hex;
+    SaleUUID: Hex;
+    Wallet: Hex;
+    ExpiresAt: number;
+    MinAmount: string;
+    MaxAmount: string;
+    MinPrice: number;
+    MaxPrice: number;
+    OpensAt: number;
+    ClosesAt: number;
+    Payload: Hex;
+};
 declare enum PurchasePermitType {
     BASIC = "basic",
     BASIC_V2 = "basic-v2",
+    BASIC_V3 = "basic-v3",
     ALLOCATION = "allocation"
 }
-type PurchasePermit<T extends PurchasePermitType> = T extends PurchasePermitType.BASIC ? BasicPermit : T extends PurchasePermitType.BASIC_V2 ? BasicPermitV2 : T extends PurchasePermitType.ALLOCATION ? AllocationPermit : never;
+type PurchasePermit<T extends PurchasePermitType> = T extends PurchasePermitType.BASIC ? BasicPermit : T extends PurchasePermitType.BASIC_V2 ? BasicPermitV2 : T extends PurchasePermitType.BASIC_V3 ? BasicPermitV3 : T extends PurchasePermitType.ALLOCATION ? AllocationPermit : never;
 declare enum PrePurchaseFailureReason {
     UNKNOWN = "unknown",
     WALLET_RISK = "wallet-risk",
     MAX_WALLETS_USED = "max-wallets-used",
     REQUIRES_LIVENESS = "requires-liveness",
-    NO_RESERVED_ALLOCATION = "no-reserved-allocation",
     SALE_NOT_ACTIVE = "sale-not-active",
     WALLET_NOT_LINKED = "wallet-not-linked"
 }
@@ -100,6 +114,18 @@ type EntityDetails = {
     SaleEligibility: SaleEligibility;
     InvestingRegion: InvestingRegion;
 };
+type MyProfileResponse = {
+    EntityID: string;
+    EmailAddress?: string;
+};
+type EntityInvestment = {
+    CompanyName: string;
+    Round: string;
+    InvestedOn: string;
+};
+type EntityInvestmentHistoryResponse = {
+    Investments: EntityInvestment[];
+};
 
 type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 type PrePurchaseCheckResponse = {
@@ -108,13 +134,13 @@ type PrePurchaseCheckResponse = {
     LivenessCheckURL: string;
 };
 type GeneratePurchasePermitResponse = {
-    PermitJSON: BasicPermit | BasicPermitV2 | AllocationPermit;
+    PermitJSON: BasicPermit | BasicPermitV2 | BasicPermitV3 | AllocationPermit;
     Signature: Hex;
 };
-type AllocationResponse = {
-    HasReservedAllocation: boolean;
-    ReservedAmountUSD: string;
-    MaxAmountUSD: string;
+type LimitsResponse = {
+    HasCustomCommitmentAmountLimit: boolean;
+    MinCommitmentAmount: string;
+    MaxCommitmentAmount: string;
 };
 type ReadEntityResponse = {
     Entity: EntityDetails;
@@ -156,6 +182,8 @@ declare class SonarClient {
     refreshToken(args: {
         refreshToken: string;
     }): Promise<TokenResponse>;
+    myProfile(): Promise<MyProfileResponse>;
+    readEntityInvestmentHistory(): Promise<EntityInvestmentHistoryResponse>;
     prePurchaseCheck(args: {
         saleUUID: string;
         entityID: EntityID;
@@ -166,10 +194,10 @@ declare class SonarClient {
         entityID: EntityID;
         walletAddress: string;
     }): Promise<GeneratePurchasePermitResponse>;
-    fetchAllocation(args: {
+    fetchLimits(args: {
         saleUUID: string;
         walletAddress: string;
-    }): Promise<AllocationResponse>;
+    }): Promise<LimitsResponse>;
     readEntity(args: {
         saleUUID: string;
         walletAddress: string;
@@ -211,4 +239,4 @@ type CreateClientOptions = {
 };
 declare function createClient(options?: CreateClientOptions): SonarClient;
 
-export { APIError, type AllocationPermit, type AllocationResponse, type BasicPermit, type BasicPermitV2, type BuildAuthorizationUrlArgs, type ClientOptions, type CreateClientOptions, type EntityDetails, type EntityID, EntitySetupState, EntityType, type FetchLike, type GeneratePurchasePermitResponse, type Hex, InvestingRegion, type ListAvailableEntitiesResponse, type PrePurchaseCheckResponse, PrePurchaseFailureReason, type PurchasePermit, PurchasePermitType, type ReadEntityResponse, SaleEligibility, SonarClient, type StorageLike, type TokenResponse, buildAuthorizationUrl, createClient, createMemoryStorage, createWebStorage, generatePKCEParams };
+export { APIError, type AllocationPermit, type BasicPermit, type BasicPermitV2, type BasicPermitV3, type BuildAuthorizationUrlArgs, type ClientOptions, type CreateClientOptions, type EntityDetails, type EntityID, type EntityInvestment, type EntityInvestmentHistoryResponse, EntitySetupState, EntityType, type FetchLike, type GeneratePurchasePermitResponse, type Hex, InvestingRegion, type LimitsResponse, type ListAvailableEntitiesResponse, type MyProfileResponse, type PrePurchaseCheckResponse, PrePurchaseFailureReason, type PurchasePermit, PurchasePermitType, type ReadEntityResponse, SaleEligibility, SonarClient, type StorageLike, type TokenResponse, buildAuthorizationUrl, createClient, createMemoryStorage, createWebStorage, generatePKCEParams };

package/dist/index.d.ts

@@ -40,12 +40,13 @@ declare enum EntitySetupState {
     IN_REVIEW = "in-review",
     FAILURE = "failure",
     FAILURE_FINAL = "failure-final",
+    TECHNICAL_ISSUE = "technical-issue",
     COMPLETE = "complete"
 }
 declare enum SaleEligibility {
     ELIGIBLE = "eligible",
     NOT_ELIGIBLE = "not-eligible",
-    UNKNOWN_INCOMPLETE_SETUP = "unknown-incomplete-setup"
+    UNKNOWN_SETUP_INCOMPLETE = "unknown-setup-incomplete"
 }
 type BasicPermit = {
     EntityID: Hex;
@@ -71,18 +72,31 @@ type BasicPermitV2 = {
     MaxPrice: number;
     Payload: Hex;
 };
+type BasicPermitV3 = {
+    SaleSpecificEntityID: Hex;
+    SaleUUID: Hex;
+    Wallet: Hex;
+    ExpiresAt: number;
+    MinAmount: string;
+    MaxAmount: string;
+    MinPrice: number;
+    MaxPrice: number;
+    OpensAt: number;
+    ClosesAt: number;
+    Payload: Hex;
+};
 declare enum PurchasePermitType {
     BASIC = "basic",
     BASIC_V2 = "basic-v2",
+    BASIC_V3 = "basic-v3",
     ALLOCATION = "allocation"
 }
-type PurchasePermit<T extends PurchasePermitType> = T extends PurchasePermitType.BASIC ? BasicPermit : T extends PurchasePermitType.BASIC_V2 ? BasicPermitV2 : T extends PurchasePermitType.ALLOCATION ? AllocationPermit : never;
+type PurchasePermit<T extends PurchasePermitType> = T extends PurchasePermitType.BASIC ? BasicPermit : T extends PurchasePermitType.BASIC_V2 ? BasicPermitV2 : T extends PurchasePermitType.BASIC_V3 ? BasicPermitV3 : T extends PurchasePermitType.ALLOCATION ? AllocationPermit : never;
 declare enum PrePurchaseFailureReason {
     UNKNOWN = "unknown",
     WALLET_RISK = "wallet-risk",
     MAX_WALLETS_USED = "max-wallets-used",
     REQUIRES_LIVENESS = "requires-liveness",
-    NO_RESERVED_ALLOCATION = "no-reserved-allocation",
     SALE_NOT_ACTIVE = "sale-not-active",
     WALLET_NOT_LINKED = "wallet-not-linked"
 }
@@ -100,6 +114,18 @@ type EntityDetails = {
     SaleEligibility: SaleEligibility;
     InvestingRegion: InvestingRegion;
 };
+type MyProfileResponse = {
+    EntityID: string;
+    EmailAddress?: string;
+};
+type EntityInvestment = {
+    CompanyName: string;
+    Round: string;
+    InvestedOn: string;
+};
+type EntityInvestmentHistoryResponse = {
+    Investments: EntityInvestment[];
+};
 
 type FetchLike = (input: RequestInfo | URL, init?: RequestInit) => Promise<Response>;
 type PrePurchaseCheckResponse = {
@@ -108,13 +134,13 @@ type PrePurchaseCheckResponse = {
     LivenessCheckURL: string;
 };
 type GeneratePurchasePermitResponse = {
-    PermitJSON: BasicPermit | BasicPermitV2 | AllocationPermit;
+    PermitJSON: BasicPermit | BasicPermitV2 | BasicPermitV3 | AllocationPermit;
     Signature: Hex;
 };
-type AllocationResponse = {
-    HasReservedAllocation: boolean;
-    ReservedAmountUSD: string;
-    MaxAmountUSD: string;
+type LimitsResponse = {
+    HasCustomCommitmentAmountLimit: boolean;
+    MinCommitmentAmount: string;
+    MaxCommitmentAmount: string;
 };
 type ReadEntityResponse = {
     Entity: EntityDetails;
@@ -156,6 +182,8 @@ declare class SonarClient {
     refreshToken(args: {
         refreshToken: string;
     }): Promise<TokenResponse>;
+    myProfile(): Promise<MyProfileResponse>;
+    readEntityInvestmentHistory(): Promise<EntityInvestmentHistoryResponse>;
     prePurchaseCheck(args: {
         saleUUID: string;
         entityID: EntityID;
@@ -166,10 +194,10 @@ declare class SonarClient {
         entityID: EntityID;
         walletAddress: string;
     }): Promise<GeneratePurchasePermitResponse>;
-    fetchAllocation(args: {
+    fetchLimits(args: {
         saleUUID: string;
         walletAddress: string;
-    }): Promise<AllocationResponse>;
+    }): Promise<LimitsResponse>;
     readEntity(args: {
         saleUUID: string;
         walletAddress: string;
@@ -211,4 +239,4 @@ type CreateClientOptions = {
 };
 declare function createClient(options?: CreateClientOptions): SonarClient;
 
-export { APIError, type AllocationPermit, type AllocationResponse, type BasicPermit, type BasicPermitV2, type BuildAuthorizationUrlArgs, type ClientOptions, type CreateClientOptions, type EntityDetails, type EntityID, EntitySetupState, EntityType, type FetchLike, type GeneratePurchasePermitResponse, type Hex, InvestingRegion, type ListAvailableEntitiesResponse, type PrePurchaseCheckResponse, PrePurchaseFailureReason, type PurchasePermit, PurchasePermitType, type ReadEntityResponse, SaleEligibility, SonarClient, type StorageLike, type TokenResponse, buildAuthorizationUrl, createClient, createMemoryStorage, createWebStorage, generatePKCEParams };
+export { APIError, type AllocationPermit, type BasicPermit, type BasicPermitV2, type BasicPermitV3, type BuildAuthorizationUrlArgs, type ClientOptions, type CreateClientOptions, type EntityDetails, type EntityID, type EntityInvestment, type EntityInvestmentHistoryResponse, EntitySetupState, EntityType, type FetchLike, type GeneratePurchasePermitResponse, type Hex, InvestingRegion, type LimitsResponse, type ListAvailableEntitiesResponse, type MyProfileResponse, type PrePurchaseCheckResponse, PrePurchaseFailureReason, type PurchasePermit, PurchasePermitType, type ReadEntityResponse, SaleEligibility, SonarClient, type StorageLike, type TokenResponse, buildAuthorizationUrl, createClient, createMemoryStorage, createWebStorage, generatePKCEParams };

package/dist/index.js

@@ -242,6 +242,12 @@ var SonarClient = class {
       refresh_token: args.refreshToken
     });
   }
+  async myProfile() {
+    return this.postJSON("/externalapi.MyProfile", {});
+  }
+  async readEntityInvestmentHistory() {
+    return this.postJSON("/externalapi.ReadEntityInvestmentHistory", {});
+  }
   async prePurchaseCheck(args) {
     return this.postJSON("/externalapi.PrePurchaseCheck", {
       SaleUUID: args.saleUUID,
@@ -256,8 +262,8 @@ var SonarClient = class {
       PurchasingWalletAddress: args.walletAddress
     });
   }
-  async fetchAllocation(args) {
-    return this.postJSON("/externalapi.Allocation", {
+  async fetchLimits(args) {
+    return this.postJSON("/externalapi.Limits", {
       SaleUUID: args.saleUUID,
       WalletAddress: args.walletAddress
     });
@@ -350,18 +356,20 @@ var EntitySetupState = /* @__PURE__ */ ((EntitySetupState2) => {
   EntitySetupState2["IN_REVIEW"] = "in-review";
   EntitySetupState2["FAILURE"] = "failure";
   EntitySetupState2["FAILURE_FINAL"] = "failure-final";
+  EntitySetupState2["TECHNICAL_ISSUE"] = "technical-issue";
   EntitySetupState2["COMPLETE"] = "complete";
   return EntitySetupState2;
 })(EntitySetupState || {});
 var SaleEligibility = /* @__PURE__ */ ((SaleEligibility2) => {
   SaleEligibility2["ELIGIBLE"] = "eligible";
   SaleEligibility2["NOT_ELIGIBLE"] = "not-eligible";
-  SaleEligibility2["UNKNOWN_INCOMPLETE_SETUP"] = "unknown-incomplete-setup";
+  SaleEligibility2["UNKNOWN_SETUP_INCOMPLETE"] = "unknown-setup-incomplete";
   return SaleEligibility2;
 })(SaleEligibility || {});
 var PurchasePermitType = /* @__PURE__ */ ((PurchasePermitType2) => {
   PurchasePermitType2["BASIC"] = "basic";
   PurchasePermitType2["BASIC_V2"] = "basic-v2";
+  PurchasePermitType2["BASIC_V3"] = "basic-v3";
   PurchasePermitType2["ALLOCATION"] = "allocation";
   return PurchasePermitType2;
 })(PurchasePermitType || {});
@@ -370,7 +378,6 @@ var PrePurchaseFailureReason = /* @__PURE__ */ ((PrePurchaseFailureReason2) => {
   PrePurchaseFailureReason2["WALLET_RISK"] = "wallet-risk";
   PrePurchaseFailureReason2["MAX_WALLETS_USED"] = "max-wallets-used";
   PrePurchaseFailureReason2["REQUIRES_LIVENESS"] = "requires-liveness";
-  PrePurchaseFailureReason2["NO_RESERVED_ALLOCATION"] = "no-reserved-allocation";
   PrePurchaseFailureReason2["SALE_NOT_ACTIVE"] = "sale-not-active";
   PrePurchaseFailureReason2["WALLET_NOT_LINKED"] = "wallet-not-linked";
   return PrePurchaseFailureReason2;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@echoxyz/sonar-core",
-  "version": "0.11.0",
+  "version": "0.13.0",
   "type": "module",
   "main": "./dist/index.cjs",
   "module": "./dist/index.js",