@campnetwork/origin 1.4.0-alpha.4 → 1.4.0-alpha.5

package/dist/react/index.esm.d.ts

@@ -794,7 +794,7 @@ interface MintParams {
  *     creatorContentHash: "0x...",
  *     uri: "ipfs://...",
  *     licenseTerms: { price: 1000n, duration: 86400, royaltyBps: 500, paymentToken: zeroAddress, licenseType: 0 },
- *     deadline: BigInt(Date.now() + 600000),
+ *     deadline: BigInt(Math.floor(Date.now() / 1000) + 600),
  *     parents: [],
  *     isIP: true,
  *     appId: "myApp",
@@ -821,6 +821,103 @@ declare function bulkMint(this: Origin, mints: MintParams[]): Promise<any>;
  */
 declare function bulkMintTolerant(this: Origin, mints: MintParams[]): Promise<any>;
 
+interface OriginContext {
+    environment: {
+        AUTH_HUB_BASE_API: string;
+    };
+    [key: string]: any;
+}
+type IpfsPinningProvider = "pinata" | "infura" | "web3storage";
+interface IpfsCredentials {
+    provider: IpfsPinningProvider;
+    apiKey?: string;
+    apiSecret?: string;
+    jwt?: string;
+    token?: string;
+    projectId?: string;
+    projectSecret?: string;
+}
+interface IpfsUploadConfig {
+    provider: IpfsPinningProvider;
+    pinata?: {
+        jwt?: string;
+        apiKey?: string;
+        apiSecret?: string;
+    };
+    infura?: {
+        projectId: string;
+        projectSecret: string;
+        endpoint: string;
+    };
+    web3storage?: {
+        token: string;
+    };
+}
+/**
+ * Save IPFS credentials for large file uploads.
+ * Users can configure their own IPFS pinning service (Pinata, Infura, or web3.storage).
+ * @param credentials The IPFS credentials to save.
+ * @throws {APIError} If saving credentials fails.
+ * @example
+ * ```typescript
+ * // Save Pinata credentials
+ * await origin.saveIpfsCredentials({
+ *   provider: 'pinata',
+ *   jwt: 'your-pinata-jwt-token'
+ * });
+ *
+ * // Save Infura credentials
+ * await origin.saveIpfsCredentials({
+ *   provider: 'infura',
+ *   projectId: 'your-project-id',
+ *   projectSecret: 'your-project-secret'
+ * });
+ * ```
+ */
+declare function saveIpfsCredentials(this: OriginContext, credentials: IpfsCredentials): Promise<void>;
+/**
+ * Verify that saved IPFS credentials are valid.
+ * @returns Object with valid boolean and optional error message.
+ * @throws {APIError} If verification request fails.
+ */
+declare function verifyIpfsCredentials(this: OriginContext): Promise<{
+    valid: boolean;
+    error?: string;
+}>;
+/**
+ * Delete saved IPFS credentials.
+ * @throws {APIError} If deletion fails.
+ */
+declare function deleteIpfsCredentials(this: OriginContext): Promise<void>;
+/**
+ * Check if user has IPFS credentials configured.
+ * @returns True if credentials are configured, false otherwise.
+ */
+declare function hasIpfsCredentials(this: OriginContext): Promise<boolean>;
+/**
+ * Get IPFS upload config for client-side uploads.
+ * @returns IPFS config or null if not configured.
+ */
+declare function getIpfsUploadConfig(this: OriginContext): Promise<IpfsUploadConfig | null>;
+/**
+ * Upload a file to user's IPFS pinning service.
+ * @param file The file to upload.
+ * @param config The IPFS upload config.
+ * @param progressCallback Optional progress callback with intermediate upload progress.
+ * @returns The IPFS CID of the uploaded file.
+ */
+declare function uploadToUserIPFS(this: OriginContext, file: File, config: IpfsUploadConfig, progressCallback?: (percent: number) => void): Promise<string>;
+/**
+ * Register an IPFS file with the backend after client-side upload.
+ * @param cid The IPFS CID of the uploaded file.
+ * @param fileName The original file name.
+ * @param fileType The file MIME type.
+ * @returns The registered file key.
+ */
+declare function registerIpfsFile(this: OriginContext, cid: string, fileName: string, fileType: string): Promise<{
+    fileKey: string;
+}>;
+
 interface RoyaltyInfo {
     tokenBoundAccount: Address;
     balance: bigint;
@@ -891,6 +988,13 @@ declare class Origin {
     deployVaultForExistingNFT: typeof deployVaultForExistingNFT;
     getRoyaltyTokenBalance: typeof getRoyaltyTokenBalance;
     getAppInfo: typeof getAppInfo;
+    saveIpfsCredentials: typeof saveIpfsCredentials;
+    verifyIpfsCredentials: typeof verifyIpfsCredentials;
+    deleteIpfsCredentials: typeof deleteIpfsCredentials;
+    hasIpfsCredentials: typeof hasIpfsCredentials;
+    getIpfsUploadConfig: typeof getIpfsUploadConfig;
+    uploadToUserIPFS: typeof uploadToUserIPFS;
+    registerIpfsFile: typeof registerIpfsFile;
     private jwt?;
     environment: Environment;
     private viemClient?;
@@ -920,13 +1024,14 @@ declare class Origin {
      * @param metadata The metadata associated with the file.
      * @param license The license terms for the IpNFT.
      * @param parents Optional parent token IDs for lineage tracking.
-     * @param options Optional parameters including progress callback, preview image, and use asset as preview flag.
+     * @param options Optional parameters including progress callback, preview image, use asset as preview flag, and forceIpfs.
      * @returns The token ID of the minted IpNFT as a string, or null if minting failed.
      */
     mintFile(file: File, metadata: Record<string, unknown>, license: LicenseTerms, parents?: bigint[], options?: {
         progressCallback?: (percent: number) => void;
         previewImage?: File | null;
         useAssetAsPreview?: boolean;
+        forceIpfs?: boolean;
     }): Promise<string | null>;
     /**
      * Mints multiple file-based IpNFTs in a single transaction using the BatchOperations contract.
@@ -950,6 +1055,7 @@ declare class Origin {
      */
     bulkMintFile(entries: BulkMintFileEntry[], options?: {
         tolerant?: boolean;
+        forceIpfs?: boolean;
         progressCallback?: (progress: {
             fileIndex: number;
             fileCount: number;