@rezamirzapour/pod-sdk 1.0.4 → 1.0.7

package/dist/index.d.mts

@@ -43,18 +43,27 @@ interface SendOtpOptions {
 interface PodUrlsConfig {
     accounts?: string;
     apiPod?: string;
+    apiPodSandbox?: string;
     cms?: string;
+    iums?: string;
+    notification?: string;
+    podreport?: string;
     podspace?: string;
     podform?: string;
-    notification?: string;
-    iums?: string;
+    sandboxCms?: string;
+    sandboxCmsClient?: string;
+    sandboxPodspace?: string;
+    sandboxStream?: string;
+    stream?: string;
     website?: string;
+    [key: string]: string | undefined;
 }
 interface PodSdkConfig {
     apiToken?: string;
     clientId?: string;
     clientSecret?: string;
     privateKeyPem?: string;
+    sandbox?: boolean;
     urls?: PodUrlsConfig;
     revalidate?: number | string;
     timeout?: number;
@@ -350,41 +359,1438 @@ declare class CustomPostService {
     createCrud<DataType>(config: CustomPostCrudConfig): CustomPostCrudService<DataType>;
 }
 
-interface PodspaceUploadResult {
+/**
+ * Generic Podspace API REST Response wrapper.
+ */
+interface PodspaceRestResponse<T = any> {
+    status?: number;
+    hasError?: boolean;
+    error?: string;
+    message?: string;
+    path?: string;
+    timestamp?: string;
+    result: T;
+    reference?: string;
+    errorCode?: number;
+    [key: string]: any;
+}
+/**
+ * Backward-compatible upload response alias.
+ */
+type PodspaceUploadResponse = PodspaceRestResponse<SpaceFile>;
+/**
+ * Backward-compatible upload result alias.
+ */
+type PodspaceUploadResult = SpaceFile;
+/**
+ * Request options for Podspace operations.
+ */
+interface PodspaceRequestOptions {
+    headers?: Record<string, string>;
+    cache?: RequestCache;
+    revalidate?: number | false;
+    signal?: AbortSignal;
+}
+type CachePolicy = 'NEVER_CACHE' | 'IMMUTABLE' | 'CACHE_WITH_REVALIDATE' | 'SHORT_CACHE' | 'LONG_CACHE' | 'SHORT_CACHE_WITH_REVALIDATE' | 'LONG_CACHE_WITH_REVALIDATE';
+type ThumbnailStatus = 'WAITING_FOR_THUMBNAIL' | 'FAILED' | 'WITHOUT_THUMBNAIL' | 'THUMBNAIL_EXIST' | 'THUMBNAIL_EXIST_GIF' | 'THUMBNAIL_EXIST_JPEG' | 'THUMBNAIL_EXIST_PNG';
+type AccessLevel = 'VIEW' | 'CUSTOM' | 'EDIT';
+type ShareType = 'PUBLIC' | 'LINK' | 'PRIVATE' | 'ORGANIZATION' | 'UNIQUE';
+type ShareAccess = 'MOVE' | 'TRASH' | 'WIPE' | 'CREATE_FOLDER' | 'CREATE_FILE' | 'REPLACE' | 'MODIFY_PROPERTY' | 'DOWNLOAD' | 'COPY' | 'VIEW' | 'PRIVATE_SHARE' | 'GET_LINK' | 'PUBLIC_SHARE';
+interface PodspaceUser {
+    username?: string;
+    name?: string;
+    ssoId?: number;
+    avatar?: string;
+    roles?: string[];
+    type?: 'user' | 'space' | 'business' | 'application' | 'thing' | string;
+    [key: string]: any;
+}
+interface FileVersion {
+    hash?: string;
+    version?: number;
+    size?: number;
+    created?: number;
+    updated?: number;
+    uploader?: PodspaceUser;
+    [key: string]: any;
+}
+interface SpaceFolder {
     hash: string;
     name: string;
+    link?: string;
+    type?: string;
+    isRemovedTemporary?: boolean;
+    isRemovedPermanently?: boolean;
+    parentHash?: string;
+    owner?: PodspaceUser;
+    uploader?: PodspaceUser;
+    attributes?: string[];
+    tags?: string[];
+    description?: string;
+    metaData?: Record<string, any>;
+    totalFilesCount?: number;
+    totalFoldersCount?: number;
+    filesCount?: number;
+    foldersCount?: number;
+    size?: number;
+    nativeMataData?: string;
+    zone?: string;
+    isPublic?: boolean;
+    isShared?: boolean;
+    isBookmarked?: boolean;
+    userCanTrash?: boolean;
+    created?: number;
+    updated?: number;
+    spaceEntities?: SpaceEntity[];
+    accessLevel?: AccessLevel;
+    [key: string]: any;
+}
+interface SpaceFile {
+    hash: string;
+    name: string;
+    link?: string;
+    type?: string;
+    extension?: string;
+    isRemovedTemporary?: boolean;
+    isRemovedPermanently?: boolean;
+    parentHash?: string;
+    owner?: PodspaceUser;
+    uploader?: PodspaceUser;
+    attributes?: string[];
+    tags?: string[];
+    description?: string;
+    metaData?: Record<string, any>;
+    breadCrumb?: SpaceFolder[];
+    size?: number;
+    nativeMataData?: string;
+    zone?: string;
+    isPublic?: boolean;
+    isShared?: boolean;
+    isBookmarked?: boolean;
+    userCanTrash?: boolean;
+    created?: number;
+    updated?: number;
+    version?: number;
+    versions?: FileVersion[];
+    thumbnail?: ThumbnailStatus;
+    cachePolicy?: CachePolicy;
+    sha256?: string;
+    md5?: string;
+    restricted?: boolean;
+    [key: string]: any;
+}
+type SpaceEntity = SpaceFile | SpaceFolder;
+interface ApiPageLink {
+    next?: string;
+    previous?: string;
+    self?: string;
+    first?: string;
+    last?: string;
+}
+interface ApiPageList<T = SpaceEntity> {
+    entity?: SpaceEntity;
+    list: T[];
+    breadcrumb?: SpaceFolder[];
+    count?: number;
+    links?: ApiPageLink;
+    workspace?: any;
+    members?: any[];
+    [key: string]: any;
+}
+interface ApiSimplePageList<T = any> {
+    list: T[];
+    count?: number;
+    group?: any;
+    entity?: any;
+    user?: any;
+    owner?: any;
+    groups?: any[];
+    applications?: any[];
+    members?: any[];
+    [key: string]: any;
+}
+interface Share {
+    hash: string;
+    entity?: SpaceEntity;
+    entityType?: 'FILE' | 'FOLDER';
+    type?: ShareType;
+    level?: AccessLevel;
+    expiration?: number;
+    isRemoved?: boolean;
+    creator?: PodspaceUser;
+    person?: PodspaceUser;
+    created?: number;
+    updated?: number;
+    accessList?: ShareAccess[];
+    [key: string]: any;
+}
+interface WorkspaceMember {
+    user?: PodspaceUser;
+    accessLevel?: AccessLevel;
+    role?: string;
+    created?: number;
+    [key: string]: any;
+}
+interface Workspace {
+    id?: number;
+    ssoId?: number;
+    username?: string;
+    title?: string;
+    description?: string;
+    creator?: PodspaceUser;
+    members?: WorkspaceMember[];
+    [key: string]: any;
+}
+interface UserGroup {
+    hash: string;
+    name?: string;
+    owner?: PodspaceUser;
+    users?: PodspaceUser[];
+    files?: SpaceFile[];
+    isRemoved?: boolean;
+    created?: number;
+    updated?: number;
+    size?: number;
+    fileSizeLimit?: number;
+    folder?: SpaceFolder;
+    cachePolicy?: CachePolicy;
+    metadata?: Record<string, any>;
+    [key: string]: any;
+}
+interface UserUsageReport {
+    usedSize?: number;
+    totalSize?: number;
+    count?: number;
+    [key: string]: any;
+}
+interface UserPlan {
+    id?: number;
+    name?: string;
+    maxStorageSize?: number;
+    maxUploadSize?: number;
+    [key: string]: any;
+}
+interface UploadFileParams {
+    path?: string;
+    folderHash?: string;
+    isPublic?: boolean;
+    description?: string;
+    tags?: string[] | string;
+    userMetadata?: Record<string, any> | string;
+    uniqueName?: boolean;
+    zoneNames?: string[] | string;
+    cachePolicy?: CachePolicy;
+    streamable?: boolean;
+    relevantIdentity?: string;
+    relevantIdentityType?: string;
+    relationType?: string;
+    [key: string]: any;
+}
+interface UploadMultipleFilesParams {
+    path?: string;
+    folderHash?: string;
+    isPublic?: boolean;
+    uploadKey?: string;
+    description?: string;
+    tags?: string[] | string;
+    userMetadata?: Record<string, any> | string;
+    uniqueName?: boolean;
+    zoneNames?: string[] | string;
+    cachePolicy?: CachePolicy;
+    streamable?: boolean;
+    [key: string]: any;
+}
+interface UploadImageBase64Params {
+    filename: string;
+    file: string;
+    path?: string;
+    folderHash?: string;
+    isPublic?: boolean;
+    description?: string;
+    tags?: string[] | string;
+    userMetadata?: Record<string, any> | string;
+    uniqueName?: boolean;
+    zoneNames?: string[] | string;
+    cachePolicy?: CachePolicy;
+    [key: string]: any;
+}
+interface ReplaceFileParams {
+    hashType?: string;
+    uploadKey?: string;
+}
+interface DownloadFileParams {
+    hashType?: string;
+    name?: string;
+    extension?: string;
+    password?: string;
+    previewType?: string;
+    size?: number;
+    quality?: number;
+    width?: number;
+    height?: number;
+    keepRatio?: boolean;
+    forceConvert?: boolean;
+    crop?: boolean;
+    cropX?: number;
+    cropY?: number;
+    cropWidth?: number;
+    cropHeight?: number;
+    cachePolicy?: CachePolicy;
+    accessLevel?: AccessLevel;
+    [key: string]: any;
+}
+interface DownloadImageParams {
+    size?: number;
+    name?: string;
+    extension?: string;
+    quality?: number;
+    width?: number;
+    height?: number;
+    keepRatio?: boolean;
+    forceConvert?: boolean;
+    crop?: boolean;
+    cropX?: number;
+    cropY?: number;
+    cropWidth?: number;
+    cropHeight?: number;
+    password?: string;
+    cachePolicy?: CachePolicy;
+    accessLevel?: AccessLevel;
+    [key: string]: any;
+}
+interface DownloadThumbnailParams {
+    password?: string;
+    cachePolicy?: CachePolicy;
+    accessLevel?: AccessLevel;
+}
+interface DownloadZipParams {
+    entityHashes: string[] | string;
+    customName?: string;
+    password?: string;
+}
+interface GetUploadLinkParams {
     size: number;
-    extension: string;
-    created: number;
-    updated: number;
-    path: string;
-    isPublic: boolean;
+    expiration: number;
+    destination?: string;
+    oneTimeUse?: boolean;
+    zoneNames?: string[];
+    fileTypeLimits?: string[];
+    isPublic?: boolean;
+    streamable?: boolean;
+    userGroupHash?: string;
+    userMetadata?: Record<string, any>;
     [key: string]: any;
 }
-interface PodspaceUploadResponse {
-    hasError: boolean;
-    message?: string;
-    errorCode?: number;
-    result?: PodspaceUploadResult;
+interface CreateFolderParams {
+    name: string;
+    parentHash?: string;
+    zoneNames?: string[];
+    userMetadata?: Record<string, any>;
+    description?: string;
+    tags?: string[] | string;
+    uniqueName?: boolean;
+    [key: string]: any;
+}
+interface GetFolderChildrenParams {
+    start?: number;
+    size?: number;
+    order?: string;
+    isDesc?: boolean;
+    breadcrumb?: boolean;
+    shareHash?: string;
+    password?: string;
+    filterAttribute?: string;
+    filterValue?: string;
+    sequentialOrder?: boolean;
+    [key: string]: any;
+}
+interface SearchFilesParams {
+    words?: string;
+    title?: string;
+    parentHash?: string;
+    majorType?: string;
+    minorType?: string;
+    after?: number;
+    before?: number;
+    minSize?: number;
+    maxSize?: number;
+    breadcrumb?: boolean;
+    start?: number;
+    size?: number;
+    order?: string;
+    isDesc?: boolean;
+    sequentialOrder?: boolean;
+    [key: string]: any;
+}
+interface PaginationParams {
+    start?: number;
+    size?: number;
+    order?: string;
+    isDesc?: boolean;
+    [key: string]: any;
+}
+interface FinalizeResumableParams {
+    uploadType: string;
+    resumableType: string;
+    fileHash?: string;
+    usergroupHash?: string;
+    folderHash?: string;
+    userMetadata?: Record<string, any>;
+    description?: string;
+    tags?: string[] | string;
+    zoneName?: string;
+    cachePolicy?: CachePolicy;
+    streamable?: boolean;
+    isPublic?: boolean;
+    uniqueName?: boolean;
+    [key: string]: any;
+}
+interface CreateLinkParams {
+    userGroupHash?: string;
+    expiration?: number;
+    revokeAbility?: boolean;
+    type?: string;
+    accessLevel?: AccessLevel;
+    [key: string]: any;
+}
+interface UpdateLinkParams {
+    linkType: string;
+    size?: number;
+    destination?: string;
+    userGroupHash?: string;
+    expiration?: number;
+    oneTimeUse?: boolean;
+    fileTypeLimits?: string[];
+    userMetadata?: Record<string, any>;
+    zoneName?: string;
+    isPublic?: boolean;
+    streamable?: boolean;
+    [key: string]: any;
+}
+interface ShareEntityParams {
+    identityType?: string;
+    expiration: number;
+    access?: ShareAccess[] | string;
+}
+interface MakePublicParams {
+    expiration: number;
+    password?: string;
+    access?: ShareAccess[] | string;
+}
+interface CreateWorkspaceParams {
+    username: string;
+    title: string;
+    description?: string;
+}
+interface UpdateWorkspaceParams {
+    identityType?: string;
+    username?: string;
+    title?: string;
+    description?: string;
+}
+interface CreateUserGroupParams {
+    name: string;
+    folderHash?: string;
+    zoneNames?: string[];
+    fileSizeLimit?: number;
+    cachePolicy?: CachePolicy;
+    autoShare?: boolean;
+    allowMemberShare?: boolean;
+    metadata?: Record<string, any>;
+    [key: string]: any;
+}
+interface GetBookmarksParams {
+    start?: number;
+    size?: number;
+    order?: string;
+    isDesc?: boolean;
+    filterAttribute?: string;
+    filterValue?: string;
+    [key: string]: any;
+}
+
+interface PodspaceUploadDownloadServiceOptions {
+    http: NextHttp;
+    baseUrl: string;
+    revalidate?: number;
+}
+declare class PodspaceUploadDownloadService {
+    private http;
+    private baseUrl;
+    private revalidate;
+    constructor(options: PodspaceUploadDownloadServiceOptions);
+    /**
+     * Upload a single file via FormData to POD Podspace storage.
+     * Swagger: POST /api/files
+     */
+    uploadFile(formData: FormData, paramsOrPath?: string | UploadFileParams, isPublic?: boolean, options?: PodspaceRequestOptions): Promise<PodspaceUploadResponse>;
+    /**
+     * Upload multiple files simultaneously using FormData.
+     * Swagger: POST /api/files/multiple
+     */
+    uploadMultipleFiles(formData: FormData, params?: UploadMultipleFilesParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile[]>>;
+    /**
+     * Upload an image formatted as Base64 string.
+     * Swagger: POST /api/images/base64
+     */
+    uploadImageBase64(params: UploadImageBase64Params, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Replace the content of an existing file.
+     * Swagger: PUT /api/files/{hash}
+     */
+    replaceFile(hash: string, formData: FormData, params?: ReplaceFileParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Upload a file into an existing reserved link hash.
+     * Swagger: POST /api/files/{hash}
+     */
+    uploadByLink(hash: string, formData: FormData, params?: Record<string, any>, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Downloads raw file data.
+     * Swagger: GET /api/files/{hash}
+     */
+    downloadFile(hash: string, params?: DownloadFileParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Downloads processed image with optional resize, crop, or format conversion.
+     * Swagger: GET /api/v2/images/{hash}
+     */
+    downloadImage(hash: string, params?: DownloadImageParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Downloads file thumbnail.
+     * Swagger: GET /api/files/{hash}/thumbnail
+     */
+    downloadThumbnail(hash: string, params?: DownloadThumbnailParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Downloads multiple files and folders compressed into a single zip file.
+     * Swagger: GET /api/files
+     */
+    downloadFilesAsZip(params: DownloadZipParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Obtains a pre-signed upload link.
+     * Swagger: GET /api/files/link
+     */
+    getUploadLink(params: GetUploadLinkParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<{
+        link: string;
+        hash?: string;
+    }>>;
+    /**
+     * Builds the direct URL to view or download a file.
+     */
+    getFileUrl(hash: string, isPublic?: boolean): string;
+    /**
+     * Builds URL to view/download an image with optional dimensions/crops.
+     */
+    getImageUrl(hash: string, params?: DownloadImageParams): string;
+    /**
+     * Builds URL for a file thumbnail.
+     */
+    getThumbnailUrl(hash: string, params?: DownloadThumbnailParams): string;
+}
+
+interface PodspaceFilesServiceOptions {
+    http: NextHttp;
+    revalidate?: number;
+}
+declare class PodspaceFilesService {
+    private http;
+    private revalidate;
+    constructor(options: PodspaceFilesServiceOptions);
+    /**
+     * Retrieves full detail of a file or folder by its hash.
+     * Swagger: GET /api/files/{hash}/detail
+     */
+    getFileDetail(hash: string, params?: {
+        password?: string;
+        breadcrumb?: boolean;
+        shareHash?: string;
+        nativeMetadata?: boolean;
+        includeSizeAndCount?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Retrieves file details using its storage path.
+     * Swagger: GET /api/files/details
+     */
+    getFileDetailByPath(path: string, params?: {
+        parentHash?: string;
+        password?: string;
+        entityType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Checks if an entity with given name exists in the folder.
+     * Swagger: GET /api/files/{hash}/exist
+     */
+    checkEntityExist(hash: string, fileName: string, params?: {
+        uniqueName?: boolean;
+        type?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Renames a file or folder.
+     * Swagger: PUT /api/files/{hash}/rename
+     */
+    renameEntity(hash: string, newName: string, uniqueName?: boolean, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Moves a file or folder to a new destination folder.
+     * Swagger: PUT /api/files/{hash}/move
+     */
+    moveEntity(hash: string, destFolderHash: string, params?: {
+        policy?: string;
+        uniqueName?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Copies a file or folder to a specified destination folder.
+     * Swagger: PUT /api/files/{hash}/copy
+     */
+    copyEntity(hash: string, destFolderHash: string, params?: {
+        policy?: string;
+        uniqueName?: boolean;
+        copyType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Moves a file or folder to the trash.
+     * Swagger: DELETE /api/files/{hash}
+     */
+    trashEntity(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Updates file attributes (e.g. streamable flag).
+     * Swagger: PATCH /api/files/{hash}
+     */
+    updateFile(hash: string, params: {
+        streamable?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Searches across user files content and folder names.
+     * Swagger: GET /api/files/search
+     */
+    searchFiles(params?: SearchFilesParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<ApiPageList<SpaceEntity>>>;
+    /**
+     * Retrieves list of recently accessed/uploaded files.
+     * Swagger: GET /api/v2/files/recent
+     */
+    getRecentFiles(params?: {
+        start?: number;
+        size?: number;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile[]>>;
+    /**
+     * Retrieves versions history of a file.
+     * Swagger: GET /api/files/v2/{hash}/versions
+     */
+    getFileVersions(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<FileVersion[]>>;
+    /**
+     * Rolls back a file to its previous version.
+     * Swagger: PATCH /api/files/versions/{hash}
+     */
+    rollbackFileVersion(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Retrieves native metadata of a file.
+     * Swagger: GET /api/v2/files/{hash}/native/metadata
+     */
+    getFileNativeMetadata(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Converts supported document file to PDF.
+     * Swagger: GET /api/files/{hash}/convert
+     */
+    convertFileToPdf(hash: string, convertType?: string, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Retrieves breadcrumb path for a file or folder.
+     * Swagger: GET /api/files/{hash}/breadcrumb
+     */
+    getFileBreadcrumb(hash: string, params?: {
+        shareHash?: string;
+        password?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder[]>>;
+    /**
+     * Compresses multiple files and folders into a zip archive on the cloud.
+     * Swagger: POST /api/files/compress
+     */
+    compressToZip(params: {
+        name: string;
+        fileHashes?: string[];
+        folderHashes?: string[];
+        destFolderHash?: string;
+        zoneNames?: string[];
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Extracts a zip archive to a destination folder.
+     * Swagger: PUT /api/files/{hash}/extract
+     */
+    extractZip(hash: string, params?: {
+        destFolderHash?: string;
+        zoneNames?: string[];
+        uniqueName?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Sets or updates the cache policy for a file.
+     * Swagger: PUT /api/files/{hash}/cachePolicy
+     */
+    setCachePolicy(hash: string, cachePolicy: CachePolicy, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Retrieves recent actions and activities done on a file or folder.
+     * Swagger: GET /api/files/{hash}/activities
+     */
+    getFileActivities(hash: string, params?: {
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+        pagination?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves specific activity log by type.
+     * Swagger: GET /api/files/{hash}/activities/{activity}
+     */
+    getSpecificActivities(hash: string, activity: string, params?: {
+        start?: number;
+        size?: number;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves count of specific activities done on file/folder.
+     * Swagger: GET /api/files/{hash}/activities/{activity}/count
+     */
+    getActivitiesCount(hash: string, activity: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<number>>;
+}
+
+interface PodspaceFoldersServiceOptions {
+    http: NextHttp;
+    revalidate?: number;
+}
+declare class PodspaceFoldersService {
+    private http;
+    private revalidate;
+    constructor(options: PodspaceFoldersServiceOptions);
+    /**
+     * Creates a new folder.
+     * Swagger: POST /api/folders
+     */
+    createFolder(params: CreateFolderParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder>>;
+    /**
+     * Creates nested directories inside a parent folder.
+     * Swagger: POST /api/folders/{hash}/directories
+     */
+    createDirectories(hash: string, directories: string[] | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder[]>>;
+    /**
+     * Retrieves subfolders and files inside a specified folder.
+     * Swagger: GET /api/folders/{hash}/children
+     */
+    getFolderChildren(hash: string, params?: GetFolderChildrenParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<ApiPageList>>;
+    /**
+     * Retrieves recent folders accessed or created by user.
+     * Swagger: GET /api/v2/folders/recent
+     */
+    getRecentFolders(params?: {
+        start?: number;
+        size?: number;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder[]>>;
+    /**
+     * Checks if user has enough space and permission to upload a file into the folder.
+     * Swagger: GET /api/folders/{hash}/check/upload
+     */
+    checkFolderUploadAccess(hash: string, size: number, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Retrieves folder actions summary for a specific date.
+     * Swagger: GET /api/folders/{folderHash}/actions
+     */
+    getFolderActions(folderHash: string, date: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+}
+
+interface PodspaceResumableServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceResumableService {
+    private http;
+    constructor(options: PodspaceResumableServiceOptions);
+    /**
+     * Initiates a resumable upload session.
+     * Swagger: POST /api/files/resumable
+     */
+    create(headers?: Record<string, string>, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<{
+        id: string;
+        location?: string;
+    }>>;
+    /**
+     * Uploads a binary chunk to a resumable upload session.
+     * Swagger: PATCH /api/files/resumable/{id}
+     */
+    append(id: string, chunk: Blob | Buffer | Uint8Array, offset: number, options?: PodspaceRequestOptions): Promise<any>;
+    /**
+     * Checks current uploaded byte offset for a resumable session.
+     * Swagger: HEAD /api/files/resumable/{id}
+     */
+    getStatus(id: string, options?: PodspaceRequestOptions): Promise<number>;
+    /**
+     * Finalizes resumable upload and creates the file entity in the user's storage.
+     * Swagger: POST /api/files/resumable/{id}/finalize
+     */
+    finalizeUpload(id: string, params: FinalizeResumableParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+}
+
+interface PodspaceLinksServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceLinksService {
+    private http;
+    constructor(options: PodspaceLinksServiceOptions);
+    /**
+     * Generates a download or integration public link for a file.
+     * Swagger: GET /api/links/files/{hash}
+     */
+    createLink(hash: string, params?: CreateLinkParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<{
+        link: string;
+        [key: string]: any;
+    }>>;
+    /**
+     * Retrieves list of links created by current user.
+     * Swagger: GET /api/links
+     */
+    getUserLinks(params: {
+        linkType: string;
+        folderHash?: string;
+        typeLimits?: string;
+        oneTimeUse?: boolean;
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<ApiPageList>>;
+    /**
+     * Retrieves details of a specific link.
+     * Swagger: GET /api/links/{link}/detail
+     */
+    getLinkDetail(link: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Updates settings and permissions of a link.
+     * Swagger: PATCH /api/links/{link}
+     */
+    updateLink(link: string, params: UpdateLinkParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Revokes an existing link.
+     * Swagger: DELETE /api/links/{link}
+     */
+    revokeLink(link: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Downloads a file using its public shared link.
+     * Swagger: GET /api/links/{hash}
+     */
+    downloadFileByLink(hash: string, params?: Record<string, any>, options?: PodspaceRequestOptions): Promise<Blob>;
+}
+
+interface PodspaceSharesServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceSharesService {
+    private http;
+    constructor(options: PodspaceSharesServiceOptions);
+    /**
+     * Shares a file or folder with a user by their identity (username/ssoId).
+     * Swagger: POST /api/files/{hash}/shares/users/{identity}
+     */
+    shareWithUser(hash: string, identity: string | number, params: ShareEntityParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Share>>;
+    /**
+     * Removes share for a specific user identity.
+     * Swagger: DELETE /api/files/{hash}/shares/users/{identity}
+     */
+    removeShareWithUser(hash: string, identity: string | number, identityType?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Makes a file or folder public with optional password and expiration.
+     * Swagger: POST /api/files/{hash}/public
+     */
+    makePublic(hash: string, params: MakePublicParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Share>>;
+    /**
+     * Retrieves list of files and folders shared with current user.
+     * Swagger: GET /api/shares
+     */
+    getSharedWithMe(params?: {
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+        identity?: string;
+        identityType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Share[]>>;
+    /**
+     * Retrieves details of a share by its share hash.
+     * Swagger: GET /api/shares/{shareHash}
+     */
+    getShareDetail(shareHash: string, password?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Share>>;
+    /**
+     * Revokes a share by its share hash.
+     * Swagger: DELETE /api/shares/{shareHash}
+     */
+    revokeShare(shareHash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Retrieves shares list of a specific file or folder.
+     * Swagger: GET /api/files/{hash}/shares
+     */
+    getFileShares(hash: string, params?: {
+        person?: string;
+        identityType?: string;
+        start?: number;
+        size?: number;
+        pageList?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Share[]>>;
+    /**
+     * Sets or removes password for a share using the share hash.
+     * Swagger: PUT /api/shares/{hash}/password
+     */
+    setSharePassword(shareHash: string, password?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Sets or removes password for a share using the entity hash.
+     * Swagger: PUT /api/files/{hash}/shares/password
+     */
+    setEntityPassword(entityHash: string, password?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+}
+
+interface PodspaceTrashServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceTrashService {
+    private http;
+    constructor(options: PodspaceTrashServiceOptions);
+    /**
+     * Retrieves list of trashed files and folders.
+     * Swagger: GET /api/trashes
+     */
+    getTrashList(params?: {
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+        filterAttribute?: string;
+        filterValue?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity[]>>;
+    /**
+     * Restores a single file or folder from the trash.
+     * Swagger: PUT /api/trashes/{hash}/restore
+     */
+    restore(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Restores all entities from trash.
+     * Swagger: POST /api/trashes/restore
+     */
+    restoreAll(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Permanently deletes a single file or folder from the trash.
+     * Swagger: DELETE /api/trashes/{hash}
+     */
+    deletePermanently(hash: string, force?: boolean, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Permanently empties all files and folders from the trash.
+     * Swagger: DELETE /api/trashes
+     */
+    emptyTrash(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Sets auto clean-up period for trash in days.
+     * Swagger: POST /api/trashes/periods/{period}
+     */
+    setAutoCleanUpPeriod(period: number | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+}
+
+interface PodspaceTagsServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceTagsService {
+    private http;
+    constructor(options: PodspaceTagsServiceOptions);
+    /**
+     * Adds tags to a file or folder.
+     * Swagger: POST /api/tags
+     */
+    addTags(hash: string, tags: string[] | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Deletes tags from a file or folder.
+     * Swagger: DELETE /api/tags
+     */
+    deleteTags(hash: string, tags: string[] | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Retrieves tags of a file or folder.
+     * Swagger: GET /api/tags/entities/{hash}
+     */
+    getEntityTags(hash: string, password?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<string[]>>;
+    /**
+     * Searches for existing tags with autocomplete.
+     * Swagger: GET /api/tags/search/{tagName}
+     */
+    searchTags(tagName: string, params?: {
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<string[]>>;
+    /**
+     * Retrieves list of files/folders that contain a specific tag.
+     * Swagger: GET /api/tags/{tagName}
+     */
+    getEntitiesByTag(tagName: string, params?: {
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity[]>>;
+}
+
+interface PodspaceBookmarksServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceBookmarksService {
+    private http;
+    constructor(options: PodspaceBookmarksServiceOptions);
+    /**
+     * Retrieves list of bookmarked files and folders.
+     * Swagger: GET /api/bookmarks
+     */
+    getBookmarks(params?: {
+        start?: number;
+        size?: number;
+        order?: string;
+        isDesc?: boolean;
+        filterAttribute?: string;
+        filterValue?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity[]>>;
+    /**
+     * Adds a file or folder to bookmarks.
+     * Swagger: POST /api/bookmarks
+     */
+    addBookmark(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Removes a file or folder from bookmarks.
+     * Swagger: DELETE /api/bookmarks
+     */
+    removeBookmark(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+}
+
+interface PodspaceMetadataServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceMetadataService {
+    private http;
+    constructor(options: PodspaceMetadataServiceOptions);
+    /**
+     * Retrieves metadata key-value dictionary for a file.
+     * Swagger: GET /api/files/{hash}/metadata
+     */
+    getMetadata(hash: string, keys?: string[] | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Record<string, any>>>;
+    /**
+     * Adds or updates metadata dictionary for a file.
+     * Swagger: PUT /api/files/{hash}/metadata
+     */
+    setMetadata(hash: string, metadata: Record<string, any>, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Deletes specific metadata keys from a file.
+     * Swagger: DELETE /api/files/{hash}/metadata
+     */
+    deleteMetadata(hash: string, keys: string[] | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Searches metadata across files with specified parent.
+     * Swagger: POST /api/files/metadata/search
+     */
+    searchMetadata(queryBody: Record<string, any>, params?: {
+        parentHash?: string;
+        start?: number;
+        size?: number;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves description of a file or folder.
+     * Swagger: GET /api/files/description
+     */
+    getDescription(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<string>>;
+    /**
+     * Adds or updates description of a file or folder.
+     * Swagger: PUT /api/files/description
+     */
+    setDescription(hash: string, description: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Deletes description of a file or folder.
+     * Swagger: DELETE /api/files/description
+     */
+    deleteDescription(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+}
+
+interface PodspaceUserGroupsServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceUserGroupsService {
+    private http;
+    constructor(options: PodspaceUserGroupsServiceOptions);
+    /**
+     * Creates a new user group for team collaboration.
+     * Swagger: POST /api/usergroups
+     */
+    createUserGroup(params: CreateUserGroupParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<UserGroup>>;
+    /**
+     * Retrieves user group info by hash.
+     * Swagger: GET /api/usergroups/{userGroupHash}
+     */
+    getUserGroup(userGroupHash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<UserGroup>>;
+    /**
+     * Deletes a user group.
+     * Swagger: DELETE /api/usergroups/{userGroupHash}
+     */
+    deleteUserGroup(userGroupHash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Retrieves list of users in a user group.
+     * Swagger: GET /api/usergroups/{userGroupHash}/users
+     */
+    getUserGroupUsers(userGroupHash: string, params?: {
+        start?: number;
+        size?: number;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<PodspaceUser[]>>;
+    /**
+     * Adds a user to the user group.
+     * Swagger: POST /api/usergroups/{userGroupHash}/users
+     */
+    addUserToGroup(userGroupHash: string, identity: string | number, identityType?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Removes a user from the user group.
+     * Swagger: DELETE /api/usergroups/{userGroupHash}/users
+     */
+    removeUserFromGroup(userGroupHash: string, identity: string | number, identityType?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Retrieves list of files belonging to user group.
+     * Swagger: GET /api/usergroups/{usergroupHash}/files
+     */
+    getUserGroupFiles(userGroupHash: string, params?: {
+        start?: number;
+        size?: number;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile[]>>;
+    /**
+     * Uploads a file directly into a user group.
+     * Swagger: POST /api/usergroups/{userGroupHash}/files
+     */
+    uploadToUserGroup(userGroupHash: string, formData: FormData, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Uploads an image directly into a user group.
+     * Swagger: POST /api/usergroups/{userGroupHash}/images
+     */
+    uploadImageToUserGroup(userGroupHash: string, formData: FormData, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Retrieves storage usage report for a user group.
+     * Swagger: GET /api/usergroups/{userGroupHash}/usage
+     */
+    getUserGroupUsage(userGroupHash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+}
+
+interface PodspaceWorkspacesServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceWorkspacesService {
+    private http;
+    constructor(options: PodspaceWorkspacesServiceOptions);
+    /**
+     * Creates a new collaborative Workspace.
+     * Swagger: POST /api/workspaces
+     */
+    createWorkspace(params: CreateWorkspaceParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Workspace>>;
+    /**
+     * Retrieves workspace details by its identity/username.
+     * Swagger: GET /api/workspaces/{identity}
+     */
+    getWorkspace(identity: string | number, identityType?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Workspace>>;
+    /**
+     * Updates workspace information.
+     * Swagger: PATCH /api/workspaces/{identity}
+     */
+    updateWorkspace(identity: string | number, params?: UpdateWorkspaceParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<Workspace>>;
+    /**
+     * Retrieves members list of a workspace.
+     * Swagger: GET /api/workspaces/{identity}/members
+     */
+    getWorkspaceMembers(identity: string | number, identityType?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<WorkspaceMember[]>>;
+    /**
+     * Adds or updates a member's access level in a workspace.
+     * Swagger: PUT /api/workspaces/{identity}/members/{userIdentity}
+     */
+    updateWorkspaceMember(identity: string | number, userIdentity: string | number, accessLevel: AccessLevel, params?: {
+        identityType?: string;
+        userIdentityType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<WorkspaceMember>>;
+    /**
+     * Removes a member from a workspace.
+     * Swagger: DELETE /api/workspaces/{identity}/members/{userIdentity}
+     */
+    removeWorkspaceMember(identity: string | number, userIdentity: string | number, params?: {
+        identityType?: string;
+        userIdentityType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+}
+
+interface PodspaceMeServiceOptions {
+    http: NextHttp;
+}
+declare class PodspaceMeService {
+    private http;
+    constructor(options: PodspaceMeServiceOptions);
+    /**
+     * Retrieves profile information of current authenticated user.
+     * Swagger: GET /api/me
+     */
+    getUser(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<PodspaceUser>>;
+    /**
+     * Retrieves workspaces accessible to the user.
+     * Swagger: GET /api/me/workspaces
+     */
+    getUserWorkspaces(params?: {
+        start?: number;
+        size?: number;
+        isDesc?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any[]>>;
+    /**
+     * Retrieves user account status on PodSpace.
+     * Swagger: GET /api/me/status
+     */
+    getUserStatus(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves user OAuth scopes.
+     * Swagger: GET /api/me/scope
+     */
+    getUserScope(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<string[]>>;
+    /**
+     * Retrieves storage usage report for current user.
+     * Swagger: GET /api/me/reports/usage
+     */
+    getUserUsageReport(majorType?: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<UserUsageReport>>;
+    /**
+     * Retrieves user storage plans and quota limits.
+     * Swagger: GET /api/me/plans
+     */
+    getUserPlans(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<UserPlan[]>>;
+    /**
+     * Retrieves or creates the user's personal root folder.
+     * Swagger: GET /api/me/folder
+     */
+    getPersonalFolder(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder>>;
+    /**
+     * Retrieves or creates the user's dedicated chat attachments folder.
+     * Swagger: GET /api/me/folders/chat
+     */
+    getOrCreateChatFolder(options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder>>;
+    /**
+     * Retrieves the user's avatar image binary or URL.
+     * Swagger: GET /api/me/avatar
+     */
+    getUserAvatar(options?: PodspaceRequestOptions): Promise<Blob>;
 }
 
 interface PodspaceServiceOptions {
     baseUrl: string;
     apiToken: string;
+    revalidate?: number | string;
+    http?: NextHttp;
 }
+/**
+ * Unified, enterprise PodSpace Cloud Storage Service client.
+ * Implements official PodSpace Swagger API (public-apis v4.13.1).
+ */
 declare class PodspaceService {
     private http;
     private apiToken;
     private baseUrl;
+    private revalidate;
+    /** Upload & Download sub-service */
+    readonly uploadDownload: PodspaceUploadDownloadService;
+    /** Files management sub-service */
+    readonly files: PodspaceFilesService;
+    /** Folders management sub-service */
+    readonly folders: PodspaceFoldersService;
+    /** Resumable upload sub-service */
+    readonly resumable: PodspaceResumableService;
+    /** Links & Public Access sub-service */
+    readonly links: PodspaceLinksService;
+    /** Shares & Permissions sub-service */
+    readonly shares: PodspaceSharesService;
+    /** Trash & Permanent Delete sub-service */
+    readonly trash: PodspaceTrashService;
+    /** Tags sub-service */
+    readonly tags: PodspaceTagsService;
+    /** Bookmarks sub-service */
+    readonly bookmarks: PodspaceBookmarksService;
+    /** Metadata & Descriptions sub-service */
+    readonly metadata: PodspaceMetadataService;
+    /** Team User Groups sub-service */
+    readonly userGroups: PodspaceUserGroupsService;
+    /** Workspaces sub-service */
+    readonly workspaces: PodspaceWorkspacesService;
+    /** User Account & Quota sub-service */
+    readonly me: PodspaceMeService;
     constructor(options: PodspaceServiceOptions);
     /**
-     * Uploads a file (via FormData) to the POD Podspace storage.
+     * Uploads a single file (via FormData) to POD Podspace storage.
+     * Maintains 100% backward compatibility with `uploadFile(formData, path, isPublic)`.
+     * Swagger: POST /api/files
+     */
+    uploadFile(formData: FormData, paramsOrPath?: string | UploadFileParams, isPublic?: boolean, options?: PodspaceRequestOptions): Promise<PodspaceUploadResponse>;
+    /**
+     * Uploads multiple files simultaneously.
+     * Swagger: POST /api/files/multiple
+     */
+    uploadMultipleFiles(formData: FormData, params?: UploadMultipleFilesParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile[]>>;
+    /**
+     * Uploads an image from a base64 string.
+     * Swagger: POST /api/images/base64
+     */
+    uploadImageBase64(params: UploadImageBase64Params, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Replaces the content of an existing file.
+     * Swagger: PUT /api/files/{hash}
+     */
+    replaceFile(hash: string, formData: FormData, params?: ReplaceFileParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Downloads raw file data.
+     * Swagger: GET /api/files/{hash}
+     */
+    downloadFile(hash: string, params?: DownloadFileParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Downloads processed image (with resize, crop, format options).
+     * Swagger: GET /api/v2/images/{hash}
      */
-    uploadFile(formData: FormData, path?: string, isPublic?: boolean): Promise<PodspaceUploadResponse>;
+    downloadImage(hash: string, params?: DownloadImageParams, options?: PodspaceRequestOptions): Promise<Blob>;
     /**
-     * Builds the public or private URL to download/view a file.
+     * Downloads file thumbnail.
+     * Swagger: GET /api/files/{hash}/thumbnail
+     */
+    downloadThumbnail(hash: string, params?: DownloadThumbnailParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Downloads multiple files and folders compressed into a zip file.
+     * Swagger: GET /api/files
+     */
+    downloadFilesAsZip(params: DownloadZipParams, options?: PodspaceRequestOptions): Promise<Blob>;
+    /**
+     * Obtains a pre-signed upload link.
+     * Swagger: GET /api/files/link
+     */
+    getUploadLink(params: GetUploadLinkParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<{
+        link: string;
+        hash?: string;
+    }>>;
+    /**
+     * Builds direct view or download URL for a file.
      */
     getFileUrl(hash: string, isPublic?: boolean): string;
+    /**
+     * Builds direct view URL for an image with crop/dimensions.
+     */
+    getImageUrl(hash: string, params?: DownloadImageParams): string;
+    /**
+     * Builds thumbnail URL for a file.
+     */
+    getThumbnailUrl(hash: string, params?: DownloadThumbnailParams): string;
+    /**
+     * Creates a new folder.
+     * Swagger: POST /api/folders
+     */
+    createFolder(params: CreateFolderParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder>>;
+    /**
+     * Creates nested directories in a parent folder.
+     * Swagger: POST /api/folders/{hash}/directories
+     */
+    createDirectories(hash: string, directories: string[] | string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFolder[]>>;
+    /**
+     * Retrieves subfolders and files inside a folder.
+     * Swagger: GET /api/folders/{hash}/children
+     */
+    getFolderChildren(hash: string, params?: GetFolderChildrenParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves details of a file or folder.
+     * Swagger: GET /api/files/{hash}/detail
+     */
+    getFileDetail(hash: string, params?: {
+        password?: string;
+        breadcrumb?: boolean;
+        shareHash?: string;
+        nativeMetadata?: boolean;
+        includeSizeAndCount?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Retrieves file details using its storage path.
+     * Swagger: GET /api/files/details
+     */
+    getFileDetailByPath(path: string, params?: {
+        parentHash?: string;
+        password?: string;
+        entityType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile>>;
+    /**
+     * Checks if a file or folder exists.
+     * Swagger: GET /api/files/{hash}/exist
+     */
+    checkEntityExist(hash: string, fileName: string, params?: {
+        uniqueName?: boolean;
+        type?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Renames a file or folder.
+     * Swagger: PUT /api/files/{hash}/rename
+     */
+    renameEntity(hash: string, newName: string, uniqueName?: boolean, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Moves a file or folder.
+     * Swagger: PUT /api/files/{hash}/move
+     */
+    moveEntity(hash: string, destFolderHash: string, params?: {
+        policy?: string;
+        uniqueName?: boolean;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Copies a file or folder.
+     * Swagger: PUT /api/files/{hash}/copy
+     */
+    copyEntity(hash: string, destFolderHash: string, params?: {
+        policy?: string;
+        uniqueName?: boolean;
+        copyType?: string;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity>>;
+    /**
+     * Moves a file or folder to trash.
+     * Swagger: DELETE /api/files/{hash}
+     */
+    trashEntity(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Alias for `trashEntity`.
+     */
+    deleteFile(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Searches files content and folders.
+     * Swagger: GET /api/files/search
+     */
+    searchFiles(params?: SearchFilesParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves recent files.
+     * Swagger: GET /api/v2/files/recent
+     */
+    getRecentFiles(params?: {
+        start?: number;
+        size?: number;
+    }, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceFile[]>>;
+    /**
+     * Creates a download or integration public link for a file.
+     * Swagger: GET /api/links/files/{hash}
+     */
+    createLink(hash: string, params?: Record<string, any>, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Shares a file or folder with another user.
+     * Swagger: POST /api/files/{hash}/shares/users/{identity}
+     */
+    shareWithUser(hash: string, identity: string | number, params: ShareEntityParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Makes a file or folder publicly accessible.
+     * Swagger: POST /api/files/{hash}/public
+     */
+    makePublic(hash: string, params: MakePublicParams, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<any>>;
+    /**
+     * Retrieves bookmarked entities.
+     * Swagger: GET /api/bookmarks
+     */
+    getBookmarks(params?: Record<string, any>, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<SpaceEntity[]>>;
+    /**
+     * Bookmarks a file or folder.
+     * Swagger: POST /api/bookmarks
+     */
+    addBookmark(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
+    /**
+     * Removes bookmark from a file or folder.
+     * Swagger: DELETE /api/bookmarks
+     */
+    removeBookmark(hash: string, options?: PodspaceRequestOptions): Promise<PodspaceRestResponse<boolean>>;
 }
 
 interface PodFormItem {
@@ -434,7 +1840,7 @@ interface SendSmsResponse {
 }
 
 interface NotificationServiceOptions {
-    baseUrl: string;
+    baseUrl?: string;
     apiToken: string;
 }
 declare class NotificationService {
@@ -1649,12 +3055,13 @@ interface IumsResponse<T = any> {
 }
 
 interface IumsServiceOptions {
-    baseUrl: string;
+    baseUrl?: string;
     clientId: string;
     revalidate?: number | string;
 }
 declare class IumsService {
     private http;
+    private baseUrl;
     private clientId;
     private revalidate;
     constructor(options: IumsServiceOptions);
@@ -1679,7 +3086,8 @@ declare class PodSdk {
     readonly product: CmsProductService;
     readonly tags: CmsTagService;
     readonly iums: IumsService;
-    constructor(config: PodSdkConfig);
+    readonly urls: Required<PodUrlsConfig>;
+    constructor(config?: PodSdkConfig);
     /**
      * Helper shortcut to instantiate a Generic CRUD repository for any entity type on POD CustomPost.
      */
@@ -1690,6 +3098,38 @@ declare class PodSdk {
  */
 declare function createPodSdk(config: PodSdkConfig): PodSdk;
 
+/**
+ * Official POD Platform Production URLs.
+ */
+declare const DEFAULT_POD_URLS: Required<PodUrlsConfig>;
+/**
+ * Official POD Platform Sandbox URLs for development and testing.
+ */
+declare const SANDBOX_POD_URLS: Required<PodUrlsConfig>;
+/**
+ * Resolves full POD URL configuration with the following priority:
+ * 1. Explicit user overrides in `config.urls`
+ * 2. Next.js / Node environment variables (`process.env.NEXT_PUBLIC_*`)
+ * 3. Default production / sandbox URLs
+ *
+ * Supported Environment Variables:
+ * - `NEXT_PUBLIC_ACCOUNTS_URL`
+ * - `NEXT_PUBLIC_API_POD_URL`
+ * - `NEXT_PUBLIC_API_POD_SANDBOX_URL`
+ * - `NEXT_PUBLIC_CMS_URL`
+ * - `NEXT_PUBLIC_IUMS_URL`
+ * - `NEXT_PUBLIC_NOTIFICATION_URL`
+ * - `NEXT_PUBLIC_PODREPORT_URL`
+ * - `NEXT_PUBLIC_PODSPACE_URL`
+ * - `NEXT_PUBLIC_SANDBOX_CMS_URL`
+ * - `NEXT_PUBLIC_SANDBOX_CMS_CLIENT_URL`
+ * - `NEXT_PUBLIC_SANDBOX_PODSPACE_URL`
+ * - `NEXT_PUBLIC_SANDBOX_STREAM_URL`
+ * - `NEXT_PUBLIC_PODFORM_URL`
+ * - `NEXT_PUBLIC_WEBSITE_URL`
+ */
+declare function resolvePodUrls(urls?: PodUrlsConfig, sandbox?: boolean): Required<PodUrlsConfig>;
+
 /**
  * Cryptographic and encoding utilities for POD Platform services.
  * Uses standard Web Crypto API (supported natively in Node.js 18+, Browsers, and Edge).
@@ -1697,4 +3137,4 @@ declare function createPodSdk(config: PodSdkConfig): PodSdk;
 declare function encodeBase64(str: string): string;
 declare function generatePodSignatureHeader(keyId: string, privateKeyPem?: string): Promise<string>;
 
-export { type AddCommentParams, type AddContentParams, type AddCustomPostParams, type AddCustomPostResponse, type AddProductParams, type ArchiveParams, type ArchiveProductParams, type BatchPublishParams, type BatchPublishProductParams, type BatchUnpublishParams, type BatchUnpublishProductParams, type Business, CmsDataFormatter, type CmsMetadata, CmsProductService, type CmsProductServiceOptions, type CmsRequestOptions, CmsService, type CmsServiceOptions, CmsTagService, type CmsTagServiceOptions, type CommentItem, type ContentBody, type CreateTagCategoryParams, type CreateTagTreeItemParams, type CustomPostCrudConfig, CustomPostCrudService, type CustomPostItem, CustomPostService, type CustomPostServiceOptions, type EditContentParams, type EditProductParams, type FormattedGetContentResponse, type FormattedGetProductResponse, type FormattedProductSubject, type FormattedSubject, type GetCategoriesParams, type GetCategoryResponse, type GetCommentListParams, type GetCommentsParams, type GetContentByEntityIdParams, type GetContentParams, type GetContentResponse, type GetCustomPostParams, type GetCustomPostResponse, type GetInfOfGraduatedByGraduateDateResponse, type GetProductByEntityIdParams, type GetProductParams, type GetProductResponse, type GetReactionsParams, type GetSessionClassInCurrentDayResponse, type GetTagCategoriesResponse, type GetTagTreeParams, type GetTagTreeResponse, type HandshakeResponse, type IumsResponse, IumsService, type IumsServiceOptions, type LikeCommentParams, type LikePostParams, type MetaContent, type Metadata, NotificationService, type NotificationServiceOptions, type PodFormItem, type PodFormResponse, PodFormService, type PodFormServiceOptions, type PodResponse, PodSdk, type PodSdkConfig, type PodUrlsConfig, PodspaceService, type PodspaceServiceOptions, type PodspaceUploadResponse, type PodspaceUploadResult, type ProductBody, type ProductItem, type ProductItemWithFormatted, type Rate, type ResultItem, type ResultItemWithFormatted, type SearchTimelineByMetadataParam, type SearchTimelineParamMetaQuery, type SearchTimelineResponse, type SearchTimelineResultItem, type SendOtpOptions, type SendSmsParams, type SendSmsResponse, type SeoType, type SocialResponse, SocialService, type SocialServiceOptions, SsoService, type SsoServiceOptions, type SsoUserProfile, type Subject, type TagCategoryItem, type TagCategoryListParams, type TagTreeAncestorsParams, type TagTreeMetadata, type TagtreesType, type TimelineResponse, type TimelineSearchBody, type TokenResponse, type UpdateCustomPostParams, type UpdateTagCategoryParams, type UpdateTagTreeItemParams, type UserPostInfo, type VerifyResponse, createPodSdk, PodSdk as default, encodeBase64, generatePodSignatureHeader };
+export { type AccessLevel, type AddCommentParams, type AddContentParams, type AddCustomPostParams, type AddCustomPostResponse, type AddProductParams, type ApiPageLink, type ApiPageList, type ApiSimplePageList, type ArchiveParams, type ArchiveProductParams, type BatchPublishParams, type BatchPublishProductParams, type BatchUnpublishParams, type BatchUnpublishProductParams, type Business, type CachePolicy, CmsDataFormatter, type CmsMetadata, CmsProductService, type CmsProductServiceOptions, type CmsRequestOptions, CmsService, type CmsServiceOptions, CmsTagService, type CmsTagServiceOptions, type CommentItem, type ContentBody, type CreateFolderParams, type CreateLinkParams, type CreateTagCategoryParams, type CreateTagTreeItemParams, type CreateUserGroupParams, type CreateWorkspaceParams, type CustomPostCrudConfig, CustomPostCrudService, type CustomPostItem, CustomPostService, type CustomPostServiceOptions, DEFAULT_POD_URLS, type DownloadFileParams, type DownloadImageParams, type DownloadThumbnailParams, type DownloadZipParams, type EditContentParams, type EditProductParams, type FileVersion, type FinalizeResumableParams, type FormattedGetContentResponse, type FormattedGetProductResponse, type FormattedProductSubject, type FormattedSubject, type GetBookmarksParams, type GetCategoriesParams, type GetCategoryResponse, type GetCommentListParams, type GetCommentsParams, type GetContentByEntityIdParams, type GetContentParams, type GetContentResponse, type GetCustomPostParams, type GetCustomPostResponse, type GetFolderChildrenParams, type GetInfOfGraduatedByGraduateDateResponse, type GetProductByEntityIdParams, type GetProductParams, type GetProductResponse, type GetReactionsParams, type GetSessionClassInCurrentDayResponse, type GetTagCategoriesResponse, type GetTagTreeParams, type GetTagTreeResponse, type GetUploadLinkParams, type HandshakeResponse, type IumsResponse, IumsService, type IumsServiceOptions, type LikeCommentParams, type LikePostParams, type MakePublicParams, type MetaContent, type Metadata, NotificationService, type NotificationServiceOptions, type PaginationParams, type PodFormItem, type PodFormResponse, PodFormService, type PodFormServiceOptions, type PodResponse, PodSdk, type PodSdkConfig, type PodUrlsConfig, PodspaceBookmarksService, type PodspaceBookmarksServiceOptions, PodspaceFilesService, type PodspaceFilesServiceOptions, PodspaceFoldersService, type PodspaceFoldersServiceOptions, PodspaceLinksService, type PodspaceLinksServiceOptions, PodspaceMeService, type PodspaceMeServiceOptions, PodspaceMetadataService, type PodspaceMetadataServiceOptions, type PodspaceRequestOptions, type PodspaceRestResponse, PodspaceResumableService, type PodspaceResumableServiceOptions, PodspaceService, type PodspaceServiceOptions, PodspaceSharesService, type PodspaceSharesServiceOptions, PodspaceTagsService, type PodspaceTagsServiceOptions, PodspaceTrashService, type PodspaceTrashServiceOptions, PodspaceUploadDownloadService, type PodspaceUploadDownloadServiceOptions, type PodspaceUploadResponse, type PodspaceUploadResult, type PodspaceUser, PodspaceUserGroupsService, type PodspaceUserGroupsServiceOptions, PodspaceWorkspacesService, type PodspaceWorkspacesServiceOptions, type ProductBody, type ProductItem, type ProductItemWithFormatted, type Rate, type ReplaceFileParams, type ResultItem, type ResultItemWithFormatted, SANDBOX_POD_URLS, type SearchFilesParams, type SearchTimelineByMetadataParam, type SearchTimelineParamMetaQuery, type SearchTimelineResponse, type SearchTimelineResultItem, type SendOtpOptions, type SendSmsParams, type SendSmsResponse, type SeoType, type Share, type ShareAccess, type ShareEntityParams, type ShareType, type SocialResponse, SocialService, type SocialServiceOptions, type SpaceEntity, type SpaceFile, type SpaceFolder, SsoService, type SsoServiceOptions, type SsoUserProfile, type Subject, type TagCategoryItem, type TagCategoryListParams, type TagTreeAncestorsParams, type TagTreeMetadata, type TagtreesType, type ThumbnailStatus, type TimelineResponse, type TimelineSearchBody, type TokenResponse, type UpdateCustomPostParams, type UpdateLinkParams, type UpdateTagCategoryParams, type UpdateTagTreeItemParams, type UpdateWorkspaceParams, type UploadFileParams, type UploadImageBase64Params, type UploadMultipleFilesParams, type UserGroup, type UserPlan, type UserPostInfo, type UserUsageReport, type VerifyResponse, type Workspace, type WorkspaceMember, createPodSdk, PodSdk as default, encodeBase64, generatePodSignatureHeader, resolvePodUrls };